bfd.info revision 1.1.1.6
1This is bfd.info, produced by makeinfo version 6.3 from bfd.texinfo.
2
3This file documents the BFD library.
4
5   Copyright (C) 1991-2018 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, IEEE, Oasys) and the type is simple enough to fit
262     within one word (nearly everything but aggregates), the information
263     will 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     (COFF, IEEE and Oasys).
291
292
293File: bfd.info,  Node: BFD front end,  Next: BFD back ends,  Prev: Overview,  Up: Top
294
2952 BFD Front End
296***************
297
298* Menu:
299
300* typedef bfd::
301* Error reporting::
302* Miscellaneous::
303* Memory Usage::
304* Initialization::
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
333     enum bfd_direction
334       {
335         no_direction = 0,
336         read_direction = 1,
337         write_direction = 2,
338         both_direction = 3
339       };
340
341     enum bfd_plugin_format
342       {
343         bfd_plugin_unknown = 0,
344         bfd_plugin_yes = 1,
345         bfd_plugin_no = 2
346       };
347
348     struct bfd_build_id
349       {
350         bfd_size_type size;
351         bfd_byte data[1];
352       };
353
354     struct bfd
355     {
356       /* The filename the application opened the BFD with.  */
357       const char *filename;
358
359       /* A pointer to the target jump table.  */
360       const struct bfd_target *xvec;
361
362       /* The IOSTREAM, and corresponding IO vector that provide access
363          to the file backing the BFD.  */
364       void *iostream;
365       const struct bfd_iovec *iovec;
366
367       /* The caching routines use these to maintain a
368          least-recently-used list of BFDs.  */
369       struct bfd *lru_prev, *lru_next;
370
371       /* When a file is closed by the caching routines, BFD retains
372          state information on the file here...  */
373       ufile_ptr where;
374
375       /* File modified time, if mtime_set is TRUE.  */
376       long mtime;
377
378       /* A unique identifier of the BFD  */
379       unsigned int id;
380
381       /* The format which belongs to the BFD. (object, core, etc.)  */
382       ENUM_BITFIELD (bfd_format) format : 3;
383
384       /* The direction with which the BFD was opened.  */
385       ENUM_BITFIELD (bfd_direction) direction : 2;
386
387       /* Format_specific flags.  */
388       flagword flags : 20;
389
390       /* Values that may appear in the flags field of a BFD.  These also
391          appear in the object_flags field of the bfd_target structure, where
392          they indicate the set of flags used by that backend (not all flags
393          are meaningful for all object file formats) (FIXME: at the moment,
394          the object_flags values have mostly just been copied from backend
395          to another, and are not necessarily correct).  */
396
397     #define BFD_NO_FLAGS                0x0
398
399       /* BFD contains relocation entries.  */
400     #define HAS_RELOC                   0x1
401
402       /* BFD is directly executable.  */
403     #define EXEC_P                      0x2
404
405       /* BFD has line number information (basically used for F_LNNO in a
406          COFF header).  */
407     #define HAS_LINENO                  0x4
408
409       /* BFD has debugging information.  */
410     #define HAS_DEBUG                  0x08
411
412       /* BFD has symbols.  */
413     #define HAS_SYMS                   0x10
414
415       /* BFD has local symbols (basically used for F_LSYMS in a COFF
416          header).  */
417     #define HAS_LOCALS                 0x20
418
419       /* BFD is a dynamic object.  */
420     #define DYNAMIC                    0x40
421
422       /* Text section is write protected (if D_PAGED is not set, this is
423          like an a.out NMAGIC file) (the linker sets this by default, but
424          clears it for -r or -N).  */
425     #define WP_TEXT                    0x80
426
427       /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
428          linker sets this by default, but clears it for -r or -n or -N).  */
429     #define D_PAGED                   0x100
430
431       /* BFD is relaxable (this means that bfd_relax_section may be able to
432          do something) (sometimes bfd_relax_section can do something even if
433          this is not set).  */
434     #define BFD_IS_RELAXABLE          0x200
435
436       /* This may be set before writing out a BFD to request using a
437          traditional format.  For example, this is used to request that when
438          writing out an a.out object the symbols not be hashed to eliminate
439          duplicates.  */
440     #define BFD_TRADITIONAL_FORMAT    0x400
441
442       /* This flag indicates that the BFD contents are actually cached
443          in memory.  If this is set, iostream points to a bfd_in_memory
444          struct.  */
445     #define BFD_IN_MEMORY             0x800
446
447       /* This BFD has been created by the linker and doesn't correspond
448          to any input file.  */
449     #define BFD_LINKER_CREATED       0x1000
450
451       /* This may be set before writing out a BFD to request that it
452          be written using values for UIDs, GIDs, timestamps, etc. that
453          will be consistent from run to run.  */
454     #define BFD_DETERMINISTIC_OUTPUT 0x2000
455
456       /* Compress sections in this BFD.  */
457     #define BFD_COMPRESS             0x4000
458
459       /* Decompress sections in this BFD.  */
460     #define BFD_DECOMPRESS           0x8000
461
462       /* BFD is a dummy, for plugins.  */
463     #define BFD_PLUGIN              0x10000
464
465       /* Compress sections in this BFD with SHF_COMPRESSED from gABI.  */
466     #define BFD_COMPRESS_GABI       0x20000
467
468       /* Convert ELF common symbol type to STT_COMMON or STT_OBJECT in this
469          BFD.  */
470     #define BFD_CONVERT_ELF_COMMON  0x40000
471
472       /* Use the ELF STT_COMMON type in this BFD.  */
473     #define BFD_USE_ELF_STT_COMMON  0x80000
474
475       /* Flags bits to be saved in bfd_preserve_save.  */
476     #define BFD_FLAGS_SAVED \
477       (BFD_IN_MEMORY | BFD_COMPRESS | BFD_DECOMPRESS | BFD_LINKER_CREATED \
478        | BFD_PLUGIN | BFD_COMPRESS_GABI | BFD_CONVERT_ELF_COMMON \
479        | BFD_USE_ELF_STT_COMMON)
480
481       /* Flags bits which are for BFD use only.  */
482     #define BFD_FLAGS_FOR_BFD_USE_MASK \
483       (BFD_IN_MEMORY | BFD_COMPRESS | BFD_DECOMPRESS | BFD_LINKER_CREATED \
484        | BFD_PLUGIN | BFD_TRADITIONAL_FORMAT | BFD_DETERMINISTIC_OUTPUT \
485        | BFD_COMPRESS_GABI | BFD_CONVERT_ELF_COMMON | BFD_USE_ELF_STT_COMMON)
486
487       /* Is the file descriptor being cached?  That is, can it be closed as
488          needed, and re-opened when accessed later?  */
489       unsigned int cacheable : 1;
490
491       /* Marks whether there was a default target specified when the
492          BFD was opened. This is used to select which matching algorithm
493          to use to choose the back end.  */
494       unsigned int target_defaulted : 1;
495
496       /* ... and here: (``once'' means at least once).  */
497       unsigned int opened_once : 1;
498
499       /* Set if we have a locally maintained mtime value, rather than
500          getting it from the file each time.  */
501       unsigned int mtime_set : 1;
502
503       /* Flag set if symbols from this BFD should not be exported.  */
504       unsigned int no_export : 1;
505
506       /* Remember when output has begun, to stop strange things
507          from happening.  */
508       unsigned int output_has_begun : 1;
509
510       /* Have archive map.  */
511       unsigned int has_armap : 1;
512
513       /* Set if this is a thin archive.  */
514       unsigned int is_thin_archive : 1;
515
516       /* Set if only required symbols should be added in the link hash table for
517          this object.  Used by VMS linkers.  */
518       unsigned int selective_search : 1;
519
520       /* Set if this is the linker output BFD.  */
521       unsigned int is_linker_output : 1;
522
523       /* Set if this is the linker input BFD.  */
524       unsigned int is_linker_input : 1;
525
526       /* If this is an input for a compiler plug-in library.  */
527       ENUM_BITFIELD (bfd_plugin_format) plugin_format : 2;
528
529       /* Set if this is a plugin output file.  */
530       unsigned int lto_output : 1;
531
532       /* Set to dummy BFD created when claimed by a compiler plug-in
533          library.  */
534       bfd *plugin_dummy_bfd;
535
536       /* Currently my_archive is tested before adding origin to
537          anything. I believe that this can become always an add of
538          origin, with origin set to 0 for non archive files.  */
539       ufile_ptr origin;
540
541       /* The origin in the archive of the proxy entry.  This will
542          normally be the same as origin, except for thin archives,
543          when it will contain the current offset of the proxy in the
544          thin archive rather than the offset of the bfd in its actual
545          container.  */
546       ufile_ptr proxy_origin;
547
548       /* A hash table for section names.  */
549       struct bfd_hash_table section_htab;
550
551       /* Pointer to linked list of sections.  */
552       struct bfd_section *sections;
553
554       /* The last section on the section list.  */
555       struct bfd_section *section_last;
556
557       /* The number of sections.  */
558       unsigned int section_count;
559
560       /* A field used by _bfd_generic_link_add_archive_symbols.  This will
561          be used only for archive elements.  */
562       int archive_pass;
563
564       /* Stuff only useful for object files:
565          The start address.  */
566       bfd_vma start_address;
567
568       /* Symbol table for output BFD (with symcount entries).
569          Also used by the linker to cache input BFD symbols.  */
570       struct bfd_symbol  **outsymbols;
571
572       /* Used for input and output.  */
573       unsigned int symcount;
574
575       /* Used for slurped dynamic symbol tables.  */
576       unsigned int dynsymcount;
577
578       /* Pointer to structure which contains architecture information.  */
579       const struct bfd_arch_info *arch_info;
580
581       /* Stuff only useful for archives.  */
582       void *arelt_data;
583       struct bfd *my_archive;      /* The containing archive BFD.  */
584       struct bfd *archive_next;    /* The next BFD in the archive.  */
585       struct bfd *archive_head;    /* The first BFD in the archive.  */
586       struct bfd *nested_archives; /* List of nested archive in a flattened
587                                       thin archive.  */
588
589       union {
590         /* For input BFDs, a chain of BFDs involved in a link.  */
591         struct bfd *next;
592         /* For output BFD, the linker hash table.  */
593         struct bfd_link_hash_table *hash;
594       } link;
595
596       /* Used by the back end to hold private data.  */
597       union
598         {
599           struct aout_data_struct *aout_data;
600           struct artdata *aout_ar_data;
601           struct _oasys_data *oasys_obj_data;
602           struct _oasys_ar_data *oasys_ar_data;
603           struct coff_tdata *coff_obj_data;
604           struct pe_tdata *pe_obj_data;
605           struct xcoff_tdata *xcoff_obj_data;
606           struct ecoff_tdata *ecoff_obj_data;
607           struct ieee_data_struct *ieee_data;
608           struct ieee_ar_data_struct *ieee_ar_data;
609           struct srec_data_struct *srec_data;
610           struct verilog_data_struct *verilog_data;
611           struct ihex_data_struct *ihex_data;
612           struct tekhex_data_struct *tekhex_data;
613           struct elf_obj_tdata *elf_obj_data;
614           struct nlm_obj_tdata *nlm_obj_data;
615           struct bout_data_struct *bout_data;
616           struct mmo_data_struct *mmo_data;
617           struct sun_core_struct *sun_core_data;
618           struct sco5_core_struct *sco5_core_data;
619           struct trad_core_struct *trad_core_data;
620           struct som_data_struct *som_data;
621           struct hpux_core_struct *hpux_core_data;
622           struct hppabsd_core_struct *hppabsd_core_data;
623           struct sgi_core_struct *sgi_core_data;
624           struct lynx_core_struct *lynx_core_data;
625           struct osf_core_struct *osf_core_data;
626           struct cisco_core_struct *cisco_core_data;
627           struct versados_data_struct *versados_data;
628           struct netbsd_core_struct *netbsd_core_data;
629           struct mach_o_data_struct *mach_o_data;
630           struct mach_o_fat_data_struct *mach_o_fat_data;
631           struct plugin_data_struct *plugin_data;
632           struct bfd_pef_data_struct *pef_data;
633           struct bfd_pef_xlib_data_struct *pef_xlib_data;
634           struct bfd_sym_data_struct *sym_data;
635           void *any;
636         }
637       tdata;
638
639       /* Used by the application to hold private data.  */
640       void *usrdata;
641
642       /* Where all the allocated stuff under this BFD goes.  This is a
643          struct objalloc *, but we use void * to avoid requiring the inclusion
644          of objalloc.h.  */
645       void *memory;
646
647       /* For input BFDs, the build ID, if the object has one. */
648       const struct bfd_build_id *build_id;
649     };
650
651     /* See note beside bfd_set_section_userdata.  */
652     static inline bfd_boolean
653     bfd_set_cacheable (bfd * abfd, bfd_boolean val)
654     {
655       abfd->cacheable = val;
656       return TRUE;
657     }
658
659
660
661File: bfd.info,  Node: Error reporting,  Next: Miscellaneous,  Prev: typedef bfd,  Up: BFD front end
662
6632.2 Error reporting
664===================
665
666Most BFD functions return nonzero on success (check their individual
667documentation for precise semantics).  On an error, they call
668'bfd_set_error' to set an error condition that callers can check by
669calling 'bfd_get_error'.  If that returns 'bfd_error_system_call', then
670check 'errno'.
671
672   The easiest way to report a BFD error to the user is to use
673'bfd_perror'.
674
6752.2.1 Type 'bfd_error_type'
676---------------------------
677
678The values returned by 'bfd_get_error' are defined by the enumerated
679type 'bfd_error_type'.
680
681
682     typedef enum bfd_error
683     {
684       bfd_error_no_error = 0,
685       bfd_error_system_call,
686       bfd_error_invalid_target,
687       bfd_error_wrong_format,
688       bfd_error_wrong_object_format,
689       bfd_error_invalid_operation,
690       bfd_error_no_memory,
691       bfd_error_no_symbols,
692       bfd_error_no_armap,
693       bfd_error_no_more_archived_files,
694       bfd_error_malformed_archive,
695       bfd_error_missing_dso,
696       bfd_error_file_not_recognized,
697       bfd_error_file_ambiguously_recognized,
698       bfd_error_no_contents,
699       bfd_error_nonrepresentable_section,
700       bfd_error_no_debug_section,
701       bfd_error_bad_value,
702       bfd_error_file_truncated,
703       bfd_error_file_too_big,
704       bfd_error_on_input,
705       bfd_error_invalid_error_code
706     }
707     bfd_error_type;
708
709
7102.2.1.1 'bfd_get_error'
711.......................
712
713*Synopsis*
714     bfd_error_type bfd_get_error (void);
715   *Description*
716Return the current BFD error condition.
717
7182.2.1.2 'bfd_set_error'
719.......................
720
721*Synopsis*
722     void bfd_set_error (bfd_error_type error_tag);
723   *Description*
724Set the BFD error condition to be ERROR_TAG.
725
726   ERROR_TAG must not be bfd_error_on_input.  Use bfd_set_input_error
727for input errors instead.
728
7292.2.1.3 'bfd_set_input_error'
730.............................
731
732*Synopsis*
733     void bfd_set_input_error (bfd *input, bfd_error_type error_tag);
734   *Description*
735Set the BFD error condition to be bfd_error_on_input.  INPUT is the
736input bfd where the error occurred, and ERROR_TAG the bfd_error_type
737error.
738
7392.2.1.4 'bfd_errmsg'
740....................
741
742*Synopsis*
743     const char *bfd_errmsg (bfd_error_type error_tag);
744   *Description*
745Return a string describing the error ERROR_TAG, or the system error if
746ERROR_TAG is 'bfd_error_system_call'.
747
7482.2.1.5 'bfd_perror'
749....................
750
751*Synopsis*
752     void bfd_perror (const char *message);
753   *Description*
754Print to the standard error stream a string describing the last BFD
755error that occurred, or the last system error if the last BFD error was
756a system call failure.  If MESSAGE is non-NULL and non-empty, the error
757string printed is preceded by MESSAGE, a colon, and a space.  It is
758followed by a newline.
759
7602.2.2 BFD error handler
761-----------------------
762
763Some BFD functions want to print messages describing the problem.  They
764call a BFD error handler function.  This function may be overridden by
765the program.
766
767   The BFD error handler acts like vprintf.
768
769
770     typedef void (*bfd_error_handler_type) (const char *, va_list);
771
772
7732.2.2.1 'bfd_set_error_handler'
774...............................
775
776*Synopsis*
777     bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type);
778   *Description*
779Set the BFD error handler function.  Returns the previous function.
780
7812.2.2.2 'bfd_set_error_program_name'
782....................................
783
784*Synopsis*
785     void bfd_set_error_program_name (const char *);
786   *Description*
787Set the program name to use when printing a BFD error.  This is printed
788before the error message followed by a colon and space.  The string must
789not be changed after it is passed to this function.
790
7912.2.3 BFD assert handler
792------------------------
793
794If BFD finds an internal inconsistency, the bfd assert handler is called
795with information on the BFD version, BFD source file and line.  If this
796happens, most programs linked against BFD are expected to want to exit
797with an error, or mark the current BFD operation as failed, so it is
798recommended to override the default handler, which just calls
799_bfd_error_handler and continues.
800
801
802     typedef void (*bfd_assert_handler_type) (const char *bfd_formatmsg,
803                                              const char *bfd_version,
804                                              const char *bfd_file,
805                                              int bfd_line);
806
807
8082.2.3.1 'bfd_set_assert_handler'
809................................
810
811*Synopsis*
812     bfd_assert_handler_type bfd_set_assert_handler (bfd_assert_handler_type);
813   *Description*
814Set the BFD assert handler function.  Returns the previous function.
815
816
817File: bfd.info,  Node: Miscellaneous,  Next: Memory Usage,  Prev: Error reporting,  Up: BFD front end
818
8192.3 Miscellaneous
820=================
821
8222.3.1 Miscellaneous functions
823-----------------------------
824
8252.3.1.1 'bfd_get_reloc_upper_bound'
826...................................
827
828*Synopsis*
829     long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect);
830   *Description*
831Return the number of bytes required to store the relocation information
832associated with section SECT attached to bfd ABFD.  If an error occurs,
833return -1.
834
8352.3.1.2 'bfd_canonicalize_reloc'
836................................
837
838*Synopsis*
839     long bfd_canonicalize_reloc
840        (bfd *abfd, asection *sec, arelent **loc, asymbol **syms);
841   *Description*
842Call the back end associated with the open BFD ABFD and translate the
843external form of the relocation information attached to SEC into the
844internal canonical form.  Place the table into memory at LOC, which has
845been preallocated, usually by a call to 'bfd_get_reloc_upper_bound'.
846Returns the number of relocs, or -1 on error.
847
848   The SYMS table is also needed for horrible internal magic reasons.
849
8502.3.1.3 'bfd_set_reloc'
851.......................
852
853*Synopsis*
854     void bfd_set_reloc
855        (bfd *abfd, asection *sec, arelent **rel, unsigned int count);
856   *Description*
857Set the relocation pointer and count within section SEC to the values
858REL and COUNT.  The argument ABFD is ignored.
859     #define bfd_set_reloc(abfd, asect, location, count) \
860            BFD_SEND (abfd, _bfd_set_reloc, (abfd, asect, location, count))
861
8622.3.1.4 'bfd_set_file_flags'
863............................
864
865*Synopsis*
866     bfd_boolean bfd_set_file_flags (bfd *abfd, flagword flags);
867   *Description*
868Set the flag word in the BFD ABFD to the value FLAGS.
869
870   Possible errors are:
871
872   * 'bfd_error_wrong_format' - The target bfd was not of object format.
873   * 'bfd_error_invalid_operation' - The target bfd was open for
874     reading.
875   * 'bfd_error_invalid_operation' - The flag word contained a bit which
876     was not applicable to the type of file.  E.g., an attempt was made
877     to set the 'D_PAGED' bit on a BFD format which does not support
878     demand paging.
879
8802.3.1.5 'bfd_get_arch_size'
881...........................
882
883*Synopsis*
884     int bfd_get_arch_size (bfd *abfd);
885   *Description*
886Returns the normalized architecture address size, in bits, as determined
887by the object file's format.  By normalized, we mean either 32 or 64.
888For ELF, this information is included in the header.  Use
889bfd_arch_bits_per_address for number of bits in the architecture
890address.
891
892   *Returns*
893Returns the arch size in bits if known, '-1' otherwise.
894
8952.3.1.6 'bfd_get_sign_extend_vma'
896.................................
897
898*Synopsis*
899     int bfd_get_sign_extend_vma (bfd *abfd);
900   *Description*
901Indicates if the target architecture "naturally" sign extends an
902address.  Some architectures implicitly sign extend address values when
903they are converted to types larger than the size of an address.  For
904instance, bfd_get_start_address() will return an address sign extended
905to fill a bfd_vma when this is the case.
906
907   *Returns*
908Returns '1' if the target architecture is known to sign extend
909addresses, '0' if the target architecture is known to not sign extend
910addresses, and '-1' otherwise.
911
9122.3.1.7 'bfd_set_start_address'
913...............................
914
915*Synopsis*
916     bfd_boolean bfd_set_start_address (bfd *abfd, bfd_vma vma);
917   *Description*
918Make VMA the entry point of output BFD ABFD.
919
920   *Returns*
921Returns 'TRUE' on success, 'FALSE' otherwise.
922
9232.3.1.8 'bfd_get_gp_size'
924.........................
925
926*Synopsis*
927     unsigned int bfd_get_gp_size (bfd *abfd);
928   *Description*
929Return the maximum size of objects to be optimized using the GP register
930under MIPS ECOFF. This is typically set by the '-G' argument to the
931compiler, assembler or linker.
932
9332.3.1.9 'bfd_set_gp_size'
934.........................
935
936*Synopsis*
937     void bfd_set_gp_size (bfd *abfd, unsigned int i);
938   *Description*
939Set the maximum size of objects to be optimized using the GP register
940under ECOFF or MIPS ELF. This is typically set by the '-G' argument to
941the compiler, assembler or linker.
942
9432.3.1.10 'bfd_scan_vma'
944.......................
945
946*Synopsis*
947     bfd_vma bfd_scan_vma (const char *string, const char **end, int base);
948   *Description*
949Convert, like 'strtoul', a numerical expression STRING into a 'bfd_vma'
950integer, and return that integer.  (Though without as many bells and
951whistles as 'strtoul'.)  The expression is assumed to be unsigned (i.e.,
952positive).  If given a BASE, it is used as the base for conversion.  A
953base of 0 causes the function to interpret the string in hex if a
954leading "0x" or "0X" is found, otherwise in octal if a leading zero is
955found, otherwise in decimal.
956
957   If the value would overflow, the maximum 'bfd_vma' value is returned.
958
9592.3.1.11 'bfd_copy_private_header_data'
960.......................................
961
962*Synopsis*
963     bfd_boolean bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
964   *Description*
965Copy private BFD header information from the BFD IBFD to the the BFD
966OBFD.  This copies information that may require sections to exist, but
967does not require symbol tables.  Return 'true' on success, 'false' on
968error.  Possible error returns are:
969
970   * 'bfd_error_no_memory' - Not enough memory exists to create private
971     data for OBFD.
972     #define bfd_copy_private_header_data(ibfd, obfd) \
973            BFD_SEND (obfd, _bfd_copy_private_header_data, \
974                      (ibfd, obfd))
975
9762.3.1.12 'bfd_copy_private_bfd_data'
977....................................
978
979*Synopsis*
980     bfd_boolean bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
981   *Description*
982Copy private BFD information from the BFD IBFD to the the BFD OBFD.
983Return 'TRUE' on success, 'FALSE' on error.  Possible error returns are:
984
985   * 'bfd_error_no_memory' - Not enough memory exists to create private
986     data for OBFD.
987     #define bfd_copy_private_bfd_data(ibfd, obfd) \
988            BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
989                      (ibfd, obfd))
990
9912.3.1.13 'bfd_set_private_flags'
992................................
993
994*Synopsis*
995     bfd_boolean bfd_set_private_flags (bfd *abfd, flagword flags);
996   *Description*
997Set private BFD flag information in the BFD ABFD.  Return 'TRUE' on
998success, 'FALSE' on error.  Possible error returns are:
999
1000   * 'bfd_error_no_memory' - Not enough memory exists to create private
1001     data for OBFD.
1002     #define bfd_set_private_flags(abfd, flags) \
1003            BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
1004
10052.3.1.14 'Other functions'
1006..........................
1007
1008*Description*
1009The following functions exist but have not yet been documented.
1010     #define bfd_sizeof_headers(abfd, info) \
1011            BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
1012
1013     #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1014            BFD_SEND (abfd, _bfd_find_nearest_line, \
1015                      (abfd, syms, sec, off, file, func, line, NULL))
1016
1017     #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \
1018                                                line, disc) \
1019            BFD_SEND (abfd, _bfd_find_nearest_line, \
1020                      (abfd, syms, sec, off, file, func, line, disc))
1021
1022     #define bfd_find_line(abfd, syms, sym, file, line) \
1023            BFD_SEND (abfd, _bfd_find_line, \
1024                      (abfd, syms, sym, file, line))
1025
1026     #define bfd_find_inliner_info(abfd, file, func, line) \
1027            BFD_SEND (abfd, _bfd_find_inliner_info, \
1028                      (abfd, file, func, line))
1029
1030     #define bfd_debug_info_start(abfd) \
1031            BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1032
1033     #define bfd_debug_info_end(abfd) \
1034            BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1035
1036     #define bfd_debug_info_accumulate(abfd, section) \
1037            BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1038
1039     #define bfd_stat_arch_elt(abfd, stat) \
1040            BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
1041
1042     #define bfd_update_armap_timestamp(abfd) \
1043            BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
1044
1045     #define bfd_set_arch_mach(abfd, arch, mach)\
1046            BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1047
1048     #define bfd_relax_section(abfd, section, link_info, again) \
1049            BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
1050
1051     #define bfd_gc_sections(abfd, link_info) \
1052            BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
1053
1054     #define bfd_lookup_section_flags(link_info, flag_info, section) \
1055            BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section))
1056
1057     #define bfd_merge_sections(abfd, link_info) \
1058            BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
1059
1060     #define bfd_is_group_section(abfd, sec) \
1061            BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
1062
1063     #define bfd_discard_group(abfd, sec) \
1064            BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
1065
1066     #define bfd_link_hash_table_create(abfd) \
1067            BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1068
1069     #define bfd_link_add_symbols(abfd, info) \
1070            BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1071
1072     #define bfd_link_just_syms(abfd, sec, info) \
1073            BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
1074
1075     #define bfd_final_link(abfd, info) \
1076            BFD_SEND (abfd, _bfd_final_link, (abfd, info))
1077
1078     #define bfd_free_cached_info(abfd) \
1079            BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
1080
1081     #define bfd_get_dynamic_symtab_upper_bound(abfd) \
1082            BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
1083
1084     #define bfd_print_private_bfd_data(abfd, file)\
1085            BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
1086
1087     #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
1088            BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
1089
1090     #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
1091            BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
1092                                                        dyncount, dynsyms, ret))
1093
1094     #define bfd_get_dynamic_reloc_upper_bound(abfd) \
1095            BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
1096
1097     #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
1098            BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
1099
1100     extern bfd_byte *bfd_get_relocated_section_contents
1101       (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
1102        bfd_boolean, asymbol **);
1103
1104
11052.3.1.15 'bfd_alt_mach_code'
1106............................
1107
1108*Synopsis*
1109     bfd_boolean bfd_alt_mach_code (bfd *abfd, int alternative);
1110   *Description*
1111When more than one machine code number is available for the same machine
1112type, this function can be used to switch between the preferred one
1113(alternative == 0) and any others.  Currently, only ELF supports this
1114feature, with up to two alternate machine codes.
1115
11162.3.1.16 'bfd_emul_get_maxpagesize'
1117...................................
1118
1119*Synopsis*
1120     bfd_vma bfd_emul_get_maxpagesize (const char *);
1121   *Description*
1122Returns the maximum page size, in bytes, as determined by emulation.
1123
1124   *Returns*
1125Returns the maximum page size in bytes for ELF, 0 otherwise.
1126
11272.3.1.17 'bfd_emul_set_maxpagesize'
1128...................................
1129
1130*Synopsis*
1131     void bfd_emul_set_maxpagesize (const char *, bfd_vma);
1132   *Description*
1133For ELF, set the maximum page size for the emulation.  It is a no-op for
1134other formats.
1135
11362.3.1.18 'bfd_emul_get_commonpagesize'
1137......................................
1138
1139*Synopsis*
1140     bfd_vma bfd_emul_get_commonpagesize (const char *);
1141   *Description*
1142Returns the common page size, in bytes, as determined by emulation.
1143
1144   *Returns*
1145Returns the common page size in bytes for ELF, 0 otherwise.
1146
11472.3.1.19 'bfd_emul_set_commonpagesize'
1148......................................
1149
1150*Synopsis*
1151     void bfd_emul_set_commonpagesize (const char *, bfd_vma);
1152   *Description*
1153For ELF, set the common page size for the emulation.  It is a no-op for
1154other formats.
1155
11562.3.1.20 'bfd_demangle'
1157.......................
1158
1159*Synopsis*
1160     char *bfd_demangle (bfd *, const char *, int);
1161   *Description*
1162Wrapper around cplus_demangle.  Strips leading underscores and other
1163such chars that would otherwise confuse the demangler.  If passed a g++
1164v3 ABI mangled name, returns a buffer allocated with malloc holding the
1165demangled name.  Returns NULL otherwise and on memory alloc failure.
1166
11672.3.1.21 'bfd_update_compression_header'
1168........................................
1169
1170*Synopsis*
1171     void bfd_update_compression_header
1172        (bfd *abfd, bfd_byte *contents, asection *sec);
1173   *Description*
1174Set the compression header at CONTENTS of SEC in ABFD and update
1175elf_section_flags for compression.
1176
11772.3.1.22 'bfd_check_compression_header'
1178.......................................
1179
1180*Synopsis*
1181     bfd_boolean bfd_check_compression_header
1182        (bfd *abfd, bfd_byte *contents, asection *sec,
1183         bfd_size_type *uncompressed_size);
1184   *Description*
1185Check the compression header at CONTENTS of SEC in ABFD and store the
1186uncompressed size in UNCOMPRESSED_SIZE if the compression header is
1187valid.
1188
1189   *Returns*
1190Return TRUE if the compression header is valid.
1191
11922.3.1.23 'bfd_get_compression_header_size'
1193..........................................
1194
1195*Synopsis*
1196     int bfd_get_compression_header_size (bfd *abfd, asection *sec);
1197   *Description*
1198Return the size of the compression header of SEC in ABFD.
1199
1200   *Returns*
1201Return the size of the compression header in bytes.
1202
12032.3.1.24 'bfd_convert_section_size'
1204...................................
1205
1206*Synopsis*
1207     bfd_size_type bfd_convert_section_size
1208        (bfd *ibfd, asection *isec, bfd *obfd, bfd_size_type size);
1209   *Description*
1210Convert the size SIZE of the section ISEC in input BFD IBFD to the
1211section size in output BFD OBFD.
1212
12132.3.1.25 'bfd_convert_section_contents'
1214.......................................
1215
1216*Synopsis*
1217     bfd_boolean bfd_convert_section_contents
1218        (bfd *ibfd, asection *isec, bfd *obfd,
1219         bfd_byte **ptr, bfd_size_type *ptr_size);
1220   *Description*
1221Convert the contents, stored in *PTR, of the section ISEC in input BFD
1222IBFD to output BFD OBFD if needed.  The original buffer pointed to by
1223*PTR may be freed and *PTR is returned with memory malloc'd by this
1224function, and the new size written to PTR_SIZE.
1225
12262.3.1.26 'struct bfd_iovec'
1227...........................
1228
1229*Description*
1230The 'struct bfd_iovec' contains the internal file I/O class.  Each 'BFD'
1231has an instance of this class and all file I/O is routed through it (it
1232is assumed that the instance implements all methods listed below).
1233     struct bfd_iovec
1234     {
1235       /* To avoid problems with macros, a "b" rather than "f"
1236          prefix is prepended to each method name.  */
1237       /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching
1238          bytes starting at PTR.  Return the number of bytes actually
1239          transfered (a read past end-of-file returns less than NBYTES),
1240          or -1 (setting bfd_error) if an error occurs.  */
1241       file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes);
1242       file_ptr (*bwrite) (struct bfd *abfd, const void *ptr,
1243                           file_ptr nbytes);
1244       /* Return the current IOSTREAM file offset, or -1 (setting bfd_error
1245          if an error occurs.  */
1246       file_ptr (*btell) (struct bfd *abfd);
1247       /* For the following, on successful completion a value of 0 is returned.
1248          Otherwise, a value of -1 is returned (and bfd_error is set).  */
1249       int (*bseek) (struct bfd *abfd, file_ptr offset, int whence);
1250       int (*bclose) (struct bfd *abfd);
1251       int (*bflush) (struct bfd *abfd);
1252       int (*bstat) (struct bfd *abfd, struct stat *sb);
1253       /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual
1254          mmap parameter, except that LEN and OFFSET do not need to be page
1255          aligned.  Returns (void *)-1 on failure, mmapped address on success.
1256          Also write in MAP_ADDR the address of the page aligned buffer and in
1257          MAP_LEN the size mapped (a page multiple).  Use unmap with MAP_ADDR and
1258          MAP_LEN to unmap.  */
1259       void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len,
1260                       int prot, int flags, file_ptr offset,
1261                       void **map_addr, bfd_size_type *map_len);
1262     };
1263     extern const struct bfd_iovec _bfd_memory_iovec;
1264
12652.3.1.27 'bfd_get_mtime'
1266........................
1267
1268*Synopsis*
1269     long bfd_get_mtime (bfd *abfd);
1270   *Description*
1271Return the file modification time (as read from the file system, or from
1272the archive header for archive members).
1273
12742.3.1.28 'bfd_get_size'
1275.......................
1276
1277*Synopsis*
1278     ufile_ptr bfd_get_size (bfd *abfd);
1279   *Description*
1280Return the file size (as read from file system) for the file associated
1281with BFD ABFD.
1282
1283   The initial motivation for, and use of, this routine is not so we can
1284get the exact size of the object the BFD applies to, since that might
1285not be generally possible (archive members for example).  It would be
1286ideal if someone could eventually modify it so that such results were
1287guaranteed.
1288
1289   Instead, we want to ask questions like "is this NNN byte sized object
1290I'm about to try read from file offset YYY reasonable?"  As as example
1291of where we might do this, some object formats use string tables for
1292which the first 'sizeof (long)' bytes of the table contain the size of
1293the table itself, including the size bytes.  If an application tries to
1294read what it thinks is one of these string tables, without some way to
1295validate the size, and for some reason the size is wrong (byte swapping
1296error, wrong location for the string table, etc.), the only clue is
1297likely to be a read error when it tries to read the table, or a "virtual
1298memory exhausted" error when it tries to allocate 15 bazillon bytes of
1299space for the 15 bazillon byte table it is about to read.  This function
1300at least allows us to answer the question, "is the size reasonable?".
1301
13022.3.1.29 'bfd_get_file_size'
1303............................
1304
1305*Synopsis*
1306     ufile_ptr bfd_get_file_size (bfd *abfd);
1307   *Description*
1308Return the file size (as read from file system) for the file associated
1309with BFD ABFD.  It supports both normal files and archive elements.
1310
13112.3.1.30 'bfd_mmap'
1312...................
1313
1314*Synopsis*
1315     void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len,
1316         int prot, int flags, file_ptr offset,
1317         void **map_addr, bfd_size_type *map_len);
1318   *Description*
1319Return mmap()ed region of the file, if possible and implemented.  LEN
1320and OFFSET do not need to be page aligned.  The page aligned address and
1321length are written to MAP_ADDR and MAP_LEN.
1322
1323
1324File: bfd.info,  Node: Memory Usage,  Next: Initialization,  Prev: Miscellaneous,  Up: BFD front end
1325
13262.4 Memory Usage
1327================
1328
1329BFD keeps all of its internal structures in obstacks.  There is one
1330obstack per open BFD file, into which the current state is stored.  When
1331a BFD is closed, the obstack is deleted, and so everything which has
1332been allocated by BFD for the closing file is thrown away.
1333
1334   BFD does not free anything created by an application, but pointers
1335into 'bfd' structures become invalid on a 'bfd_close'; for example,
1336after a 'bfd_close' the vector passed to 'bfd_canonicalize_symtab' is
1337still around, since it has been allocated by the application, but the
1338data that it pointed to are lost.
1339
1340   The general rule is to not close a BFD until all operations dependent
1341upon data from the BFD have been completed, or all the data from within
1342the file has been copied.  To help with the management of memory, there
1343is a function ('bfd_alloc_size') which returns the number of bytes in
1344obstacks associated with the supplied BFD. This could be used to select
1345the greediest open BFD, close it to reclaim the memory, perform some
1346operation and reopen the BFD again, to get a fresh copy of the data
1347structures.
1348
1349
1350File: bfd.info,  Node: Initialization,  Next: Sections,  Prev: Memory Usage,  Up: BFD front end
1351
13522.5 Initialization
1353==================
1354
13552.5.1 Initialization functions
1356------------------------------
1357
1358These are the functions that handle initializing a BFD.
1359
13602.5.1.1 'bfd_init'
1361..................
1362
1363*Synopsis*
1364     void bfd_init (void);
1365   *Description*
1366This routine must be called before any other BFD function to initialize
1367magical internal data structures.
1368
1369
1370File: bfd.info,  Node: Sections,  Next: Symbols,  Prev: Initialization,  Up: BFD front end
1371
13722.6 Sections
1373============
1374
1375The raw data contained within a BFD is maintained through the section
1376abstraction.  A single BFD may have any number of sections.  It keeps
1377hold of them by pointing to the first; each one points to the next in
1378the list.
1379
1380   Sections are supported in BFD in 'section.c'.
1381
1382* Menu:
1383
1384* Section Input::
1385* Section Output::
1386* typedef asection::
1387* section prototypes::
1388
1389
1390File: bfd.info,  Node: Section Input,  Next: Section Output,  Prev: Sections,  Up: Sections
1391
13922.6.1 Section input
1393-------------------
1394
1395When a BFD is opened for reading, the section structures are created and
1396attached to the BFD.
1397
1398   Each section has a name which describes the section in the outside
1399world--for example, 'a.out' would contain at least three sections,
1400called '.text', '.data' and '.bss'.
1401
1402   Names need not be unique; for example a COFF file may have several
1403sections named '.data'.
1404
1405   Sometimes a BFD will contain more than the "natural" number of
1406sections.  A back end may attach other sections containing constructor
1407data, or an application may add a section (using 'bfd_make_section') to
1408the sections attached to an already open BFD. For example, the linker
1409creates an extra section 'COMMON' for each input file's BFD to hold
1410information about common storage.
1411
1412   The raw data is not necessarily read in when the section descriptor
1413is created.  Some targets may leave the data in place until a
1414'bfd_get_section_contents' call is made.  Other back ends may read in
1415all the data at once.  For example, an S-record file has to be read once
1416to determine the size of the data.  An IEEE-695 file doesn't contain raw
1417data in sections, but data and relocation expressions intermixed, so the
1418data area has to be parsed to get out the data and relocations.
1419
1420
1421File: bfd.info,  Node: Section Output,  Next: typedef asection,  Prev: Section Input,  Up: Sections
1422
14232.6.2 Section output
1424--------------------
1425
1426To write a new object style BFD, the various sections to be written have
1427to be created.  They are attached to the BFD in the same way as input
1428sections; data is written to the sections using
1429'bfd_set_section_contents'.
1430
1431   Any program that creates or combines sections (e.g., the assembler
1432and linker) must use the 'asection' fields 'output_section' and
1433'output_offset' to indicate the file sections to which each section must
1434be written.  (If the section is being created from scratch,
1435'output_section' should probably point to the section itself and
1436'output_offset' should probably be zero.)
1437
1438   The data to be written comes from input sections attached (via
1439'output_section' pointers) to the output sections.  The output section
1440structure can be considered a filter for the input section: the output
1441section determines the vma of the output data and the name, but the
1442input section determines the offset into the output section of the data
1443to be written.
1444
1445   E.g., to create a section "O", starting at 0x100, 0x123 long,
1446containing two subsections, "A" at offset 0x0 (i.e., at vma 0x100) and
1447"B" at offset 0x20 (i.e., at vma 0x120) the 'asection' structures would
1448look like:
1449
1450        section name          "A"
1451          output_offset   0x00
1452          size            0x20
1453          output_section ----------->  section name    "O"
1454                                  |    vma             0x100
1455        section name          "B" |    size            0x123
1456          output_offset   0x20    |
1457          size            0x103   |
1458          output_section  --------|
1459
14602.6.3 Link orders
1461-----------------
1462
1463The data within a section is stored in a "link_order".  These are much
1464like the fixups in 'gas'.  The link_order abstraction allows a section
1465to grow and shrink within itself.
1466
1467   A link_order knows how big it is, and which is the next link_order
1468and where the raw data for it is; it also points to a list of
1469relocations which apply to it.
1470
1471   The link_order is used by the linker to perform relaxing on final
1472code.  The compiler creates code which is as big as necessary to make it
1473work without relaxing, and the user can select whether to relax.
1474Sometimes relaxing takes a lot of time.  The linker runs around the
1475relocations to see if any are attached to data which can be shrunk, if
1476so it does it on a link_order by link_order basis.
1477
1478
1479File: bfd.info,  Node: typedef asection,  Next: section prototypes,  Prev: Section Output,  Up: Sections
1480
14812.6.4 typedef asection
1482----------------------
1483
1484Here is the section structure:
1485
1486
1487     typedef struct bfd_section
1488     {
1489       /* The name of the section; the name isn't a copy, the pointer is
1490          the same as that passed to bfd_make_section.  */
1491       const char *name;
1492
1493       /* A unique sequence number.  */
1494       unsigned int id;
1495
1496       /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1497       unsigned int index;
1498
1499       /* The next section in the list belonging to the BFD, or NULL.  */
1500       struct bfd_section *next;
1501
1502       /* The previous section in the list belonging to the BFD, or NULL.  */
1503       struct bfd_section *prev;
1504
1505       /* The field flags contains attributes of the section. Some
1506          flags are read in from the object file, and some are
1507          synthesized from other information.  */
1508       flagword flags;
1509
1510     #define SEC_NO_FLAGS                      0x0
1511
1512       /* Tells the OS to allocate space for this section when loading.
1513          This is clear for a section containing debug information only.  */
1514     #define SEC_ALLOC                         0x1
1515
1516       /* Tells the OS to load the section from the file when loading.
1517          This is clear for a .bss section.  */
1518     #define SEC_LOAD                          0x2
1519
1520       /* The section contains data still to be relocated, so there is
1521          some relocation information too.  */
1522     #define SEC_RELOC                         0x4
1523
1524       /* A signal to the OS that the section contains read only data.  */
1525     #define SEC_READONLY                      0x8
1526
1527       /* The section contains code only.  */
1528     #define SEC_CODE                         0x10
1529
1530       /* The section contains data only.  */
1531     #define SEC_DATA                         0x20
1532
1533       /* The section will reside in ROM.  */
1534     #define SEC_ROM                          0x40
1535
1536       /* The section contains constructor information. This section
1537          type is used by the linker to create lists of constructors and
1538          destructors used by g++. When a back end sees a symbol
1539          which should be used in a constructor list, it creates a new
1540          section for the type of name (e.g., __CTOR_LIST__), attaches
1541          the symbol to it, and builds a relocation. To build the lists
1542          of constructors, all the linker has to do is catenate all the
1543          sections called __CTOR_LIST__ and relocate the data
1544          contained within - exactly the operations it would peform on
1545          standard data.  */
1546     #define SEC_CONSTRUCTOR                  0x80
1547
1548       /* The section has contents - a data section could be
1549          SEC_ALLOC | SEC_HAS_CONTENTS; a debug section could be
1550          SEC_HAS_CONTENTS  */
1551     #define SEC_HAS_CONTENTS                0x100
1552
1553       /* An instruction to the linker to not output the section
1554          even if it has information which would normally be written.  */
1555     #define SEC_NEVER_LOAD                  0x200
1556
1557       /* The section contains thread local data.  */
1558     #define SEC_THREAD_LOCAL                0x400
1559
1560       /* The section has GOT references.  This flag is only for the
1561          linker, and is currently only used by the elf32-hppa back end.
1562          It will be set if global offset table references were detected
1563          in this section, which indicate to the linker that the section
1564          contains PIC code, and must be handled specially when doing a
1565          static link.  */
1566     #define SEC_HAS_GOT_REF                 0x800
1567
1568       /* The section contains common symbols (symbols may be defined
1569          multiple times, the value of a symbol is the amount of
1570          space it requires, and the largest symbol value is the one
1571          used).  Most targets have exactly one of these (which we
1572          translate to bfd_com_section_ptr), but ECOFF has two.  */
1573     #define SEC_IS_COMMON                  0x1000
1574
1575       /* The section contains only debugging information.  For
1576          example, this is set for ELF .debug and .stab sections.
1577          strip tests this flag to see if a section can be
1578          discarded.  */
1579     #define SEC_DEBUGGING                  0x2000
1580
1581       /* The contents of this section are held in memory pointed to
1582          by the contents field.  This is checked by bfd_get_section_contents,
1583          and the data is retrieved from memory if appropriate.  */
1584     #define SEC_IN_MEMORY                  0x4000
1585
1586       /* The contents of this section are to be excluded by the
1587          linker for executable and shared objects unless those
1588          objects are to be further relocated.  */
1589     #define SEC_EXCLUDE                    0x8000
1590
1591       /* The contents of this section are to be sorted based on the sum of
1592          the symbol and addend values specified by the associated relocation
1593          entries.  Entries without associated relocation entries will be
1594          appended to the end of the section in an unspecified order.  */
1595     #define SEC_SORT_ENTRIES              0x10000
1596
1597       /* When linking, duplicate sections of the same name should be
1598          discarded, rather than being combined into a single section as
1599          is usually done.  This is similar to how common symbols are
1600          handled.  See SEC_LINK_DUPLICATES below.  */
1601     #define SEC_LINK_ONCE                 0x20000
1602
1603       /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1604          should handle duplicate sections.  */
1605     #define SEC_LINK_DUPLICATES           0xc0000
1606
1607       /* This value for SEC_LINK_DUPLICATES means that duplicate
1608          sections with the same name should simply be discarded.  */
1609     #define SEC_LINK_DUPLICATES_DISCARD       0x0
1610
1611       /* This value for SEC_LINK_DUPLICATES means that the linker
1612          should warn if there are any duplicate sections, although
1613          it should still only link one copy.  */
1614     #define SEC_LINK_DUPLICATES_ONE_ONLY  0x40000
1615
1616       /* This value for SEC_LINK_DUPLICATES means that the linker
1617          should warn if any duplicate sections are a different size.  */
1618     #define SEC_LINK_DUPLICATES_SAME_SIZE 0x80000
1619
1620       /* This value for SEC_LINK_DUPLICATES means that the linker
1621          should warn if any duplicate sections contain different
1622          contents.  */
1623     #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1624       (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1625
1626       /* This section was created by the linker as part of dynamic
1627          relocation or other arcane processing.  It is skipped when
1628          going through the first-pass output, trusting that someone
1629          else up the line will take care of it later.  */
1630     #define SEC_LINKER_CREATED           0x100000
1631
1632       /* This section should not be subject to garbage collection.
1633          Also set to inform the linker that this section should not be
1634          listed in the link map as discarded.  */
1635     #define SEC_KEEP                     0x200000
1636
1637       /* This section contains "short" data, and should be placed
1638          "near" the GP.  */
1639     #define SEC_SMALL_DATA               0x400000
1640
1641       /* Attempt to merge identical entities in the section.
1642          Entity size is given in the entsize field.  */
1643     #define SEC_MERGE                    0x800000
1644
1645       /* If given with SEC_MERGE, entities to merge are zero terminated
1646          strings where entsize specifies character size instead of fixed
1647          size entries.  */
1648     #define SEC_STRINGS                 0x1000000
1649
1650       /* This section contains data about section groups.  */
1651     #define SEC_GROUP                   0x2000000
1652
1653       /* The section is a COFF shared library section.  This flag is
1654          only for the linker.  If this type of section appears in
1655          the input file, the linker must copy it to the output file
1656          without changing the vma or size.  FIXME: Although this
1657          was originally intended to be general, it really is COFF
1658          specific (and the flag was renamed to indicate this).  It
1659          might be cleaner to have some more general mechanism to
1660          allow the back end to control what the linker does with
1661          sections.  */
1662     #define SEC_COFF_SHARED_LIBRARY     0x4000000
1663
1664       /* This input section should be copied to output in reverse order
1665          as an array of pointers.  This is for ELF linker internal use
1666          only.  */
1667     #define SEC_ELF_REVERSE_COPY        0x4000000
1668
1669       /* This section contains data which may be shared with other
1670          executables or shared objects. This is for COFF only.  */
1671     #define SEC_COFF_SHARED             0x8000000
1672
1673       /* This section should be compressed.  This is for ELF linker
1674          internal use only.  */
1675     #define SEC_ELF_COMPRESS            0x8000000
1676
1677       /* When a section with this flag is being linked, then if the size of
1678          the input section is less than a page, it should not cross a page
1679          boundary.  If the size of the input section is one page or more,
1680          it should be aligned on a page boundary.  This is for TI
1681          TMS320C54X only.  */
1682     #define SEC_TIC54X_BLOCK           0x10000000
1683
1684       /* This section should be renamed.  This is for ELF linker
1685          internal use only.  */
1686     #define SEC_ELF_RENAME             0x10000000
1687
1688       /* Conditionally link this section; do not link if there are no
1689          references found to any symbol in the section.  This is for TI
1690          TMS320C54X only.  */
1691     #define SEC_TIC54X_CLINK           0x20000000
1692
1693       /* This section contains vliw code.  This is for Toshiba MeP only.  */
1694     #define SEC_MEP_VLIW               0x20000000
1695
1696       /* Indicate that section has the no read flag set. This happens
1697          when memory read flag isn't set. */
1698     #define SEC_COFF_NOREAD            0x40000000
1699
1700       /* Indicate that section has the purecode flag set.  */
1701     #define SEC_ELF_PURECODE           0x80000000
1702
1703       /*  End of section flags.  */
1704
1705       /* Some internal packed boolean fields.  */
1706
1707       /* See the vma field.  */
1708       unsigned int user_set_vma : 1;
1709
1710       /* A mark flag used by some of the linker backends.  */
1711       unsigned int linker_mark : 1;
1712
1713       /* Another mark flag used by some of the linker backends.  Set for
1714          output sections that have an input section.  */
1715       unsigned int linker_has_input : 1;
1716
1717       /* Mark flag used by some linker backends for garbage collection.  */
1718       unsigned int gc_mark : 1;
1719
1720       /* Section compression status.  */
1721       unsigned int compress_status : 2;
1722     #define COMPRESS_SECTION_NONE    0
1723     #define COMPRESS_SECTION_DONE    1
1724     #define DECOMPRESS_SECTION_SIZED 2
1725
1726       /* The following flags are used by the ELF linker. */
1727
1728       /* Mark sections which have been allocated to segments.  */
1729       unsigned int segment_mark : 1;
1730
1731       /* Type of sec_info information.  */
1732       unsigned int sec_info_type:3;
1733     #define SEC_INFO_TYPE_NONE      0
1734     #define SEC_INFO_TYPE_STABS     1
1735     #define SEC_INFO_TYPE_MERGE     2
1736     #define SEC_INFO_TYPE_EH_FRAME  3
1737     #define SEC_INFO_TYPE_JUST_SYMS 4
1738     #define SEC_INFO_TYPE_TARGET    5
1739     #define SEC_INFO_TYPE_EH_FRAME_ENTRY 6
1740
1741       /* Nonzero if this section uses RELA relocations, rather than REL.  */
1742       unsigned int use_rela_p:1;
1743
1744       /* Bits used by various backends.  The generic code doesn't touch
1745          these fields.  */
1746
1747       unsigned int sec_flg0:1;
1748       unsigned int sec_flg1:1;
1749       unsigned int sec_flg2:1;
1750       unsigned int sec_flg3:1;
1751       unsigned int sec_flg4:1;
1752       unsigned int sec_flg5:1;
1753
1754       /* End of internal packed boolean fields.  */
1755
1756       /*  The virtual memory address of the section - where it will be
1757           at run time.  The symbols are relocated against this.  The
1758           user_set_vma flag is maintained by bfd; if it's not set, the
1759           backend can assign addresses (for example, in a.out, where
1760           the default address for .data is dependent on the specific
1761           target and various flags).  */
1762       bfd_vma vma;
1763
1764       /*  The load address of the section - where it would be in a
1765           rom image; really only used for writing section header
1766           information.  */
1767       bfd_vma lma;
1768
1769       /* The size of the section in *octets*, as it will be output.
1770          Contains a value even if the section has no contents (e.g., the
1771          size of .bss).  */
1772       bfd_size_type size;
1773
1774       /* For input sections, the original size on disk of the section, in
1775          octets.  This field should be set for any section whose size is
1776          changed by linker relaxation.  It is required for sections where
1777          the linker relaxation scheme doesn't cache altered section and
1778          reloc contents (stabs, eh_frame, SEC_MERGE, some coff relaxing
1779          targets), and thus the original size needs to be kept to read the
1780          section multiple times.  For output sections, rawsize holds the
1781          section size calculated on a previous linker relaxation pass.  */
1782       bfd_size_type rawsize;
1783
1784       /* The compressed size of the section in octets.  */
1785       bfd_size_type compressed_size;
1786
1787       /* Relaxation table. */
1788       struct relax_table *relax;
1789
1790       /* Count of used relaxation table entries. */
1791       int relax_count;
1792
1793
1794       /* If this section is going to be output, then this value is the
1795          offset in *bytes* into the output section of the first byte in the
1796          input section (byte ==> smallest addressable unit on the
1797          target).  In most cases, if this was going to start at the
1798          100th octet (8-bit quantity) in the output section, this value
1799          would be 100.  However, if the target byte size is 16 bits
1800          (bfd_octets_per_byte is "2"), this value would be 50.  */
1801       bfd_vma output_offset;
1802
1803       /* The output section through which to map on output.  */
1804       struct bfd_section *output_section;
1805
1806       /* The alignment requirement of the section, as an exponent of 2 -
1807          e.g., 3 aligns to 2^3 (or 8).  */
1808       unsigned int alignment_power;
1809
1810       /* If an input section, a pointer to a vector of relocation
1811          records for the data in this section.  */
1812       struct reloc_cache_entry *relocation;
1813
1814       /* If an output section, a pointer to a vector of pointers to
1815          relocation records for the data in this section.  */
1816       struct reloc_cache_entry **orelocation;
1817
1818       /* The number of relocation records in one of the above.  */
1819       unsigned reloc_count;
1820
1821       /* Information below is back end specific - and not always used
1822          or updated.  */
1823
1824       /* File position of section data.  */
1825       file_ptr filepos;
1826
1827       /* File position of relocation info.  */
1828       file_ptr rel_filepos;
1829
1830       /* File position of line data.  */
1831       file_ptr line_filepos;
1832
1833       /* Pointer to data for applications.  */
1834       void *userdata;
1835
1836       /* If the SEC_IN_MEMORY flag is set, this points to the actual
1837          contents.  */
1838       unsigned char *contents;
1839
1840       /* Attached line number information.  */
1841       alent *lineno;
1842
1843       /* Number of line number records.  */
1844       unsigned int lineno_count;
1845
1846       /* Entity size for merging purposes.  */
1847       unsigned int entsize;
1848
1849       /* Points to the kept section if this section is a link-once section,
1850          and is discarded.  */
1851       struct bfd_section *kept_section;
1852
1853       /* When a section is being output, this value changes as more
1854          linenumbers are written out.  */
1855       file_ptr moving_line_filepos;
1856
1857       /* What the section number is in the target world.  */
1858       int target_index;
1859
1860       void *used_by_bfd;
1861
1862       /* If this is a constructor section then here is a list of the
1863          relocations created to relocate items within it.  */
1864       struct relent_chain *constructor_chain;
1865
1866       /* The BFD which owns the section.  */
1867       bfd *owner;
1868
1869       /* A symbol which points at this section only.  */
1870       struct bfd_symbol *symbol;
1871       struct bfd_symbol **symbol_ptr_ptr;
1872
1873       /* Early in the link process, map_head and map_tail are used to build
1874          a list of input sections attached to an output section.  Later,
1875          output sections use these fields for a list of bfd_link_order
1876          structs.  */
1877       union {
1878         struct bfd_link_order *link_order;
1879         struct bfd_section *s;
1880       } map_head, map_tail;
1881     } asection;
1882
1883     /* Relax table contains information about instructions which can
1884        be removed by relaxation -- replacing a long address with a
1885        short address.  */
1886     struct relax_table {
1887       /* Address where bytes may be deleted. */
1888       bfd_vma addr;
1889
1890       /* Number of bytes to be deleted.  */
1891       int size;
1892     };
1893
1894     /* Note: the following are provided as inline functions rather than macros
1895        because not all callers use the return value.  A macro implementation
1896        would use a comma expression, eg: "((ptr)->foo = val, TRUE)" and some
1897        compilers will complain about comma expressions that have no effect.  */
1898     static inline bfd_boolean
1899     bfd_set_section_userdata (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr,
1900                               void * val)
1901     {
1902       ptr->userdata = val;
1903       return TRUE;
1904     }
1905
1906     static inline bfd_boolean
1907     bfd_set_section_vma (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr, bfd_vma val)
1908     {
1909       ptr->vma = ptr->lma = val;
1910       ptr->user_set_vma = TRUE;
1911       return TRUE;
1912     }
1913
1914     static inline bfd_boolean
1915     bfd_set_section_alignment (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr,
1916                                unsigned int val)
1917     {
1918       ptr->alignment_power = val;
1919       return TRUE;
1920     }
1921
1922     /* These sections are global, and are managed by BFD.  The application
1923        and target back end are not permitted to change the values in
1924        these sections.  */
1925     extern asection _bfd_std_section[4];
1926
1927     #define BFD_ABS_SECTION_NAME "*ABS*"
1928     #define BFD_UND_SECTION_NAME "*UND*"
1929     #define BFD_COM_SECTION_NAME "*COM*"
1930     #define BFD_IND_SECTION_NAME "*IND*"
1931
1932     /* Pointer to the common section.  */
1933     #define bfd_com_section_ptr (&_bfd_std_section[0])
1934     /* Pointer to the undefined section.  */
1935     #define bfd_und_section_ptr (&_bfd_std_section[1])
1936     /* Pointer to the absolute section.  */
1937     #define bfd_abs_section_ptr (&_bfd_std_section[2])
1938     /* Pointer to the indirect section.  */
1939     #define bfd_ind_section_ptr (&_bfd_std_section[3])
1940
1941     #define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
1942     #define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
1943     #define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
1944
1945     #define bfd_is_const_section(SEC)              \
1946      (   ((SEC) == bfd_abs_section_ptr)            \
1947       || ((SEC) == bfd_und_section_ptr)            \
1948       || ((SEC) == bfd_com_section_ptr)            \
1949       || ((SEC) == bfd_ind_section_ptr))
1950
1951     /* Macros to handle insertion and deletion of a bfd's sections.  These
1952        only handle the list pointers, ie. do not adjust section_count,
1953        target_index etc.  */
1954     #define bfd_section_list_remove(ABFD, S) \
1955       do                                                   \
1956         {                                                  \
1957           asection *_s = S;                                \
1958           asection *_next = _s->next;                      \
1959           asection *_prev = _s->prev;                      \
1960           if (_prev)                                       \
1961             _prev->next = _next;                           \
1962           else                                             \
1963             (ABFD)->sections = _next;                      \
1964           if (_next)                                       \
1965             _next->prev = _prev;                           \
1966           else                                             \
1967             (ABFD)->section_last = _prev;                  \
1968         }                                                  \
1969       while (0)
1970     #define bfd_section_list_append(ABFD, S) \
1971       do                                                   \
1972         {                                                  \
1973           asection *_s = S;                                \
1974           bfd *_abfd = ABFD;                               \
1975           _s->next = NULL;                                 \
1976           if (_abfd->section_last)                         \
1977             {                                              \
1978               _s->prev = _abfd->section_last;              \
1979               _abfd->section_last->next = _s;              \
1980             }                                              \
1981           else                                             \
1982             {                                              \
1983               _s->prev = NULL;                             \
1984               _abfd->sections = _s;                        \
1985             }                                              \
1986           _abfd->section_last = _s;                        \
1987         }                                                  \
1988       while (0)
1989     #define bfd_section_list_prepend(ABFD, S) \
1990       do                                                   \
1991         {                                                  \
1992           asection *_s = S;                                \
1993           bfd *_abfd = ABFD;                               \
1994           _s->prev = NULL;                                 \
1995           if (_abfd->sections)                             \
1996             {                                              \
1997               _s->next = _abfd->sections;                  \
1998               _abfd->sections->prev = _s;                  \
1999             }                                              \
2000           else                                             \
2001             {                                              \
2002               _s->next = NULL;                             \
2003               _abfd->section_last = _s;                    \
2004             }                                              \
2005           _abfd->sections = _s;                            \
2006         }                                                  \
2007       while (0)
2008     #define bfd_section_list_insert_after(ABFD, A, S) \
2009       do                                                   \
2010         {                                                  \
2011           asection *_a = A;                                \
2012           asection *_s = S;                                \
2013           asection *_next = _a->next;                      \
2014           _s->next = _next;                                \
2015           _s->prev = _a;                                   \
2016           _a->next = _s;                                   \
2017           if (_next)                                       \
2018             _next->prev = _s;                              \
2019           else                                             \
2020             (ABFD)->section_last = _s;                     \
2021         }                                                  \
2022       while (0)
2023     #define bfd_section_list_insert_before(ABFD, B, S) \
2024       do                                                   \
2025         {                                                  \
2026           asection *_b = B;                                \
2027           asection *_s = S;                                \
2028           asection *_prev = _b->prev;                      \
2029           _s->prev = _prev;                                \
2030           _s->next = _b;                                   \
2031           _b->prev = _s;                                   \
2032           if (_prev)                                       \
2033             _prev->next = _s;                              \
2034           else                                             \
2035             (ABFD)->sections = _s;                         \
2036         }                                                  \
2037       while (0)
2038     #define bfd_section_removed_from_list(ABFD, S) \
2039       ((S)->next == NULL ? (ABFD)->section_last != (S) : (S)->next->prev != (S))
2040
2041     #define BFD_FAKE_SECTION(SEC, SYM, NAME, IDX, FLAGS)                   \
2042       /* name, id,  index, next, prev, flags, user_set_vma,            */  \
2043       {  NAME, IDX, 0,     NULL, NULL, FLAGS, 0,                           \
2044                                                                            \
2045       /* linker_mark, linker_has_input, gc_mark, decompress_status,    */  \
2046          0,           0,                1,       0,                        \
2047                                                                            \
2048       /* segment_mark, sec_info_type, use_rela_p,                      */  \
2049          0,            0,             0,                                   \
2050                                                                            \
2051       /* sec_flg0, sec_flg1, sec_flg2, sec_flg3, sec_flg4, sec_flg5,   */  \
2052          0,        0,        0,        0,        0,        0,              \
2053                                                                            \
2054       /* vma, lma, size, rawsize, compressed_size, relax, relax_count, */  \
2055          0,   0,   0,    0,       0,               0,     0,               \
2056                                                                            \
2057       /* output_offset, output_section, alignment_power,               */  \
2058          0,             &SEC,           0,                                 \
2059                                                                            \
2060       /* relocation, orelocation, reloc_count, filepos, rel_filepos,   */  \
2061          NULL,       NULL,        0,           0,       0,                 \
2062                                                                            \
2063       /* line_filepos, userdata, contents, lineno, lineno_count,       */  \
2064          0,            NULL,     NULL,     NULL,   0,                      \
2065                                                                            \
2066       /* entsize, kept_section, moving_line_filepos,                    */ \
2067          0,       NULL,          0,                                        \
2068                                                                            \
2069       /* target_index, used_by_bfd, constructor_chain, owner,          */  \
2070          0,            NULL,        NULL,              NULL,               \
2071                                                                            \
2072       /* symbol,                    symbol_ptr_ptr,                    */  \
2073          (struct bfd_symbol *) SYM, &SEC.symbol,                           \
2074                                                                            \
2075       /* map_head, map_tail                                            */  \
2076          { NULL }, { NULL }                                                \
2077         }
2078
2079     /* We use a macro to initialize the static asymbol structures because
2080        traditional C does not permit us to initialize a union member while
2081        gcc warns if we don't initialize it.
2082        the_bfd, name, value, attr, section [, udata]  */
2083     #ifdef __STDC__
2084     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2085       { 0, NAME, 0, BSF_SECTION_SYM, SECTION, { 0 }}
2086     #else
2087     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2088       { 0, NAME, 0, BSF_SECTION_SYM, SECTION }
2089     #endif
2090
2091
2092
2093File: bfd.info,  Node: section prototypes,  Prev: typedef asection,  Up: Sections
2094
20952.6.5 Section prototypes
2096------------------------
2097
2098These are the functions exported by the section handling part of BFD.
2099
21002.6.5.1 'bfd_section_list_clear'
2101................................
2102
2103*Synopsis*
2104     void bfd_section_list_clear (bfd *);
2105   *Description*
2106Clears the section list, and also resets the section count and hash
2107table entries.
2108
21092.6.5.2 'bfd_get_section_by_name'
2110.................................
2111
2112*Synopsis*
2113     asection *bfd_get_section_by_name (bfd *abfd, const char *name);
2114   *Description*
2115Return the most recently created section attached to ABFD named NAME.
2116Return NULL if no such section exists.
2117
21182.6.5.3 'bfd_get_next_section_by_name'
2119......................................
2120
2121*Synopsis*
2122     asection *bfd_get_next_section_by_name (bfd *ibfd, asection *sec);
2123   *Description*
2124Given SEC is a section returned by 'bfd_get_section_by_name', return the
2125next most recently created section attached to the same BFD with the
2126same name, or if no such section exists in the same BFD and IBFD is
2127non-NULL, the next section with the same name in any input BFD following
2128IBFD. Return NULL on finding no section.
2129
21302.6.5.4 'bfd_get_linker_section'
2131................................
2132
2133*Synopsis*
2134     asection *bfd_get_linker_section (bfd *abfd, const char *name);
2135   *Description*
2136Return the linker created section attached to ABFD named NAME.  Return
2137NULL if no such section exists.
2138
21392.6.5.5 'bfd_get_section_by_name_if'
2140....................................
2141
2142*Synopsis*
2143     asection *bfd_get_section_by_name_if
2144        (bfd *abfd,
2145         const char *name,
2146         bfd_boolean (*func) (bfd *abfd, asection *sect, void *obj),
2147         void *obj);
2148   *Description*
2149Call the provided function FUNC for each section attached to the BFD
2150ABFD whose name matches NAME, passing OBJ as an argument.  The function
2151will be called as if by
2152
2153            func (abfd, the_section, obj);
2154
2155   It returns the first section for which FUNC returns true, otherwise
2156'NULL'.
2157
21582.6.5.6 'bfd_get_unique_section_name'
2159.....................................
2160
2161*Synopsis*
2162     char *bfd_get_unique_section_name
2163        (bfd *abfd, const char *templat, int *count);
2164   *Description*
2165Invent a section name that is unique in ABFD by tacking a dot and a
2166digit suffix onto the original TEMPLAT.  If COUNT is non-NULL, then it
2167specifies the first number tried as a suffix to generate a unique name.
2168The value pointed to by COUNT will be incremented in this case.
2169
21702.6.5.7 'bfd_make_section_old_way'
2171..................................
2172
2173*Synopsis*
2174     asection *bfd_make_section_old_way (bfd *abfd, const char *name);
2175   *Description*
2176Create a new empty section called NAME and attach it to the end of the
2177chain of sections for the BFD ABFD.  An attempt to create a section with
2178a name which is already in use returns its pointer without changing the
2179section chain.
2180
2181   It has the funny name since this is the way it used to be before it
2182was rewritten....
2183
2184   Possible errors are:
2185
2186   * 'bfd_error_invalid_operation' - If output has already started for
2187     this BFD.
2188   * 'bfd_error_no_memory' - If memory allocation fails.
2189
21902.6.5.8 'bfd_make_section_anyway_with_flags'
2191............................................
2192
2193*Synopsis*
2194     asection *bfd_make_section_anyway_with_flags
2195        (bfd *abfd, const char *name, flagword flags);
2196   *Description*
2197Create a new empty section called NAME and attach it to the end of the
2198chain of sections for ABFD.  Create a new section even if there is
2199already a section with that name.  Also set the attributes of the new
2200section to the value FLAGS.
2201
2202   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2203
2204   * 'bfd_error_invalid_operation' - If output has already started for
2205     ABFD.
2206   * 'bfd_error_no_memory' - If memory allocation fails.
2207
22082.6.5.9 'bfd_make_section_anyway'
2209.................................
2210
2211*Synopsis*
2212     asection *bfd_make_section_anyway (bfd *abfd, const char *name);
2213   *Description*
2214Create a new empty section called NAME and attach it to the end of the
2215chain of sections for ABFD.  Create a new section even if there is
2216already a section with that name.
2217
2218   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2219
2220   * 'bfd_error_invalid_operation' - If output has already started for
2221     ABFD.
2222   * 'bfd_error_no_memory' - If memory allocation fails.
2223
22242.6.5.10 'bfd_make_section_with_flags'
2225......................................
2226
2227*Synopsis*
2228     asection *bfd_make_section_with_flags
2229        (bfd *, const char *name, flagword flags);
2230   *Description*
2231Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2232bfd_set_error ()) without changing the section chain if there is already
2233a section named NAME.  Also set the attributes of the new section to the
2234value FLAGS.  If there is an error, return 'NULL' and set 'bfd_error'.
2235
22362.6.5.11 'bfd_make_section'
2237...........................
2238
2239*Synopsis*
2240     asection *bfd_make_section (bfd *, const char *name);
2241   *Description*
2242Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2243bfd_set_error ()) without changing the section chain if there is already
2244a section named NAME.  If there is an error, return 'NULL' and set
2245'bfd_error'.
2246
22472.6.5.12 'bfd_get_next_section_id'
2248..................................
2249
2250*Synopsis*
2251     int bfd_get_next_section_id (void);
2252   *Description*
2253Returns the id that the next section created will have.
2254
22552.6.5.13 'bfd_set_section_flags'
2256................................
2257
2258*Synopsis*
2259     bfd_boolean bfd_set_section_flags
2260        (bfd *abfd, asection *sec, flagword flags);
2261   *Description*
2262Set the attributes of the section SEC in the BFD ABFD to the value
2263FLAGS.  Return 'TRUE' on success, 'FALSE' on error.  Possible error
2264returns are:
2265
2266   * 'bfd_error_invalid_operation' - The section cannot have one or more
2267     of the attributes requested.  For example, a .bss section in
2268     'a.out' may not have the 'SEC_HAS_CONTENTS' field set.
2269
22702.6.5.14 'bfd_rename_section'
2271.............................
2272
2273*Synopsis*
2274     void bfd_rename_section
2275        (bfd *abfd, asection *sec, const char *newname);
2276   *Description*
2277Rename section SEC in ABFD to NEWNAME.
2278
22792.6.5.15 'bfd_map_over_sections'
2280................................
2281
2282*Synopsis*
2283     void bfd_map_over_sections
2284        (bfd *abfd,
2285         void (*func) (bfd *abfd, asection *sect, void *obj),
2286         void *obj);
2287   *Description*
2288Call the provided function FUNC for each section attached to the BFD
2289ABFD, passing OBJ as an argument.  The function will be called as if by
2290
2291            func (abfd, the_section, obj);
2292
2293   This is the preferred method for iterating over sections; an
2294alternative would be to use a loop:
2295
2296               asection *p;
2297               for (p = abfd->sections; p != NULL; p = p->next)
2298                  func (abfd, p, ...)
2299
23002.6.5.16 'bfd_sections_find_if'
2301...............................
2302
2303*Synopsis*
2304     asection *bfd_sections_find_if
2305        (bfd *abfd,
2306         bfd_boolean (*operation) (bfd *abfd, asection *sect, void *obj),
2307         void *obj);
2308   *Description*
2309Call the provided function OPERATION for each section attached to the
2310BFD ABFD, passing OBJ as an argument.  The function will be called as if
2311by
2312
2313            operation (abfd, the_section, obj);
2314
2315   It returns the first section for which OPERATION returns true.
2316
23172.6.5.17 'bfd_set_section_size'
2318...............................
2319
2320*Synopsis*
2321     bfd_boolean bfd_set_section_size
2322        (bfd *abfd, asection *sec, bfd_size_type val);
2323   *Description*
2324Set SEC to the size VAL.  If the operation is ok, then 'TRUE' is
2325returned, else 'FALSE'.
2326
2327   Possible error returns:
2328
2329   * 'bfd_error_invalid_operation' - Writing has started to the BFD, so
2330     setting the size is invalid.
2331
23322.6.5.18 'bfd_set_section_contents'
2333...................................
2334
2335*Synopsis*
2336     bfd_boolean bfd_set_section_contents
2337        (bfd *abfd, asection *section, const void *data,
2338         file_ptr offset, bfd_size_type count);
2339   *Description*
2340Sets the contents of the section SECTION in BFD ABFD to the data
2341starting in memory at DATA.  The data is written to the output section
2342starting at offset OFFSET for COUNT octets.
2343
2344   Normally 'TRUE' is returned, else 'FALSE'.  Possible error returns
2345are:
2346
2347   * 'bfd_error_no_contents' - The output section does not have the
2348     'SEC_HAS_CONTENTS' attribute, so nothing can be written to it.
2349   * and some more too
2350   This routine is front end to the back end function
2351'_bfd_set_section_contents'.
2352
23532.6.5.19 'bfd_get_section_contents'
2354...................................
2355
2356*Synopsis*
2357     bfd_boolean bfd_get_section_contents
2358        (bfd *abfd, asection *section, void *location, file_ptr offset,
2359         bfd_size_type count);
2360   *Description*
2361Read data from SECTION in BFD ABFD into memory starting at LOCATION.
2362The data is read at an offset of OFFSET from the start of the input
2363section, and is read for COUNT bytes.
2364
2365   If the contents of a constructor with the 'SEC_CONSTRUCTOR' flag set
2366are requested or if the section does not have the 'SEC_HAS_CONTENTS'
2367flag set, then the LOCATION is filled with zeroes.  If no errors occur,
2368'TRUE' is returned, else 'FALSE'.
2369
23702.6.5.20 'bfd_malloc_and_get_section'
2371.....................................
2372
2373*Synopsis*
2374     bfd_boolean bfd_malloc_and_get_section
2375        (bfd *abfd, asection *section, bfd_byte **buf);
2376   *Description*
2377Read all data from SECTION in BFD ABFD into a buffer, *BUF, malloc'd by
2378this function.
2379
23802.6.5.21 'bfd_copy_private_section_data'
2381........................................
2382
2383*Synopsis*
2384     bfd_boolean bfd_copy_private_section_data
2385        (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
2386   *Description*
2387Copy private section information from ISEC in the BFD IBFD to the
2388section OSEC in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on
2389error.  Possible error returns are:
2390
2391   * 'bfd_error_no_memory' - Not enough memory exists to create private
2392     data for OSEC.
2393     #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
2394            BFD_SEND (obfd, _bfd_copy_private_section_data, \
2395                      (ibfd, isection, obfd, osection))
2396
23972.6.5.22 'bfd_generic_is_group_section'
2398.......................................
2399
2400*Synopsis*
2401     bfd_boolean bfd_generic_is_group_section (bfd *, const asection *sec);
2402   *Description*
2403Returns TRUE if SEC is a member of a group.
2404
24052.6.5.23 'bfd_generic_discard_group'
2406....................................
2407
2408*Synopsis*
2409     bfd_boolean bfd_generic_discard_group (bfd *abfd, asection *group);
2410   *Description*
2411Remove all members of GROUP from the output.
2412
2413
2414File: bfd.info,  Node: Symbols,  Next: Archives,  Prev: Sections,  Up: BFD front end
2415
24162.7 Symbols
2417===========
2418
2419BFD tries to maintain as much symbol information as it can when it moves
2420information from file to file.  BFD passes information to applications
2421though the 'asymbol' structure.  When the application requests the
2422symbol table, BFD reads the table in the native form and translates
2423parts of it into the internal format.  To maintain more than the
2424information passed to applications, some targets keep some information
2425"behind the scenes" in a structure only the particular back end knows
2426about.  For example, the coff back end keeps the original symbol table
2427structure as well as the canonical structure when a BFD is read in.  On
2428output, the coff back end can reconstruct the output symbol table so
2429that no information is lost, even information unique to coff which BFD
2430doesn't know or understand.  If a coff symbol table were read, but were
2431written through an a.out back end, all the coff specific information
2432would be lost.  The symbol table of a BFD is not necessarily read in
2433until a canonicalize request is made.  Then the BFD back end fills in a
2434table provided by the application with pointers to the canonical
2435information.  To output symbols, the application provides BFD with a
2436table of pointers to pointers to 'asymbol's.  This allows applications
2437like the linker to output a symbol as it was read, since the "behind the
2438scenes" information will be still available.
2439* Menu:
2440
2441* Reading Symbols::
2442* Writing Symbols::
2443* Mini Symbols::
2444* typedef asymbol::
2445* symbol handling functions::
2446
2447
2448File: bfd.info,  Node: Reading Symbols,  Next: Writing Symbols,  Prev: Symbols,  Up: Symbols
2449
24502.7.1 Reading symbols
2451---------------------
2452
2453There are two stages to reading a symbol table from a BFD: allocating
2454storage, and the actual reading process.  This is an excerpt from an
2455application which reads the symbol table:
2456
2457              long storage_needed;
2458              asymbol **symbol_table;
2459              long number_of_symbols;
2460              long i;
2461
2462              storage_needed = bfd_get_symtab_upper_bound (abfd);
2463
2464              if (storage_needed < 0)
2465                FAIL
2466
2467              if (storage_needed == 0)
2468                return;
2469
2470              symbol_table = xmalloc (storage_needed);
2471                ...
2472              number_of_symbols =
2473                 bfd_canonicalize_symtab (abfd, symbol_table);
2474
2475              if (number_of_symbols < 0)
2476                FAIL
2477
2478              for (i = 0; i < number_of_symbols; i++)
2479                process_symbol (symbol_table[i]);
2480
2481   All storage for the symbols themselves is in an objalloc connected to
2482the BFD; it is freed when the BFD is closed.
2483
2484
2485File: bfd.info,  Node: Writing Symbols,  Next: Mini Symbols,  Prev: Reading Symbols,  Up: Symbols
2486
24872.7.2 Writing symbols
2488---------------------
2489
2490Writing of a symbol table is automatic when a BFD open for writing is
2491closed.  The application attaches a vector of pointers to pointers to
2492symbols to the BFD being written, and fills in the symbol count.  The
2493close and cleanup code reads through the table provided and performs all
2494the necessary operations.  The BFD output code must always be provided
2495with an "owned" symbol: one which has come from another BFD, or one
2496which has been created using 'bfd_make_empty_symbol'.  Here is an
2497example showing the creation of a symbol table with only one element:
2498
2499            #include "sysdep.h"
2500            #include "bfd.h"
2501            int main (void)
2502            {
2503              bfd *abfd;
2504              asymbol *ptrs[2];
2505              asymbol *new;
2506
2507              abfd = bfd_openw ("foo","a.out-sunos-big");
2508              bfd_set_format (abfd, bfd_object);
2509              new = bfd_make_empty_symbol (abfd);
2510              new->name = "dummy_symbol";
2511              new->section = bfd_make_section_old_way (abfd, ".text");
2512              new->flags = BSF_GLOBAL;
2513              new->value = 0x12345;
2514
2515              ptrs[0] = new;
2516              ptrs[1] = 0;
2517
2518              bfd_set_symtab (abfd, ptrs, 1);
2519              bfd_close (abfd);
2520              return 0;
2521            }
2522
2523            ./makesym
2524            nm foo
2525            00012345 A dummy_symbol
2526
2527   Many formats cannot represent arbitrary symbol information; for
2528instance, the 'a.out' object format does not allow an arbitrary number
2529of sections.  A symbol pointing to a section which is not one of
2530'.text', '.data' or '.bss' cannot be described.
2531
2532
2533File: bfd.info,  Node: Mini Symbols,  Next: typedef asymbol,  Prev: Writing Symbols,  Up: Symbols
2534
25352.7.3 Mini Symbols
2536------------------
2537
2538Mini symbols provide read-only access to the symbol table.  They use
2539less memory space, but require more time to access.  They can be useful
2540for tools like nm or objdump, which may have to handle symbol tables of
2541extremely large executables.
2542
2543   The 'bfd_read_minisymbols' function will read the symbols into memory
2544in an internal form.  It will return a 'void *' pointer to a block of
2545memory, a symbol count, and the size of each symbol.  The pointer is
2546allocated using 'malloc', and should be freed by the caller when it is
2547no longer needed.
2548
2549   The function 'bfd_minisymbol_to_symbol' will take a pointer to a
2550minisymbol, and a pointer to a structure returned by
2551'bfd_make_empty_symbol', and return a 'asymbol' structure.  The return
2552value may or may not be the same as the value from
2553'bfd_make_empty_symbol' which was passed in.
2554
2555
2556File: bfd.info,  Node: typedef asymbol,  Next: symbol handling functions,  Prev: Mini Symbols,  Up: Symbols
2557
25582.7.4 typedef asymbol
2559---------------------
2560
2561An 'asymbol' has the form:
2562
2563
2564     typedef struct bfd_symbol
2565     {
2566       /* A pointer to the BFD which owns the symbol. This information
2567          is necessary so that a back end can work out what additional
2568          information (invisible to the application writer) is carried
2569          with the symbol.
2570
2571          This field is *almost* redundant, since you can use section->owner
2572          instead, except that some symbols point to the global sections
2573          bfd_{abs,com,und}_section.  This could be fixed by making
2574          these globals be per-bfd (or per-target-flavor).  FIXME.  */
2575       struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
2576
2577       /* The text of the symbol. The name is left alone, and not copied; the
2578          application may not alter it.  */
2579       const char *name;
2580
2581       /* The value of the symbol.  This really should be a union of a
2582          numeric value with a pointer, since some flags indicate that
2583          a pointer to another symbol is stored here.  */
2584       symvalue value;
2585
2586       /* Attributes of a symbol.  */
2587     #define BSF_NO_FLAGS            0
2588
2589       /* The symbol has local scope; static in C. The value
2590          is the offset into the section of the data.  */
2591     #define BSF_LOCAL               (1 << 0)
2592
2593       /* The symbol has global scope; initialized data in C. The
2594          value is the offset into the section of the data.  */
2595     #define BSF_GLOBAL              (1 << 1)
2596
2597       /* The symbol has global scope and is exported. The value is
2598          the offset into the section of the data.  */
2599     #define BSF_EXPORT              BSF_GLOBAL /* No real difference.  */
2600
2601       /* A normal C symbol would be one of:
2602          BSF_LOCAL, BSF_UNDEFINED or BSF_GLOBAL.  */
2603
2604       /* The symbol is a debugging record. The value has an arbitrary
2605          meaning, unless BSF_DEBUGGING_RELOC is also set.  */
2606     #define BSF_DEBUGGING           (1 << 2)
2607
2608       /* The symbol denotes a function entry point.  Used in ELF,
2609          perhaps others someday.  */
2610     #define BSF_FUNCTION            (1 << 3)
2611
2612       /* Used by the linker.  */
2613     #define BSF_KEEP                (1 << 5)
2614
2615       /* An ELF common symbol.  */
2616     #define BSF_ELF_COMMON          (1 << 6)
2617
2618       /* A weak global symbol, overridable without warnings by
2619          a regular global symbol of the same name.  */
2620     #define BSF_WEAK                (1 << 7)
2621
2622       /* This symbol was created to point to a section, e.g. ELF's
2623          STT_SECTION symbols.  */
2624     #define BSF_SECTION_SYM         (1 << 8)
2625
2626       /* The symbol used to be a common symbol, but now it is
2627          allocated.  */
2628     #define BSF_OLD_COMMON          (1 << 9)
2629
2630       /* In some files the type of a symbol sometimes alters its
2631          location in an output file - ie in coff a ISFCN symbol
2632          which is also C_EXT symbol appears where it was
2633          declared and not at the end of a section.  This bit is set
2634          by the target BFD part to convey this information.  */
2635     #define BSF_NOT_AT_END          (1 << 10)
2636
2637       /* Signal that the symbol is the label of constructor section.  */
2638     #define BSF_CONSTRUCTOR         (1 << 11)
2639
2640       /* Signal that the symbol is a warning symbol.  The name is a
2641          warning.  The name of the next symbol is the one to warn about;
2642          if a reference is made to a symbol with the same name as the next
2643          symbol, a warning is issued by the linker.  */
2644     #define BSF_WARNING             (1 << 12)
2645
2646       /* Signal that the symbol is indirect.  This symbol is an indirect
2647          pointer to the symbol with the same name as the next symbol.  */
2648     #define BSF_INDIRECT            (1 << 13)
2649
2650       /* BSF_FILE marks symbols that contain a file name.  This is used
2651          for ELF STT_FILE symbols.  */
2652     #define BSF_FILE                (1 << 14)
2653
2654       /* Symbol is from dynamic linking information.  */
2655     #define BSF_DYNAMIC             (1 << 15)
2656
2657       /* The symbol denotes a data object.  Used in ELF, and perhaps
2658          others someday.  */
2659     #define BSF_OBJECT              (1 << 16)
2660
2661       /* This symbol is a debugging symbol.  The value is the offset
2662          into the section of the data.  BSF_DEBUGGING should be set
2663          as well.  */
2664     #define BSF_DEBUGGING_RELOC     (1 << 17)
2665
2666       /* This symbol is thread local.  Used in ELF.  */
2667     #define BSF_THREAD_LOCAL        (1 << 18)
2668
2669       /* This symbol represents a complex relocation expression,
2670          with the expression tree serialized in the symbol name.  */
2671     #define BSF_RELC                (1 << 19)
2672
2673       /* This symbol represents a signed complex relocation expression,
2674          with the expression tree serialized in the symbol name.  */
2675     #define BSF_SRELC               (1 << 20)
2676
2677       /* This symbol was created by bfd_get_synthetic_symtab.  */
2678     #define BSF_SYNTHETIC           (1 << 21)
2679
2680       /* This symbol is an indirect code object.  Unrelated to BSF_INDIRECT.
2681          The dynamic linker will compute the value of this symbol by
2682          calling the function that it points to.  BSF_FUNCTION must
2683          also be also set.  */
2684     #define BSF_GNU_INDIRECT_FUNCTION (1 << 22)
2685       /* This symbol is a globally unique data object.  The dynamic linker
2686          will make sure that in the entire process there is just one symbol
2687          with this name and type in use.  BSF_OBJECT must also be set.  */
2688     #define BSF_GNU_UNIQUE          (1 << 23)
2689
2690       flagword flags;
2691
2692       /* A pointer to the section to which this symbol is
2693          relative.  This will always be non NULL, there are special
2694          sections for undefined and absolute symbols.  */
2695       struct bfd_section *section;
2696
2697       /* Back end special data.  */
2698       union
2699         {
2700           void *p;
2701           bfd_vma i;
2702         }
2703       udata;
2704     }
2705     asymbol;
2706
2707
2708
2709File: bfd.info,  Node: symbol handling functions,  Prev: typedef asymbol,  Up: Symbols
2710
27112.7.5 Symbol handling functions
2712-------------------------------
2713
27142.7.5.1 'bfd_get_symtab_upper_bound'
2715....................................
2716
2717*Description*
2718Return the number of bytes required to store a vector of pointers to
2719'asymbols' for all the symbols in the BFD ABFD, including a terminal
2720NULL pointer.  If there are no symbols in the BFD, then return 0.  If an
2721error occurs, return -1.
2722     #define bfd_get_symtab_upper_bound(abfd) \
2723            BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2724
2725
27262.7.5.2 'bfd_is_local_label'
2727............................
2728
2729*Synopsis*
2730     bfd_boolean bfd_is_local_label (bfd *abfd, asymbol *sym);
2731   *Description*
2732Return TRUE if the given symbol SYM in the BFD ABFD is a compiler
2733generated local label, else return FALSE.
2734
27352.7.5.3 'bfd_is_local_label_name'
2736.................................
2737
2738*Synopsis*
2739     bfd_boolean bfd_is_local_label_name (bfd *abfd, const char *name);
2740   *Description*
2741Return TRUE if a symbol with the name NAME in the BFD ABFD is a compiler
2742generated local label, else return FALSE. This just checks whether the
2743name has the form of a local label.
2744     #define bfd_is_local_label_name(abfd, name) \
2745            BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2746
2747
27482.7.5.4 'bfd_is_target_special_symbol'
2749......................................
2750
2751*Synopsis*
2752     bfd_boolean bfd_is_target_special_symbol (bfd *abfd, asymbol *sym);
2753   *Description*
2754Return TRUE iff a symbol SYM in the BFD ABFD is something special to the
2755particular target represented by the BFD. Such symbols should normally
2756not be mentioned to the user.
2757     #define bfd_is_target_special_symbol(abfd, sym) \
2758            BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
2759
2760
27612.7.5.5 'bfd_canonicalize_symtab'
2762.................................
2763
2764*Description*
2765Read the symbols from the BFD ABFD, and fills in the vector LOCATION
2766with pointers to the symbols and a trailing NULL. Return the actual
2767number of symbol pointers, not including the NULL.
2768     #define bfd_canonicalize_symtab(abfd, location) \
2769            BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
2770
2771
27722.7.5.6 'bfd_set_symtab'
2773........................
2774
2775*Synopsis*
2776     bfd_boolean bfd_set_symtab
2777        (bfd *abfd, asymbol **location, unsigned int count);
2778   *Description*
2779Arrange that when the output BFD ABFD is closed, the table LOCATION of
2780COUNT pointers to symbols will be written.
2781
27822.7.5.7 'bfd_print_symbol_vandf'
2783................................
2784
2785*Synopsis*
2786     void bfd_print_symbol_vandf (bfd *abfd, void *file, asymbol *symbol);
2787   *Description*
2788Print the value and flags of the SYMBOL supplied to the stream FILE.
2789
27902.7.5.8 'bfd_make_empty_symbol'
2791...............................
2792
2793*Description*
2794Create a new 'asymbol' structure for the BFD ABFD and return a pointer
2795to it.
2796
2797   This routine is necessary because each back end has private
2798information surrounding the 'asymbol'.  Building your own 'asymbol' and
2799pointing to it will not create the private information, and will cause
2800problems later on.
2801     #define bfd_make_empty_symbol(abfd) \
2802            BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
2803
2804
28052.7.5.9 '_bfd_generic_make_empty_symbol'
2806........................................
2807
2808*Synopsis*
2809     asymbol *_bfd_generic_make_empty_symbol (bfd *);
2810   *Description*
2811Create a new 'asymbol' structure for the BFD ABFD and return a pointer
2812to it.  Used by core file routines, binary back-end and anywhere else
2813where no private info is needed.
2814
28152.7.5.10 'bfd_make_debug_symbol'
2816................................
2817
2818*Description*
2819Create a new 'asymbol' structure for the BFD ABFD, to be used as a
2820debugging symbol.  Further details of its use have yet to be worked out.
2821     #define bfd_make_debug_symbol(abfd,ptr,size) \
2822            BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
2823
2824
28252.7.5.11 'bfd_decode_symclass'
2826..............................
2827
2828*Description*
2829Return a character corresponding to the symbol class of SYMBOL, or '?'
2830for an unknown class.
2831
2832   *Synopsis*
2833     int bfd_decode_symclass (asymbol *symbol);
2834
28352.7.5.12 'bfd_is_undefined_symclass'
2836....................................
2837
2838*Description*
2839Returns non-zero if the class symbol returned by bfd_decode_symclass
2840represents an undefined symbol.  Returns zero otherwise.
2841
2842   *Synopsis*
2843     bfd_boolean bfd_is_undefined_symclass (int symclass);
2844
28452.7.5.13 'bfd_symbol_info'
2846..........................
2847
2848*Description*
2849Fill in the basic info about symbol that nm needs.  Additional info may
2850be added by the back-ends after calling this function.
2851
2852   *Synopsis*
2853     void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
2854
28552.7.5.14 'bfd_copy_private_symbol_data'
2856.......................................
2857
2858*Synopsis*
2859     bfd_boolean bfd_copy_private_symbol_data
2860        (bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym);
2861   *Description*
2862Copy private symbol information from ISYM in the BFD IBFD to the symbol
2863OSYM in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on error.
2864Possible error returns are:
2865
2866   * 'bfd_error_no_memory' - Not enough memory exists to create private
2867     data for OSEC.
2868     #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
2869            BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
2870                      (ibfd, isymbol, obfd, osymbol))
2871
2872
2873
2874File: bfd.info,  Node: Archives,  Next: Formats,  Prev: Symbols,  Up: BFD front end
2875
28762.8 Archives
2877============
2878
2879*Description*
2880An archive (or library) is just another BFD. It has a symbol table,
2881although there's not much a user program will do with it.
2882
2883   The big difference between an archive BFD and an ordinary BFD is that
2884the archive doesn't have sections.  Instead it has a chain of BFDs that
2885are considered its contents.  These BFDs can be manipulated like any
2886other.  The BFDs contained in an archive opened for reading will all be
2887opened for reading.  You may put either input or output BFDs into an
2888archive opened for output; they will be handled correctly when the
2889archive is closed.
2890
2891   Use 'bfd_openr_next_archived_file' to step through the contents of an
2892archive opened for input.  You don't have to read the entire archive if
2893you don't want to!  Read it until you find what you want.
2894
2895   A BFD returned by 'bfd_openr_next_archived_file' can be closed
2896manually with 'bfd_close'.  If you do not close it, then a second
2897iteration through the members of an archive may return the same BFD. If
2898you close the archive BFD, then all the member BFDs will automatically
2899be closed as well.
2900
2901   Archive contents of output BFDs are chained through the
2902'archive_next' pointer in a BFD. The first one is findable through the
2903'archive_head' slot of the archive.  Set it with 'bfd_set_archive_head'
2904(q.v.).  A given BFD may be in only one open output archive at a time.
2905
2906   As expected, the BFD archive code is more general than the archive
2907code of any given environment.  BFD archives may contain files of
2908different formats (e.g., a.out and coff) and even different
2909architectures.  You may even place archives recursively into archives!
2910
2911   This can cause unexpected confusion, since some archive formats are
2912more expressive than others.  For instance, Intel COFF archives can
2913preserve long filenames; SunOS a.out archives cannot.  If you move a
2914file from the first to the second format and back again, the filename
2915may be truncated.  Likewise, different a.out environments have different
2916conventions as to how they truncate filenames, whether they preserve
2917directory names in filenames, etc.  When interoperating with native
2918tools, be sure your files are homogeneous.
2919
2920   Beware: most of these formats do not react well to the presence of
2921spaces in filenames.  We do the best we can, but can't always handle
2922this case due to restrictions in the format of archives.  Many Unix
2923utilities are braindead in regards to spaces and such in filenames
2924anyway, so this shouldn't be much of a restriction.
2925
2926   Archives are supported in BFD in 'archive.c'.
2927
29282.8.1 Archive functions
2929-----------------------
2930
29312.8.1.1 'bfd_get_next_mapent'
2932.............................
2933
2934*Synopsis*
2935     symindex bfd_get_next_mapent
2936        (bfd *abfd, symindex previous, carsym **sym);
2937   *Description*
2938Step through archive ABFD's symbol table (if it has one).  Successively
2939update SYM with the next symbol's information, returning that symbol's
2940(internal) index into the symbol table.
2941
2942   Supply 'BFD_NO_MORE_SYMBOLS' as the PREVIOUS entry to get the first
2943one; returns 'BFD_NO_MORE_SYMBOLS' when you've already got the last one.
2944
2945   A 'carsym' is a canonical archive symbol.  The only user-visible
2946element is its name, a null-terminated string.
2947
29482.8.1.2 'bfd_set_archive_head'
2949..............................
2950
2951*Synopsis*
2952     bfd_boolean bfd_set_archive_head (bfd *output, bfd *new_head);
2953   *Description*
2954Set the head of the chain of BFDs contained in the archive OUTPUT to
2955NEW_HEAD.
2956
29572.8.1.3 'bfd_openr_next_archived_file'
2958......................................
2959
2960*Synopsis*
2961     bfd *bfd_openr_next_archived_file (bfd *archive, bfd *previous);
2962   *Description*
2963Provided a BFD, ARCHIVE, containing an archive and NULL, open an input
2964BFD on the first contained element and returns that.  Subsequent calls
2965should pass the archive and the previous return value to return a
2966created BFD to the next contained element.  NULL is returned when there
2967are no more.  Note - if you want to process the bfd returned by this
2968call be sure to call bfd_check_format() on it first.
2969
2970
2971File: bfd.info,  Node: Formats,  Next: Relocations,  Prev: Archives,  Up: BFD front end
2972
29732.9 File formats
2974================
2975
2976A format is a BFD concept of high level file contents type.  The formats
2977supported by BFD are:
2978
2979   * 'bfd_object'
2980   The BFD may contain data, symbols, relocations and debug info.
2981
2982   * 'bfd_archive'
2983   The BFD contains other BFDs and an optional index.
2984
2985   * 'bfd_core'
2986   The BFD contains the result of an executable core dump.
2987
29882.9.1 File format functions
2989---------------------------
2990
29912.9.1.1 'bfd_check_format'
2992..........................
2993
2994*Synopsis*
2995     bfd_boolean bfd_check_format (bfd *abfd, bfd_format format);
2996   *Description*
2997Verify if the file attached to the BFD ABFD is compatible with the
2998format FORMAT (i.e., one of 'bfd_object', 'bfd_archive' or 'bfd_core').
2999
3000   If the BFD has been set to a specific target before the call, only
3001the named target and format combination is checked.  If the target has
3002not been set, or has been set to 'default', then all the known target
3003backends is interrogated to determine a match.  If the default target
3004matches, it is used.  If not, exactly one target must recognize the
3005file, or an error results.
3006
3007   The function returns 'TRUE' on success, otherwise 'FALSE' with one of
3008the following error codes:
3009
3010   * 'bfd_error_invalid_operation' - if 'format' is not one of
3011     'bfd_object', 'bfd_archive' or 'bfd_core'.
3012
3013   * 'bfd_error_system_call' - if an error occured during a read - even
3014     some file mismatches can cause bfd_error_system_calls.
3015
3016   * 'file_not_recognised' - none of the backends recognised the file
3017     format.
3018
3019   * 'bfd_error_file_ambiguously_recognized' - more than one backend
3020     recognised the file format.
3021
30222.9.1.2 'bfd_check_format_matches'
3023..................................
3024
3025*Synopsis*
3026     bfd_boolean bfd_check_format_matches
3027        (bfd *abfd, bfd_format format, char ***matching);
3028   *Description*
3029Like 'bfd_check_format', except when it returns FALSE with 'bfd_errno'
3030set to 'bfd_error_file_ambiguously_recognized'.  In that case, if
3031MATCHING is not NULL, it will be filled in with a NULL-terminated list
3032of the names of the formats that matched, allocated with 'malloc'.  Then
3033the user may choose a format and try again.
3034
3035   When done with the list that MATCHING points to, the caller should
3036free it.
3037
30382.9.1.3 'bfd_set_format'
3039........................
3040
3041*Synopsis*
3042     bfd_boolean bfd_set_format (bfd *abfd, bfd_format format);
3043   *Description*
3044This function sets the file format of the BFD ABFD to the format FORMAT.
3045If the target set in the BFD does not support the format requested, the
3046format is invalid, or the BFD is not open for writing, then an error
3047occurs.
3048
30492.9.1.4 'bfd_format_string'
3050...........................
3051
3052*Synopsis*
3053     const char *bfd_format_string (bfd_format format);
3054   *Description*
3055Return a pointer to a const string 'invalid', 'object', 'archive',
3056'core', or 'unknown', depending upon the value of FORMAT.
3057
3058
3059File: bfd.info,  Node: Relocations,  Next: Core Files,  Prev: Formats,  Up: BFD front end
3060
30612.10 Relocations
3062================
3063
3064BFD maintains relocations in much the same way it maintains symbols:
3065they are left alone until required, then read in en-masse and translated
3066into an internal form.  A common routine 'bfd_perform_relocation' acts
3067upon the canonical form to do the fixup.
3068
3069   Relocations are maintained on a per section basis, while symbols are
3070maintained on a per BFD basis.
3071
3072   All that a back end has to do to fit the BFD interface is to create a
3073'struct reloc_cache_entry' for each relocation in a particular section,
3074and fill in the right bits of the structures.
3075
3076* Menu:
3077
3078* typedef arelent::
3079* howto manager::
3080
3081
3082File: bfd.info,  Node: typedef arelent,  Next: howto manager,  Prev: Relocations,  Up: Relocations
3083
30842.10.1 typedef arelent
3085----------------------
3086
3087This is the structure of a relocation entry:
3088
3089
3090     typedef enum bfd_reloc_status
3091     {
3092       /* No errors detected.  Note - the value 2 is used so that it
3093          will not be mistaken for the boolean TRUE or FALSE values.  */
3094       bfd_reloc_ok = 2,
3095
3096       /* The relocation was performed, but there was an overflow.  */
3097       bfd_reloc_overflow,
3098
3099       /* The address to relocate was not within the section supplied.  */
3100       bfd_reloc_outofrange,
3101
3102       /* Used by special functions.  */
3103       bfd_reloc_continue,
3104
3105       /* Unsupported relocation size requested.  */
3106       bfd_reloc_notsupported,
3107
3108       /* Unused.  */
3109       bfd_reloc_other,
3110
3111       /* The symbol to relocate against was undefined.  */
3112       bfd_reloc_undefined,
3113
3114       /* The relocation was performed, but may not be ok - presently
3115          generated only when linking i960 coff files with i960 b.out
3116          symbols.  If this type is returned, the error_message argument
3117          to bfd_perform_relocation will be set.  */
3118       bfd_reloc_dangerous
3119      }
3120      bfd_reloc_status_type;
3121
3122
3123     typedef struct reloc_cache_entry
3124     {
3125       /* A pointer into the canonical table of pointers.  */
3126       struct bfd_symbol **sym_ptr_ptr;
3127
3128       /* offset in section.  */
3129       bfd_size_type address;
3130
3131       /* addend for relocation value.  */
3132       bfd_vma addend;
3133
3134       /* Pointer to how to perform the required relocation.  */
3135       reloc_howto_type *howto;
3136
3137     }
3138     arelent;
3139
3140   *Description*
3141Here is a description of each of the fields within an 'arelent':
3142
3143   * 'sym_ptr_ptr'
3144   The symbol table pointer points to a pointer to the symbol associated
3145with the relocation request.  It is the pointer into the table returned
3146by the back end's 'canonicalize_symtab' action.  *Note Symbols::.  The
3147symbol is referenced through a pointer to a pointer so that tools like
3148the linker can fix up all the symbols of the same name by modifying only
3149one pointer.  The relocation routine looks in the symbol and uses the
3150base of the section the symbol is attached to and the value of the
3151symbol as the initial relocation offset.  If the symbol pointer is zero,
3152then the section provided is looked up.
3153
3154   * 'address'
3155   The 'address' field gives the offset in bytes from the base of the
3156section data which owns the relocation record to the first byte of
3157relocatable information.  The actual data relocated will be relative to
3158this point; for example, a relocation type which modifies the bottom two
3159bytes of a four byte word would not touch the first byte pointed to in a
3160big endian world.
3161
3162   * 'addend'
3163   The 'addend' is a value provided by the back end to be added (!)  to
3164the relocation offset.  Its interpretation is dependent upon the howto.
3165For example, on the 68k the code:
3166
3167             char foo[];
3168             main()
3169                     {
3170                     return foo[0x12345678];
3171                     }
3172
3173   Could be compiled into:
3174
3175             linkw fp,#-4
3176             moveb @#12345678,d0
3177             extbl d0
3178             unlk fp
3179             rts
3180
3181   This could create a reloc pointing to 'foo', but leave the offset in
3182the data, something like:
3183
3184     RELOCATION RECORDS FOR [.text]:
3185     offset   type      value
3186     00000006 32        _foo
3187
3188     00000000 4e56 fffc          ; linkw fp,#-4
3189     00000004 1039 1234 5678     ; moveb @#12345678,d0
3190     0000000a 49c0               ; extbl d0
3191     0000000c 4e5e               ; unlk fp
3192     0000000e 4e75               ; rts
3193
3194   Using coff and an 88k, some instructions don't have enough space in
3195them to represent the full address range, and pointers have to be loaded
3196in two parts.  So you'd get something like:
3197
3198             or.u     r13,r0,hi16(_foo+0x12345678)
3199             ld.b     r2,r13,lo16(_foo+0x12345678)
3200             jmp      r1
3201
3202   This should create two relocs, both pointing to '_foo', and with
32030x12340000 in their addend field.  The data would consist of:
3204
3205     RELOCATION RECORDS FOR [.text]:
3206     offset   type      value
3207     00000002 HVRT16    _foo+0x12340000
3208     00000006 LVRT16    _foo+0x12340000
3209
3210     00000000 5da05678           ; or.u r13,r0,0x5678
3211     00000004 1c4d5678           ; ld.b r2,r13,0x5678
3212     00000008 f400c001           ; jmp r1
3213
3214   The relocation routine digs out the value from the data, adds it to
3215the addend to get the original offset, and then adds the value of
3216'_foo'.  Note that all 32 bits have to be kept around somewhere, to cope
3217with carry from bit 15 to bit 16.
3218
3219   One further example is the sparc and the a.out format.  The sparc has
3220a similar problem to the 88k, in that some instructions don't have room
3221for an entire offset, but on the sparc the parts are created in odd
3222sized lumps.  The designers of the a.out format chose to not use the
3223data within the section for storing part of the offset; all the offset
3224is kept within the reloc.  Anything in the data should be ignored.
3225
3226             save %sp,-112,%sp
3227             sethi %hi(_foo+0x12345678),%g2
3228             ldsb [%g2+%lo(_foo+0x12345678)],%i0
3229             ret
3230             restore
3231
3232   Both relocs contain a pointer to 'foo', and the offsets contain junk.
3233
3234     RELOCATION RECORDS FOR [.text]:
3235     offset   type      value
3236     00000004 HI22      _foo+0x12345678
3237     00000008 LO10      _foo+0x12345678
3238
3239     00000000 9de3bf90     ; save %sp,-112,%sp
3240     00000004 05000000     ; sethi %hi(_foo+0),%g2
3241     00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
3242     0000000c 81c7e008     ; ret
3243     00000010 81e80000     ; restore
3244
3245   * 'howto'
3246   The 'howto' field can be imagined as a relocation instruction.  It is
3247a pointer to a structure which contains information on what to do with
3248all of the other information in the reloc record and data section.  A
3249back end would normally have a relocation instruction set and turn
3250relocations into pointers to the correct structure on input - but it
3251would be possible to create each howto field on demand.
3252
32532.10.1.1 'enum complain_overflow'
3254.................................
3255
3256Indicates what sort of overflow checking should be done when performing
3257a relocation.
3258
3259
3260     enum complain_overflow
3261     {
3262       /* Do not complain on overflow.  */
3263       complain_overflow_dont,
3264
3265       /* Complain if the value overflows when considered as a signed
3266          number one bit larger than the field.  ie. A bitfield of N bits
3267          is allowed to represent -2**n to 2**n-1.  */
3268       complain_overflow_bitfield,
3269
3270       /* Complain if the value overflows when considered as a signed
3271          number.  */
3272       complain_overflow_signed,
3273
3274       /* Complain if the value overflows when considered as an
3275          unsigned number.  */
3276       complain_overflow_unsigned
3277     };
3278
32792.10.1.2 'reloc_howto_type'
3280...........................
3281
3282The 'reloc_howto_type' is a structure which contains all the information
3283that libbfd needs to know to tie up a back end's data.
3284
3285     struct bfd_symbol;             /* Forward declaration.  */
3286
3287     struct reloc_howto_struct
3288     {
3289       /*  The type field has mainly a documentary use - the back end can
3290           do what it wants with it, though normally the back end's
3291           external idea of what a reloc number is stored
3292           in this field.  For example, a PC relative word relocation
3293           in a coff environment has the type 023 - because that's
3294           what the outside world calls a R_PCRWORD reloc.  */
3295       unsigned int type;
3296
3297       /*  The value the final relocation is shifted right by.  This drops
3298           unwanted data from the relocation.  */
3299       unsigned int rightshift;
3300
3301       /*  The size of the item to be relocated.  This is *not* a
3302           power-of-two measure.  To get the number of bytes operated
3303           on by a type of relocation, use bfd_get_reloc_size.  */
3304       int size;
3305
3306       /*  The number of bits in the item to be relocated.  This is used
3307           when doing overflow checking.  */
3308       unsigned int bitsize;
3309
3310       /*  The relocation is relative to the field being relocated.  */
3311       bfd_boolean pc_relative;
3312
3313       /*  The bit position of the reloc value in the destination.
3314           The relocated value is left shifted by this amount.  */
3315       unsigned int bitpos;
3316
3317       /* What type of overflow error should be checked for when
3318          relocating.  */
3319       enum complain_overflow complain_on_overflow;
3320
3321       /* If this field is non null, then the supplied function is
3322          called rather than the normal function.  This allows really
3323          strange relocation methods to be accommodated (e.g., i960 callj
3324          instructions).  */
3325       bfd_reloc_status_type (*special_function)
3326         (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
3327          bfd *, char **);
3328
3329       /* The textual name of the relocation type.  */
3330       char *name;
3331
3332       /* Some formats record a relocation addend in the section contents
3333          rather than with the relocation.  For ELF formats this is the
3334          distinction between USE_REL and USE_RELA (though the code checks
3335          for USE_REL == 1/0).  The value of this field is TRUE if the
3336          addend is recorded with the section contents; when performing a
3337          partial link (ld -r) the section contents (the data) will be
3338          modified.  The value of this field is FALSE if addends are
3339          recorded with the relocation (in arelent.addend); when performing
3340          a partial link the relocation will be modified.
3341          All relocations for all ELF USE_RELA targets should set this field
3342          to FALSE (values of TRUE should be looked on with suspicion).
3343          However, the converse is not true: not all relocations of all ELF
3344          USE_REL targets set this field to TRUE.  Why this is so is peculiar
3345          to each particular target.  For relocs that aren't used in partial
3346          links (e.g. GOT stuff) it doesn't matter what this is set to.  */
3347       bfd_boolean partial_inplace;
3348
3349       /* src_mask selects the part of the instruction (or data) to be used
3350          in the relocation sum.  If the target relocations don't have an
3351          addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
3352          dst_mask to extract the addend from the section contents.  If
3353          relocations do have an addend in the reloc, eg. ELF USE_RELA, this
3354          field should be zero.  Non-zero values for ELF USE_RELA targets are
3355          bogus as in those cases the value in the dst_mask part of the
3356          section contents should be treated as garbage.  */
3357       bfd_vma src_mask;
3358
3359       /* dst_mask selects which parts of the instruction (or data) are
3360          replaced with a relocated value.  */
3361       bfd_vma dst_mask;
3362
3363       /* When some formats create PC relative instructions, they leave
3364          the value of the pc of the place being relocated in the offset
3365          slot of the instruction, so that a PC relative relocation can
3366          be made just by adding in an ordinary offset (e.g., sun3 a.out).
3367          Some formats leave the displacement part of an instruction
3368          empty (e.g., m88k bcs); this flag signals the fact.  */
3369       bfd_boolean pcrel_offset;
3370     };
3371
3372
33732.10.1.3 'The HOWTO Macro'
3374..........................
3375
3376*Description*
3377The HOWTO define is horrible and will go away.
3378     #define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
3379       { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
3380
3381   *Description*
3382And will be replaced with the totally magic way.  But for the moment, we
3383are compatible, so do it this way.
3384     #define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
3385       HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
3386              NAME, FALSE, 0, 0, IN)
3387
3388
3389   *Description*
3390This is used to fill in an empty howto entry in an array.
3391     #define EMPTY_HOWTO(C) \
3392       HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
3393              NULL, FALSE, 0, 0, FALSE)
3394
3395
3396   *Description*
3397Helper routine to turn a symbol into a relocation value.
3398     #define HOWTO_PREPARE(relocation, symbol)              \
3399       {                                                    \
3400         if (symbol != NULL)                                \
3401           {                                                \
3402             if (bfd_is_com_section (symbol->section))      \
3403               {                                            \
3404                 relocation = 0;                            \
3405               }                                            \
3406             else                                           \
3407               {                                            \
3408                 relocation = symbol->value;                \
3409               }                                            \
3410           }                                                \
3411       }
3412
3413
34142.10.1.4 'bfd_get_reloc_size'
3415.............................
3416
3417*Synopsis*
3418     unsigned int bfd_get_reloc_size (reloc_howto_type *);
3419   *Description*
3420For a reloc_howto_type that operates on a fixed number of bytes, this
3421returns the number of bytes operated on.
3422
34232.10.1.5 'arelent_chain'
3424........................
3425
3426*Description*
3427How relocs are tied together in an 'asection':
3428     typedef struct relent_chain
3429     {
3430       arelent relent;
3431       struct relent_chain *next;
3432     }
3433     arelent_chain;
3434
3435
34362.10.1.6 'bfd_check_overflow'
3437.............................
3438
3439*Synopsis*
3440     bfd_reloc_status_type bfd_check_overflow
3441        (enum complain_overflow how,
3442         unsigned int bitsize,
3443         unsigned int rightshift,
3444         unsigned int addrsize,
3445         bfd_vma relocation);
3446   *Description*
3447Perform overflow checking on RELOCATION which has BITSIZE significant
3448bits and will be shifted right by RIGHTSHIFT bits, on a machine with
3449addresses containing ADDRSIZE significant bits.  The result is either of
3450'bfd_reloc_ok' or 'bfd_reloc_overflow'.
3451
34522.10.1.7 'bfd_reloc_offset_in_range'
3453....................................
3454
3455*Synopsis*
3456     bfd_boolean bfd_reloc_offset_in_range
3457        (reloc_howto_type *howto,
3458         bfd *abfd,
3459         asection *section,
3460         bfd_size_type offset);
3461   *Description*
3462Returns TRUE if the reloc described by HOWTO can be applied at OFFSET
3463octets in SECTION.
3464
34652.10.1.8 'bfd_perform_relocation'
3466.................................
3467
3468*Synopsis*
3469     bfd_reloc_status_type bfd_perform_relocation
3470        (bfd *abfd,
3471         arelent *reloc_entry,
3472         void *data,
3473         asection *input_section,
3474         bfd *output_bfd,
3475         char **error_message);
3476   *Description*
3477If OUTPUT_BFD is supplied to this function, the generated image will be
3478relocatable; the relocations are copied to the output file after they
3479have been changed to reflect the new state of the world.  There are two
3480ways of reflecting the results of partial linkage in an output file: by
3481modifying the output data in place, and by modifying the relocation
3482record.  Some native formats (e.g., basic a.out and basic coff) have no
3483way of specifying an addend in the relocation type, so the addend has to
3484go in the output data.  This is no big deal since in these formats the
3485output data slot will always be big enough for the addend.  Complex
3486reloc types with addends were invented to solve just this problem.  The
3487ERROR_MESSAGE argument is set to an error message if this return
3488'bfd_reloc_dangerous'.
3489
34902.10.1.9 'bfd_install_relocation'
3491.................................
3492
3493*Synopsis*
3494     bfd_reloc_status_type bfd_install_relocation
3495        (bfd *abfd,
3496         arelent *reloc_entry,
3497         void *data, bfd_vma data_start,
3498         asection *input_section,
3499         char **error_message);
3500   *Description*
3501This looks remarkably like 'bfd_perform_relocation', except it does not
3502expect that the section contents have been filled in.  I.e., it's
3503suitable for use when creating, rather than applying a relocation.
3504
3505   For now, this function should be considered reserved for the
3506assembler.
3507
3508
3509File: bfd.info,  Node: howto manager,  Prev: typedef arelent,  Up: Relocations
3510
35112.10.2 The howto manager
3512------------------------
3513
3514When an application wants to create a relocation, but doesn't know what
3515the target machine might call it, it can find out by using this bit of
3516code.
3517
35182.10.2.1 'bfd_reloc_code_type'
3519..............................
3520
3521*Description*
3522The insides of a reloc code.  The idea is that, eventually, there will
3523be one enumerator for every type of relocation we ever do.  Pass one of
3524these values to 'bfd_reloc_type_lookup', and it'll return a howto
3525pointer.
3526
3527   This does mean that the application must determine the correct
3528enumerator value; you can't get a howto pointer from a random set of
3529attributes.
3530
3531   Here are the possible values for 'enum bfd_reloc_code_real':
3532
3533 -- : BFD_RELOC_64
3534 -- : BFD_RELOC_32
3535 -- : BFD_RELOC_26
3536 -- : BFD_RELOC_24
3537 -- : BFD_RELOC_16
3538 -- : BFD_RELOC_14
3539 -- : BFD_RELOC_8
3540     Basic absolute relocations of N bits.
3541 -- : BFD_RELOC_64_PCREL
3542 -- : BFD_RELOC_32_PCREL
3543 -- : BFD_RELOC_24_PCREL
3544 -- : BFD_RELOC_16_PCREL
3545 -- : BFD_RELOC_12_PCREL
3546 -- : BFD_RELOC_8_PCREL
3547     PC-relative relocations.  Sometimes these are relative to the
3548     address of the relocation itself; sometimes they are relative to
3549     the start of the section containing the relocation.  It depends on
3550     the specific target.
3551
3552     The 24-bit relocation is used in some Intel 960 configurations.
3553 -- : BFD_RELOC_32_SECREL
3554     Section relative relocations.  Some targets need this for DWARF2.
3555 -- : BFD_RELOC_32_GOT_PCREL
3556 -- : BFD_RELOC_16_GOT_PCREL
3557 -- : BFD_RELOC_8_GOT_PCREL
3558 -- : BFD_RELOC_32_GOTOFF
3559 -- : BFD_RELOC_16_GOTOFF
3560 -- : BFD_RELOC_LO16_GOTOFF
3561 -- : BFD_RELOC_HI16_GOTOFF
3562 -- : BFD_RELOC_HI16_S_GOTOFF
3563 -- : BFD_RELOC_8_GOTOFF
3564 -- : BFD_RELOC_64_PLT_PCREL
3565 -- : BFD_RELOC_32_PLT_PCREL
3566 -- : BFD_RELOC_24_PLT_PCREL
3567 -- : BFD_RELOC_16_PLT_PCREL
3568 -- : BFD_RELOC_8_PLT_PCREL
3569 -- : BFD_RELOC_64_PLTOFF
3570 -- : BFD_RELOC_32_PLTOFF
3571 -- : BFD_RELOC_16_PLTOFF
3572 -- : BFD_RELOC_LO16_PLTOFF
3573 -- : BFD_RELOC_HI16_PLTOFF
3574 -- : BFD_RELOC_HI16_S_PLTOFF
3575 -- : BFD_RELOC_8_PLTOFF
3576     For ELF.
3577 -- : BFD_RELOC_SIZE32
3578 -- : BFD_RELOC_SIZE64
3579     Size relocations.
3580 -- : BFD_RELOC_68K_GLOB_DAT
3581 -- : BFD_RELOC_68K_JMP_SLOT
3582 -- : BFD_RELOC_68K_RELATIVE
3583 -- : BFD_RELOC_68K_TLS_GD32
3584 -- : BFD_RELOC_68K_TLS_GD16
3585 -- : BFD_RELOC_68K_TLS_GD8
3586 -- : BFD_RELOC_68K_TLS_LDM32
3587 -- : BFD_RELOC_68K_TLS_LDM16
3588 -- : BFD_RELOC_68K_TLS_LDM8
3589 -- : BFD_RELOC_68K_TLS_LDO32
3590 -- : BFD_RELOC_68K_TLS_LDO16
3591 -- : BFD_RELOC_68K_TLS_LDO8
3592 -- : BFD_RELOC_68K_TLS_IE32
3593 -- : BFD_RELOC_68K_TLS_IE16
3594 -- : BFD_RELOC_68K_TLS_IE8
3595 -- : BFD_RELOC_68K_TLS_LE32
3596 -- : BFD_RELOC_68K_TLS_LE16
3597 -- : BFD_RELOC_68K_TLS_LE8
3598     Relocations used by 68K ELF.
3599 -- : BFD_RELOC_32_BASEREL
3600 -- : BFD_RELOC_16_BASEREL
3601 -- : BFD_RELOC_LO16_BASEREL
3602 -- : BFD_RELOC_HI16_BASEREL
3603 -- : BFD_RELOC_HI16_S_BASEREL
3604 -- : BFD_RELOC_8_BASEREL
3605 -- : BFD_RELOC_RVA
3606     Linkage-table relative.
3607 -- : BFD_RELOC_8_FFnn
3608     Absolute 8-bit relocation, but used to form an address like 0xFFnn.
3609 -- : BFD_RELOC_32_PCREL_S2
3610 -- : BFD_RELOC_16_PCREL_S2
3611 -- : BFD_RELOC_23_PCREL_S2
3612     These PC-relative relocations are stored as word displacements -
3613     i.e., byte displacements shifted right two bits.  The 30-bit word
3614     displacement (<<32_PCREL_S2>> - 32 bits, shifted 2) is used on the
3615     SPARC. (SPARC tools generally refer to this as <<WDISP30>>.)  The
3616     signed 16-bit displacement is used on the MIPS, and the 23-bit
3617     displacement is used on the Alpha.
3618 -- : BFD_RELOC_HI22
3619 -- : BFD_RELOC_LO10
3620     High 22 bits and low 10 bits of 32-bit value, placed into lower
3621     bits of the target word.  These are used on the SPARC.
3622 -- : BFD_RELOC_GPREL16
3623 -- : BFD_RELOC_GPREL32
3624     For systems that allocate a Global Pointer register, these are
3625     displacements off that register.  These relocation types are
3626     handled specially, because the value the register will have is
3627     decided relatively late.
3628 -- : BFD_RELOC_I960_CALLJ
3629     Reloc types used for i960/b.out.
3630 -- : BFD_RELOC_NONE
3631 -- : BFD_RELOC_SPARC_WDISP22
3632 -- : BFD_RELOC_SPARC22
3633 -- : BFD_RELOC_SPARC13
3634 -- : BFD_RELOC_SPARC_GOT10
3635 -- : BFD_RELOC_SPARC_GOT13
3636 -- : BFD_RELOC_SPARC_GOT22
3637 -- : BFD_RELOC_SPARC_PC10
3638 -- : BFD_RELOC_SPARC_PC22
3639 -- : BFD_RELOC_SPARC_WPLT30
3640 -- : BFD_RELOC_SPARC_COPY
3641 -- : BFD_RELOC_SPARC_GLOB_DAT
3642 -- : BFD_RELOC_SPARC_JMP_SLOT
3643 -- : BFD_RELOC_SPARC_RELATIVE
3644 -- : BFD_RELOC_SPARC_UA16
3645 -- : BFD_RELOC_SPARC_UA32
3646 -- : BFD_RELOC_SPARC_UA64
3647 -- : BFD_RELOC_SPARC_GOTDATA_HIX22
3648 -- : BFD_RELOC_SPARC_GOTDATA_LOX10
3649 -- : BFD_RELOC_SPARC_GOTDATA_OP_HIX22
3650 -- : BFD_RELOC_SPARC_GOTDATA_OP_LOX10
3651 -- : BFD_RELOC_SPARC_GOTDATA_OP
3652 -- : BFD_RELOC_SPARC_JMP_IREL
3653 -- : BFD_RELOC_SPARC_IRELATIVE
3654     SPARC ELF relocations.  There is probably some overlap with other
3655     relocation types already defined.
3656 -- : BFD_RELOC_SPARC_BASE13
3657 -- : BFD_RELOC_SPARC_BASE22
3658     I think these are specific to SPARC a.out (e.g., Sun 4).
3659 -- : BFD_RELOC_SPARC_64
3660 -- : BFD_RELOC_SPARC_10
3661 -- : BFD_RELOC_SPARC_11
3662 -- : BFD_RELOC_SPARC_OLO10
3663 -- : BFD_RELOC_SPARC_HH22
3664 -- : BFD_RELOC_SPARC_HM10
3665 -- : BFD_RELOC_SPARC_LM22
3666 -- : BFD_RELOC_SPARC_PC_HH22
3667 -- : BFD_RELOC_SPARC_PC_HM10
3668 -- : BFD_RELOC_SPARC_PC_LM22
3669 -- : BFD_RELOC_SPARC_WDISP16
3670 -- : BFD_RELOC_SPARC_WDISP19
3671 -- : BFD_RELOC_SPARC_7
3672 -- : BFD_RELOC_SPARC_6
3673 -- : BFD_RELOC_SPARC_5
3674 -- : BFD_RELOC_SPARC_DISP64
3675 -- : BFD_RELOC_SPARC_PLT32
3676 -- : BFD_RELOC_SPARC_PLT64
3677 -- : BFD_RELOC_SPARC_HIX22
3678 -- : BFD_RELOC_SPARC_LOX10
3679 -- : BFD_RELOC_SPARC_H44
3680 -- : BFD_RELOC_SPARC_M44
3681 -- : BFD_RELOC_SPARC_L44
3682 -- : BFD_RELOC_SPARC_REGISTER
3683 -- : BFD_RELOC_SPARC_H34
3684 -- : BFD_RELOC_SPARC_SIZE32
3685 -- : BFD_RELOC_SPARC_SIZE64
3686 -- : BFD_RELOC_SPARC_WDISP10
3687     SPARC64 relocations
3688 -- : BFD_RELOC_SPARC_REV32
3689     SPARC little endian relocation
3690 -- : BFD_RELOC_SPARC_TLS_GD_HI22
3691 -- : BFD_RELOC_SPARC_TLS_GD_LO10
3692 -- : BFD_RELOC_SPARC_TLS_GD_ADD
3693 -- : BFD_RELOC_SPARC_TLS_GD_CALL
3694 -- : BFD_RELOC_SPARC_TLS_LDM_HI22
3695 -- : BFD_RELOC_SPARC_TLS_LDM_LO10
3696 -- : BFD_RELOC_SPARC_TLS_LDM_ADD
3697 -- : BFD_RELOC_SPARC_TLS_LDM_CALL
3698 -- : BFD_RELOC_SPARC_TLS_LDO_HIX22
3699 -- : BFD_RELOC_SPARC_TLS_LDO_LOX10
3700 -- : BFD_RELOC_SPARC_TLS_LDO_ADD
3701 -- : BFD_RELOC_SPARC_TLS_IE_HI22
3702 -- : BFD_RELOC_SPARC_TLS_IE_LO10
3703 -- : BFD_RELOC_SPARC_TLS_IE_LD
3704 -- : BFD_RELOC_SPARC_TLS_IE_LDX
3705 -- : BFD_RELOC_SPARC_TLS_IE_ADD
3706 -- : BFD_RELOC_SPARC_TLS_LE_HIX22
3707 -- : BFD_RELOC_SPARC_TLS_LE_LOX10
3708 -- : BFD_RELOC_SPARC_TLS_DTPMOD32
3709 -- : BFD_RELOC_SPARC_TLS_DTPMOD64
3710 -- : BFD_RELOC_SPARC_TLS_DTPOFF32
3711 -- : BFD_RELOC_SPARC_TLS_DTPOFF64
3712 -- : BFD_RELOC_SPARC_TLS_TPOFF32
3713 -- : BFD_RELOC_SPARC_TLS_TPOFF64
3714     SPARC TLS relocations
3715 -- : BFD_RELOC_SPU_IMM7
3716 -- : BFD_RELOC_SPU_IMM8
3717 -- : BFD_RELOC_SPU_IMM10
3718 -- : BFD_RELOC_SPU_IMM10W
3719 -- : BFD_RELOC_SPU_IMM16
3720 -- : BFD_RELOC_SPU_IMM16W
3721 -- : BFD_RELOC_SPU_IMM18
3722 -- : BFD_RELOC_SPU_PCREL9a
3723 -- : BFD_RELOC_SPU_PCREL9b
3724 -- : BFD_RELOC_SPU_PCREL16
3725 -- : BFD_RELOC_SPU_LO16
3726 -- : BFD_RELOC_SPU_HI16
3727 -- : BFD_RELOC_SPU_PPU32
3728 -- : BFD_RELOC_SPU_PPU64
3729 -- : BFD_RELOC_SPU_ADD_PIC
3730     SPU Relocations.
3731 -- : BFD_RELOC_ALPHA_GPDISP_HI16
3732     Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
3733     "addend" in some special way.  For GPDISP_HI16 ("gpdisp")
3734     relocations, the symbol is ignored when writing; when reading, it
3735     will be the absolute section symbol.  The addend is the
3736     displacement in bytes of the "lda" instruction from the "ldah"
3737     instruction (which is at the address of this reloc).
3738 -- : BFD_RELOC_ALPHA_GPDISP_LO16
3739     For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
3740     with GPDISP_HI16 relocs.  The addend is ignored when writing the
3741     relocations out, and is filled in with the file's GP value on
3742     reading, for convenience.
3743 -- : BFD_RELOC_ALPHA_GPDISP
3744     The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
3745     relocation except that there is no accompanying GPDISP_LO16
3746     relocation.
3747 -- : BFD_RELOC_ALPHA_LITERAL
3748 -- : BFD_RELOC_ALPHA_ELF_LITERAL
3749 -- : BFD_RELOC_ALPHA_LITUSE
3750     The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
3751     the assembler turns it into a LDQ instruction to load the address
3752     of the symbol, and then fills in a register in the real
3753     instruction.
3754
3755     The LITERAL reloc, at the LDQ instruction, refers to the .lita
3756     section symbol.  The addend is ignored when writing, but is filled
3757     in with the file's GP value on reading, for convenience, as with
3758     the GPDISP_LO16 reloc.
3759
3760     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and
3761     GPDISP_LO16.  It should refer to the symbol to be referenced, as
3762     with 16_GOTOFF, but it generates output not based on the position
3763     within the .got section, but relative to the GP value chosen for
3764     the file during the final link stage.
3765
3766     The LITUSE reloc, on the instruction using the loaded address,
3767     gives information to the linker that it might be able to use to
3768     optimize away some literal section references.  The symbol is
3769     ignored (read as the absolute section symbol), and the "addend"
3770     indicates the type of instruction using the register: 1 - "memory"
3771     fmt insn 2 - byte-manipulation (byte offset reg) 3 - jsr (target of
3772     branch)
3773 -- : BFD_RELOC_ALPHA_HINT
3774     The HINT relocation indicates a value that should be filled into
3775     the "hint" field of a jmp/jsr/ret instruction, for possible branch-
3776     prediction logic which may be provided on some processors.
3777 -- : BFD_RELOC_ALPHA_LINKAGE
3778     The LINKAGE relocation outputs a linkage pair in the object file,
3779     which is filled by the linker.
3780 -- : BFD_RELOC_ALPHA_CODEADDR
3781     The CODEADDR relocation outputs a STO_CA in the object file, which
3782     is filled by the linker.
3783 -- : BFD_RELOC_ALPHA_GPREL_HI16
3784 -- : BFD_RELOC_ALPHA_GPREL_LO16
3785     The GPREL_HI/LO relocations together form a 32-bit offset from the
3786     GP register.
3787 -- : BFD_RELOC_ALPHA_BRSGP
3788     Like BFD_RELOC_23_PCREL_S2, except that the source and target must
3789     share a common GP, and the target address is adjusted for
3790     STO_ALPHA_STD_GPLOAD.
3791 -- : BFD_RELOC_ALPHA_NOP
3792     The NOP relocation outputs a NOP if the longword displacement
3793     between two procedure entry points is < 2^21.
3794 -- : BFD_RELOC_ALPHA_BSR
3795     The BSR relocation outputs a BSR if the longword displacement
3796     between two procedure entry points is < 2^21.
3797 -- : BFD_RELOC_ALPHA_LDA
3798     The LDA relocation outputs a LDA if the longword displacement
3799     between two procedure entry points is < 2^16.
3800 -- : BFD_RELOC_ALPHA_BOH
3801     The BOH relocation outputs a BSR if the longword displacement
3802     between two procedure entry points is < 2^21, or else a hint.
3803 -- : BFD_RELOC_ALPHA_TLSGD
3804 -- : BFD_RELOC_ALPHA_TLSLDM
3805 -- : BFD_RELOC_ALPHA_DTPMOD64
3806 -- : BFD_RELOC_ALPHA_GOTDTPREL16
3807 -- : BFD_RELOC_ALPHA_DTPREL64
3808 -- : BFD_RELOC_ALPHA_DTPREL_HI16
3809 -- : BFD_RELOC_ALPHA_DTPREL_LO16
3810 -- : BFD_RELOC_ALPHA_DTPREL16
3811 -- : BFD_RELOC_ALPHA_GOTTPREL16
3812 -- : BFD_RELOC_ALPHA_TPREL64
3813 -- : BFD_RELOC_ALPHA_TPREL_HI16
3814 -- : BFD_RELOC_ALPHA_TPREL_LO16
3815 -- : BFD_RELOC_ALPHA_TPREL16
3816     Alpha thread-local storage relocations.
3817 -- : BFD_RELOC_MIPS_JMP
3818 -- : BFD_RELOC_MICROMIPS_JMP
3819     The MIPS jump instruction.
3820 -- : BFD_RELOC_MIPS16_JMP
3821     The MIPS16 jump instruction.
3822 -- : BFD_RELOC_MIPS16_GPREL
3823     MIPS16 GP relative reloc.
3824 -- : BFD_RELOC_HI16
3825     High 16 bits of 32-bit value; simple reloc.
3826 -- : BFD_RELOC_HI16_S
3827     High 16 bits of 32-bit value but the low 16 bits will be sign
3828     extended and added to form the final result.  If the low 16 bits
3829     form a negative number, we need to add one to the high value to
3830     compensate for the borrow when the low bits are added.
3831 -- : BFD_RELOC_LO16
3832     Low 16 bits.
3833 -- : BFD_RELOC_HI16_PCREL
3834     High 16 bits of 32-bit pc-relative value
3835 -- : BFD_RELOC_HI16_S_PCREL
3836     High 16 bits of 32-bit pc-relative value, adjusted
3837 -- : BFD_RELOC_LO16_PCREL
3838     Low 16 bits of pc-relative value
3839 -- : BFD_RELOC_MIPS16_GOT16
3840 -- : BFD_RELOC_MIPS16_CALL16
3841     Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
3842     16-bit immediate fields
3843 -- : BFD_RELOC_MIPS16_HI16
3844     MIPS16 high 16 bits of 32-bit value.
3845 -- : BFD_RELOC_MIPS16_HI16_S
3846     MIPS16 high 16 bits of 32-bit value but the low 16 bits will be
3847     sign extended and added to form the final result.  If the low 16
3848     bits form a negative number, we need to add one to the high value
3849     to compensate for the borrow when the low bits are added.
3850 -- : BFD_RELOC_MIPS16_LO16
3851     MIPS16 low 16 bits.
3852 -- : BFD_RELOC_MIPS16_TLS_GD
3853 -- : BFD_RELOC_MIPS16_TLS_LDM
3854 -- : BFD_RELOC_MIPS16_TLS_DTPREL_HI16
3855 -- : BFD_RELOC_MIPS16_TLS_DTPREL_LO16
3856 -- : BFD_RELOC_MIPS16_TLS_GOTTPREL
3857 -- : BFD_RELOC_MIPS16_TLS_TPREL_HI16
3858 -- : BFD_RELOC_MIPS16_TLS_TPREL_LO16
3859     MIPS16 TLS relocations
3860 -- : BFD_RELOC_MIPS_LITERAL
3861 -- : BFD_RELOC_MICROMIPS_LITERAL
3862     Relocation against a MIPS literal section.
3863 -- : BFD_RELOC_MICROMIPS_7_PCREL_S1
3864 -- : BFD_RELOC_MICROMIPS_10_PCREL_S1
3865 -- : BFD_RELOC_MICROMIPS_16_PCREL_S1
3866     microMIPS PC-relative relocations.
3867 -- : BFD_RELOC_MIPS16_16_PCREL_S1
3868     MIPS16 PC-relative relocation.
3869 -- : BFD_RELOC_MIPS_21_PCREL_S2
3870 -- : BFD_RELOC_MIPS_26_PCREL_S2
3871 -- : BFD_RELOC_MIPS_18_PCREL_S3
3872 -- : BFD_RELOC_MIPS_19_PCREL_S2
3873     MIPS PC-relative relocations.
3874 -- : BFD_RELOC_MICROMIPS_GPREL16
3875 -- : BFD_RELOC_MICROMIPS_HI16
3876 -- : BFD_RELOC_MICROMIPS_HI16_S
3877 -- : BFD_RELOC_MICROMIPS_LO16
3878     microMIPS versions of generic BFD relocs.
3879 -- : BFD_RELOC_MIPS_GOT16
3880 -- : BFD_RELOC_MICROMIPS_GOT16
3881 -- : BFD_RELOC_MIPS_CALL16
3882 -- : BFD_RELOC_MICROMIPS_CALL16
3883 -- : BFD_RELOC_MIPS_GOT_HI16
3884 -- : BFD_RELOC_MICROMIPS_GOT_HI16
3885 -- : BFD_RELOC_MIPS_GOT_LO16
3886 -- : BFD_RELOC_MICROMIPS_GOT_LO16
3887 -- : BFD_RELOC_MIPS_CALL_HI16
3888 -- : BFD_RELOC_MICROMIPS_CALL_HI16
3889 -- : BFD_RELOC_MIPS_CALL_LO16
3890 -- : BFD_RELOC_MICROMIPS_CALL_LO16
3891 -- : BFD_RELOC_MIPS_SUB
3892 -- : BFD_RELOC_MICROMIPS_SUB
3893 -- : BFD_RELOC_MIPS_GOT_PAGE
3894 -- : BFD_RELOC_MICROMIPS_GOT_PAGE
3895 -- : BFD_RELOC_MIPS_GOT_OFST
3896 -- : BFD_RELOC_MICROMIPS_GOT_OFST
3897 -- : BFD_RELOC_MIPS_GOT_DISP
3898 -- : BFD_RELOC_MICROMIPS_GOT_DISP
3899 -- : BFD_RELOC_MIPS_SHIFT5
3900 -- : BFD_RELOC_MIPS_SHIFT6
3901 -- : BFD_RELOC_MIPS_INSERT_A
3902 -- : BFD_RELOC_MIPS_INSERT_B
3903 -- : BFD_RELOC_MIPS_DELETE
3904 -- : BFD_RELOC_MIPS_HIGHEST
3905 -- : BFD_RELOC_MICROMIPS_HIGHEST
3906 -- : BFD_RELOC_MIPS_HIGHER
3907 -- : BFD_RELOC_MICROMIPS_HIGHER
3908 -- : BFD_RELOC_MIPS_SCN_DISP
3909 -- : BFD_RELOC_MICROMIPS_SCN_DISP
3910 -- : BFD_RELOC_MIPS_REL16
3911 -- : BFD_RELOC_MIPS_RELGOT
3912 -- : BFD_RELOC_MIPS_JALR
3913 -- : BFD_RELOC_MICROMIPS_JALR
3914 -- : BFD_RELOC_MIPS_TLS_DTPMOD32
3915 -- : BFD_RELOC_MIPS_TLS_DTPREL32
3916 -- : BFD_RELOC_MIPS_TLS_DTPMOD64
3917 -- : BFD_RELOC_MIPS_TLS_DTPREL64
3918 -- : BFD_RELOC_MIPS_TLS_GD
3919 -- : BFD_RELOC_MICROMIPS_TLS_GD
3920 -- : BFD_RELOC_MIPS_TLS_LDM
3921 -- : BFD_RELOC_MICROMIPS_TLS_LDM
3922 -- : BFD_RELOC_MIPS_TLS_DTPREL_HI16
3923 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
3924 -- : BFD_RELOC_MIPS_TLS_DTPREL_LO16
3925 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
3926 -- : BFD_RELOC_MIPS_TLS_GOTTPREL
3927 -- : BFD_RELOC_MICROMIPS_TLS_GOTTPREL
3928 -- : BFD_RELOC_MIPS_TLS_TPREL32
3929 -- : BFD_RELOC_MIPS_TLS_TPREL64
3930 -- : BFD_RELOC_MIPS_TLS_TPREL_HI16
3931 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
3932 -- : BFD_RELOC_MIPS_TLS_TPREL_LO16
3933 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
3934 -- : BFD_RELOC_MIPS_EH
3935     MIPS ELF relocations.
3936 -- : BFD_RELOC_MIPS_COPY
3937 -- : BFD_RELOC_MIPS_JUMP_SLOT
3938     MIPS ELF relocations (VxWorks and PLT extensions).
3939 -- : BFD_RELOC_MOXIE_10_PCREL
3940     Moxie ELF relocations.
3941 -- : BFD_RELOC_FT32_10
3942 -- : BFD_RELOC_FT32_20
3943 -- : BFD_RELOC_FT32_17
3944 -- : BFD_RELOC_FT32_18
3945 -- : BFD_RELOC_FT32_RELAX
3946 -- : BFD_RELOC_FT32_SC0
3947 -- : BFD_RELOC_FT32_SC1
3948 -- : BFD_RELOC_FT32_15
3949 -- : BFD_RELOC_FT32_DIFF32
3950     FT32 ELF relocations.
3951 -- : BFD_RELOC_FRV_LABEL16
3952 -- : BFD_RELOC_FRV_LABEL24
3953 -- : BFD_RELOC_FRV_LO16
3954 -- : BFD_RELOC_FRV_HI16
3955 -- : BFD_RELOC_FRV_GPREL12
3956 -- : BFD_RELOC_FRV_GPRELU12
3957 -- : BFD_RELOC_FRV_GPREL32
3958 -- : BFD_RELOC_FRV_GPRELHI
3959 -- : BFD_RELOC_FRV_GPRELLO
3960 -- : BFD_RELOC_FRV_GOT12
3961 -- : BFD_RELOC_FRV_GOTHI
3962 -- : BFD_RELOC_FRV_GOTLO
3963 -- : BFD_RELOC_FRV_FUNCDESC
3964 -- : BFD_RELOC_FRV_FUNCDESC_GOT12
3965 -- : BFD_RELOC_FRV_FUNCDESC_GOTHI
3966 -- : BFD_RELOC_FRV_FUNCDESC_GOTLO
3967 -- : BFD_RELOC_FRV_FUNCDESC_VALUE
3968 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFF12
3969 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
3970 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
3971 -- : BFD_RELOC_FRV_GOTOFF12
3972 -- : BFD_RELOC_FRV_GOTOFFHI
3973 -- : BFD_RELOC_FRV_GOTOFFLO
3974 -- : BFD_RELOC_FRV_GETTLSOFF
3975 -- : BFD_RELOC_FRV_TLSDESC_VALUE
3976 -- : BFD_RELOC_FRV_GOTTLSDESC12
3977 -- : BFD_RELOC_FRV_GOTTLSDESCHI
3978 -- : BFD_RELOC_FRV_GOTTLSDESCLO
3979 -- : BFD_RELOC_FRV_TLSMOFF12
3980 -- : BFD_RELOC_FRV_TLSMOFFHI
3981 -- : BFD_RELOC_FRV_TLSMOFFLO
3982 -- : BFD_RELOC_FRV_GOTTLSOFF12
3983 -- : BFD_RELOC_FRV_GOTTLSOFFHI
3984 -- : BFD_RELOC_FRV_GOTTLSOFFLO
3985 -- : BFD_RELOC_FRV_TLSOFF
3986 -- : BFD_RELOC_FRV_TLSDESC_RELAX
3987 -- : BFD_RELOC_FRV_GETTLSOFF_RELAX
3988 -- : BFD_RELOC_FRV_TLSOFF_RELAX
3989 -- : BFD_RELOC_FRV_TLSMOFF
3990     Fujitsu Frv Relocations.
3991 -- : BFD_RELOC_MN10300_GOTOFF24
3992     This is a 24bit GOT-relative reloc for the mn10300.
3993 -- : BFD_RELOC_MN10300_GOT32
3994     This is a 32bit GOT-relative reloc for the mn10300, offset by two
3995     bytes in the instruction.
3996 -- : BFD_RELOC_MN10300_GOT24
3997     This is a 24bit GOT-relative reloc for the mn10300, offset by two
3998     bytes in the instruction.
3999 -- : BFD_RELOC_MN10300_GOT16
4000     This is a 16bit GOT-relative reloc for the mn10300, offset by two
4001     bytes in the instruction.
4002 -- : BFD_RELOC_MN10300_COPY
4003     Copy symbol at runtime.
4004 -- : BFD_RELOC_MN10300_GLOB_DAT
4005     Create GOT entry.
4006 -- : BFD_RELOC_MN10300_JMP_SLOT
4007     Create PLT entry.
4008 -- : BFD_RELOC_MN10300_RELATIVE
4009     Adjust by program base.
4010 -- : BFD_RELOC_MN10300_SYM_DIFF
4011     Together with another reloc targeted at the same location, allows
4012     for a value that is the difference of two symbols in the same
4013     section.
4014 -- : BFD_RELOC_MN10300_ALIGN
4015     The addend of this reloc is an alignment power that must be
4016     honoured at the offset's location, regardless of linker relaxation.
4017 -- : BFD_RELOC_MN10300_TLS_GD
4018 -- : BFD_RELOC_MN10300_TLS_LD
4019 -- : BFD_RELOC_MN10300_TLS_LDO
4020 -- : BFD_RELOC_MN10300_TLS_GOTIE
4021 -- : BFD_RELOC_MN10300_TLS_IE
4022 -- : BFD_RELOC_MN10300_TLS_LE
4023 -- : BFD_RELOC_MN10300_TLS_DTPMOD
4024 -- : BFD_RELOC_MN10300_TLS_DTPOFF
4025 -- : BFD_RELOC_MN10300_TLS_TPOFF
4026     Various TLS-related relocations.
4027 -- : BFD_RELOC_MN10300_32_PCREL
4028     This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
4029     the instruction.
4030 -- : BFD_RELOC_MN10300_16_PCREL
4031     This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
4032     the instruction.
4033 -- : BFD_RELOC_386_GOT32
4034 -- : BFD_RELOC_386_PLT32
4035 -- : BFD_RELOC_386_COPY
4036 -- : BFD_RELOC_386_GLOB_DAT
4037 -- : BFD_RELOC_386_JUMP_SLOT
4038 -- : BFD_RELOC_386_RELATIVE
4039 -- : BFD_RELOC_386_GOTOFF
4040 -- : BFD_RELOC_386_GOTPC
4041 -- : BFD_RELOC_386_TLS_TPOFF
4042 -- : BFD_RELOC_386_TLS_IE
4043 -- : BFD_RELOC_386_TLS_GOTIE
4044 -- : BFD_RELOC_386_TLS_LE
4045 -- : BFD_RELOC_386_TLS_GD
4046 -- : BFD_RELOC_386_TLS_LDM
4047 -- : BFD_RELOC_386_TLS_LDO_32
4048 -- : BFD_RELOC_386_TLS_IE_32
4049 -- : BFD_RELOC_386_TLS_LE_32
4050 -- : BFD_RELOC_386_TLS_DTPMOD32
4051 -- : BFD_RELOC_386_TLS_DTPOFF32
4052 -- : BFD_RELOC_386_TLS_TPOFF32
4053 -- : BFD_RELOC_386_TLS_GOTDESC
4054 -- : BFD_RELOC_386_TLS_DESC_CALL
4055 -- : BFD_RELOC_386_TLS_DESC
4056 -- : BFD_RELOC_386_IRELATIVE
4057 -- : BFD_RELOC_386_GOT32X
4058     i386/elf relocations
4059 -- : BFD_RELOC_X86_64_GOT32
4060 -- : BFD_RELOC_X86_64_PLT32
4061 -- : BFD_RELOC_X86_64_COPY
4062 -- : BFD_RELOC_X86_64_GLOB_DAT
4063 -- : BFD_RELOC_X86_64_JUMP_SLOT
4064 -- : BFD_RELOC_X86_64_RELATIVE
4065 -- : BFD_RELOC_X86_64_GOTPCREL
4066 -- : BFD_RELOC_X86_64_32S
4067 -- : BFD_RELOC_X86_64_DTPMOD64
4068 -- : BFD_RELOC_X86_64_DTPOFF64
4069 -- : BFD_RELOC_X86_64_TPOFF64
4070 -- : BFD_RELOC_X86_64_TLSGD
4071 -- : BFD_RELOC_X86_64_TLSLD
4072 -- : BFD_RELOC_X86_64_DTPOFF32
4073 -- : BFD_RELOC_X86_64_GOTTPOFF
4074 -- : BFD_RELOC_X86_64_TPOFF32
4075 -- : BFD_RELOC_X86_64_GOTOFF64
4076 -- : BFD_RELOC_X86_64_GOTPC32
4077 -- : BFD_RELOC_X86_64_GOT64
4078 -- : BFD_RELOC_X86_64_GOTPCREL64
4079 -- : BFD_RELOC_X86_64_GOTPC64
4080 -- : BFD_RELOC_X86_64_GOTPLT64
4081 -- : BFD_RELOC_X86_64_PLTOFF64
4082 -- : BFD_RELOC_X86_64_GOTPC32_TLSDESC
4083 -- : BFD_RELOC_X86_64_TLSDESC_CALL
4084 -- : BFD_RELOC_X86_64_TLSDESC
4085 -- : BFD_RELOC_X86_64_IRELATIVE
4086 -- : BFD_RELOC_X86_64_PC32_BND
4087 -- : BFD_RELOC_X86_64_PLT32_BND
4088 -- : BFD_RELOC_X86_64_GOTPCRELX
4089 -- : BFD_RELOC_X86_64_REX_GOTPCRELX
4090     x86-64/elf relocations
4091 -- : BFD_RELOC_NS32K_IMM_8
4092 -- : BFD_RELOC_NS32K_IMM_16
4093 -- : BFD_RELOC_NS32K_IMM_32
4094 -- : BFD_RELOC_NS32K_IMM_8_PCREL
4095 -- : BFD_RELOC_NS32K_IMM_16_PCREL
4096 -- : BFD_RELOC_NS32K_IMM_32_PCREL
4097 -- : BFD_RELOC_NS32K_DISP_8
4098 -- : BFD_RELOC_NS32K_DISP_16
4099 -- : BFD_RELOC_NS32K_DISP_32
4100 -- : BFD_RELOC_NS32K_DISP_8_PCREL
4101 -- : BFD_RELOC_NS32K_DISP_16_PCREL
4102 -- : BFD_RELOC_NS32K_DISP_32_PCREL
4103     ns32k relocations
4104 -- : BFD_RELOC_PDP11_DISP_8_PCREL
4105 -- : BFD_RELOC_PDP11_DISP_6_PCREL
4106     PDP11 relocations
4107 -- : BFD_RELOC_PJ_CODE_HI16
4108 -- : BFD_RELOC_PJ_CODE_LO16
4109 -- : BFD_RELOC_PJ_CODE_DIR16
4110 -- : BFD_RELOC_PJ_CODE_DIR32
4111 -- : BFD_RELOC_PJ_CODE_REL16
4112 -- : BFD_RELOC_PJ_CODE_REL32
4113     Picojava relocs.  Not all of these appear in object files.
4114 -- : BFD_RELOC_PPC_B26
4115 -- : BFD_RELOC_PPC_BA26
4116 -- : BFD_RELOC_PPC_TOC16
4117 -- : BFD_RELOC_PPC_B16
4118 -- : BFD_RELOC_PPC_B16_BRTAKEN
4119 -- : BFD_RELOC_PPC_B16_BRNTAKEN
4120 -- : BFD_RELOC_PPC_BA16
4121 -- : BFD_RELOC_PPC_BA16_BRTAKEN
4122 -- : BFD_RELOC_PPC_BA16_BRNTAKEN
4123 -- : BFD_RELOC_PPC_COPY
4124 -- : BFD_RELOC_PPC_GLOB_DAT
4125 -- : BFD_RELOC_PPC_JMP_SLOT
4126 -- : BFD_RELOC_PPC_RELATIVE
4127 -- : BFD_RELOC_PPC_LOCAL24PC
4128 -- : BFD_RELOC_PPC_EMB_NADDR32
4129 -- : BFD_RELOC_PPC_EMB_NADDR16
4130 -- : BFD_RELOC_PPC_EMB_NADDR16_LO
4131 -- : BFD_RELOC_PPC_EMB_NADDR16_HI
4132 -- : BFD_RELOC_PPC_EMB_NADDR16_HA
4133 -- : BFD_RELOC_PPC_EMB_SDAI16
4134 -- : BFD_RELOC_PPC_EMB_SDA2I16
4135 -- : BFD_RELOC_PPC_EMB_SDA2REL
4136 -- : BFD_RELOC_PPC_EMB_SDA21
4137 -- : BFD_RELOC_PPC_EMB_MRKREF
4138 -- : BFD_RELOC_PPC_EMB_RELSEC16
4139 -- : BFD_RELOC_PPC_EMB_RELST_LO
4140 -- : BFD_RELOC_PPC_EMB_RELST_HI
4141 -- : BFD_RELOC_PPC_EMB_RELST_HA
4142 -- : BFD_RELOC_PPC_EMB_BIT_FLD
4143 -- : BFD_RELOC_PPC_EMB_RELSDA
4144 -- : BFD_RELOC_PPC_VLE_REL8
4145 -- : BFD_RELOC_PPC_VLE_REL15
4146 -- : BFD_RELOC_PPC_VLE_REL24
4147 -- : BFD_RELOC_PPC_VLE_LO16A
4148 -- : BFD_RELOC_PPC_VLE_LO16D
4149 -- : BFD_RELOC_PPC_VLE_HI16A
4150 -- : BFD_RELOC_PPC_VLE_HI16D
4151 -- : BFD_RELOC_PPC_VLE_HA16A
4152 -- : BFD_RELOC_PPC_VLE_HA16D
4153 -- : BFD_RELOC_PPC_VLE_SDA21
4154 -- : BFD_RELOC_PPC_VLE_SDA21_LO
4155 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16A
4156 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16D
4157 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16A
4158 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16D
4159 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16A
4160 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16D
4161 -- : BFD_RELOC_PPC_16DX_HA
4162 -- : BFD_RELOC_PPC_REL16DX_HA
4163 -- : BFD_RELOC_PPC64_HIGHER
4164 -- : BFD_RELOC_PPC64_HIGHER_S
4165 -- : BFD_RELOC_PPC64_HIGHEST
4166 -- : BFD_RELOC_PPC64_HIGHEST_S
4167 -- : BFD_RELOC_PPC64_TOC16_LO
4168 -- : BFD_RELOC_PPC64_TOC16_HI
4169 -- : BFD_RELOC_PPC64_TOC16_HA
4170 -- : BFD_RELOC_PPC64_TOC
4171 -- : BFD_RELOC_PPC64_PLTGOT16
4172 -- : BFD_RELOC_PPC64_PLTGOT16_LO
4173 -- : BFD_RELOC_PPC64_PLTGOT16_HI
4174 -- : BFD_RELOC_PPC64_PLTGOT16_HA
4175 -- : BFD_RELOC_PPC64_ADDR16_DS
4176 -- : BFD_RELOC_PPC64_ADDR16_LO_DS
4177 -- : BFD_RELOC_PPC64_GOT16_DS
4178 -- : BFD_RELOC_PPC64_GOT16_LO_DS
4179 -- : BFD_RELOC_PPC64_PLT16_LO_DS
4180 -- : BFD_RELOC_PPC64_SECTOFF_DS
4181 -- : BFD_RELOC_PPC64_SECTOFF_LO_DS
4182 -- : BFD_RELOC_PPC64_TOC16_DS
4183 -- : BFD_RELOC_PPC64_TOC16_LO_DS
4184 -- : BFD_RELOC_PPC64_PLTGOT16_DS
4185 -- : BFD_RELOC_PPC64_PLTGOT16_LO_DS
4186 -- : BFD_RELOC_PPC64_ADDR16_HIGH
4187 -- : BFD_RELOC_PPC64_ADDR16_HIGHA
4188 -- : BFD_RELOC_PPC64_ADDR64_LOCAL
4189 -- : BFD_RELOC_PPC64_ENTRY
4190     Power(rs6000) and PowerPC relocations.
4191 -- : BFD_RELOC_PPC_TLS
4192 -- : BFD_RELOC_PPC_TLSGD
4193 -- : BFD_RELOC_PPC_TLSLD
4194 -- : BFD_RELOC_PPC_DTPMOD
4195 -- : BFD_RELOC_PPC_TPREL16
4196 -- : BFD_RELOC_PPC_TPREL16_LO
4197 -- : BFD_RELOC_PPC_TPREL16_HI
4198 -- : BFD_RELOC_PPC_TPREL16_HA
4199 -- : BFD_RELOC_PPC_TPREL
4200 -- : BFD_RELOC_PPC_DTPREL16
4201 -- : BFD_RELOC_PPC_DTPREL16_LO
4202 -- : BFD_RELOC_PPC_DTPREL16_HI
4203 -- : BFD_RELOC_PPC_DTPREL16_HA
4204 -- : BFD_RELOC_PPC_DTPREL
4205 -- : BFD_RELOC_PPC_GOT_TLSGD16
4206 -- : BFD_RELOC_PPC_GOT_TLSGD16_LO
4207 -- : BFD_RELOC_PPC_GOT_TLSGD16_HI
4208 -- : BFD_RELOC_PPC_GOT_TLSGD16_HA
4209 -- : BFD_RELOC_PPC_GOT_TLSLD16
4210 -- : BFD_RELOC_PPC_GOT_TLSLD16_LO
4211 -- : BFD_RELOC_PPC_GOT_TLSLD16_HI
4212 -- : BFD_RELOC_PPC_GOT_TLSLD16_HA
4213 -- : BFD_RELOC_PPC_GOT_TPREL16
4214 -- : BFD_RELOC_PPC_GOT_TPREL16_LO
4215 -- : BFD_RELOC_PPC_GOT_TPREL16_HI
4216 -- : BFD_RELOC_PPC_GOT_TPREL16_HA
4217 -- : BFD_RELOC_PPC_GOT_DTPREL16
4218 -- : BFD_RELOC_PPC_GOT_DTPREL16_LO
4219 -- : BFD_RELOC_PPC_GOT_DTPREL16_HI
4220 -- : BFD_RELOC_PPC_GOT_DTPREL16_HA
4221 -- : BFD_RELOC_PPC64_TPREL16_DS
4222 -- : BFD_RELOC_PPC64_TPREL16_LO_DS
4223 -- : BFD_RELOC_PPC64_TPREL16_HIGHER
4224 -- : BFD_RELOC_PPC64_TPREL16_HIGHERA
4225 -- : BFD_RELOC_PPC64_TPREL16_HIGHEST
4226 -- : BFD_RELOC_PPC64_TPREL16_HIGHESTA
4227 -- : BFD_RELOC_PPC64_DTPREL16_DS
4228 -- : BFD_RELOC_PPC64_DTPREL16_LO_DS
4229 -- : BFD_RELOC_PPC64_DTPREL16_HIGHER
4230 -- : BFD_RELOC_PPC64_DTPREL16_HIGHERA
4231 -- : BFD_RELOC_PPC64_DTPREL16_HIGHEST
4232 -- : BFD_RELOC_PPC64_DTPREL16_HIGHESTA
4233 -- : BFD_RELOC_PPC64_TPREL16_HIGH
4234 -- : BFD_RELOC_PPC64_TPREL16_HIGHA
4235 -- : BFD_RELOC_PPC64_DTPREL16_HIGH
4236 -- : BFD_RELOC_PPC64_DTPREL16_HIGHA
4237     PowerPC and PowerPC64 thread-local storage relocations.
4238 -- : BFD_RELOC_I370_D12
4239     IBM 370/390 relocations
4240 -- : BFD_RELOC_CTOR
4241     The type of reloc used to build a constructor table - at the moment
4242     probably a 32 bit wide absolute relocation, but the target can
4243     choose.  It generally does map to one of the other relocation
4244     types.
4245 -- : BFD_RELOC_ARM_PCREL_BRANCH
4246     ARM 26 bit pc-relative branch.  The lowest two bits must be zero
4247     and are not stored in the instruction.
4248 -- : BFD_RELOC_ARM_PCREL_BLX
4249     ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
4250     not stored in the instruction.  The 2nd lowest bit comes from a 1
4251     bit field in the instruction.
4252 -- : BFD_RELOC_THUMB_PCREL_BLX
4253     Thumb 22 bit pc-relative branch.  The lowest bit must be zero and
4254     is not stored in the instruction.  The 2nd lowest bit comes from a
4255     1 bit field in the instruction.
4256 -- : BFD_RELOC_ARM_PCREL_CALL
4257     ARM 26-bit pc-relative branch for an unconditional BL or BLX
4258     instruction.
4259 -- : BFD_RELOC_ARM_PCREL_JUMP
4260     ARM 26-bit pc-relative branch for B or conditional BL instruction.
4261 -- : BFD_RELOC_THUMB_PCREL_BRANCH7
4262 -- : BFD_RELOC_THUMB_PCREL_BRANCH9
4263 -- : BFD_RELOC_THUMB_PCREL_BRANCH12
4264 -- : BFD_RELOC_THUMB_PCREL_BRANCH20
4265 -- : BFD_RELOC_THUMB_PCREL_BRANCH23
4266 -- : BFD_RELOC_THUMB_PCREL_BRANCH25
4267     Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.  The
4268     lowest bit must be zero and is not stored in the instruction.  Note
4269     that the corresponding ELF R_ARM_THM_JUMPnn constant has an "nn"
4270     one smaller in all cases.  Note further that BRANCH23 corresponds
4271     to R_ARM_THM_CALL.
4272 -- : BFD_RELOC_ARM_OFFSET_IMM
4273     12-bit immediate offset, used in ARM-format ldr and str
4274     instructions.
4275 -- : BFD_RELOC_ARM_THUMB_OFFSET
4276     5-bit immediate offset, used in Thumb-format ldr and str
4277     instructions.
4278 -- : BFD_RELOC_ARM_TARGET1
4279     Pc-relative or absolute relocation depending on target.  Used for
4280     entries in .init_array sections.
4281 -- : BFD_RELOC_ARM_ROSEGREL32
4282     Read-only segment base relative address.
4283 -- : BFD_RELOC_ARM_SBREL32
4284     Data segment base relative address.
4285 -- : BFD_RELOC_ARM_TARGET2
4286     This reloc is used for references to RTTI data from exception
4287     handling tables.  The actual definition depends on the target.  It
4288     may be a pc-relative or some form of GOT-indirect relocation.
4289 -- : BFD_RELOC_ARM_PREL31
4290     31-bit PC relative address.
4291 -- : BFD_RELOC_ARM_MOVW
4292 -- : BFD_RELOC_ARM_MOVT
4293 -- : BFD_RELOC_ARM_MOVW_PCREL
4294 -- : BFD_RELOC_ARM_MOVT_PCREL
4295 -- : BFD_RELOC_ARM_THUMB_MOVW
4296 -- : BFD_RELOC_ARM_THUMB_MOVT
4297 -- : BFD_RELOC_ARM_THUMB_MOVW_PCREL
4298 -- : BFD_RELOC_ARM_THUMB_MOVT_PCREL
4299     Low and High halfword relocations for MOVW and MOVT instructions.
4300 -- : BFD_RELOC_ARM_JUMP_SLOT
4301 -- : BFD_RELOC_ARM_GLOB_DAT
4302 -- : BFD_RELOC_ARM_GOT32
4303 -- : BFD_RELOC_ARM_PLT32
4304 -- : BFD_RELOC_ARM_RELATIVE
4305 -- : BFD_RELOC_ARM_GOTOFF
4306 -- : BFD_RELOC_ARM_GOTPC
4307 -- : BFD_RELOC_ARM_GOT_PREL
4308     Relocations for setting up GOTs and PLTs for shared libraries.
4309 -- : BFD_RELOC_ARM_TLS_GD32
4310 -- : BFD_RELOC_ARM_TLS_LDO32
4311 -- : BFD_RELOC_ARM_TLS_LDM32
4312 -- : BFD_RELOC_ARM_TLS_DTPOFF32
4313 -- : BFD_RELOC_ARM_TLS_DTPMOD32
4314 -- : BFD_RELOC_ARM_TLS_TPOFF32
4315 -- : BFD_RELOC_ARM_TLS_IE32
4316 -- : BFD_RELOC_ARM_TLS_LE32
4317 -- : BFD_RELOC_ARM_TLS_GOTDESC
4318 -- : BFD_RELOC_ARM_TLS_CALL
4319 -- : BFD_RELOC_ARM_THM_TLS_CALL
4320 -- : BFD_RELOC_ARM_TLS_DESCSEQ
4321 -- : BFD_RELOC_ARM_THM_TLS_DESCSEQ
4322 -- : BFD_RELOC_ARM_TLS_DESC
4323     ARM thread-local storage relocations.
4324 -- : BFD_RELOC_ARM_ALU_PC_G0_NC
4325 -- : BFD_RELOC_ARM_ALU_PC_G0
4326 -- : BFD_RELOC_ARM_ALU_PC_G1_NC
4327 -- : BFD_RELOC_ARM_ALU_PC_G1
4328 -- : BFD_RELOC_ARM_ALU_PC_G2
4329 -- : BFD_RELOC_ARM_LDR_PC_G0
4330 -- : BFD_RELOC_ARM_LDR_PC_G1
4331 -- : BFD_RELOC_ARM_LDR_PC_G2
4332 -- : BFD_RELOC_ARM_LDRS_PC_G0
4333 -- : BFD_RELOC_ARM_LDRS_PC_G1
4334 -- : BFD_RELOC_ARM_LDRS_PC_G2
4335 -- : BFD_RELOC_ARM_LDC_PC_G0
4336 -- : BFD_RELOC_ARM_LDC_PC_G1
4337 -- : BFD_RELOC_ARM_LDC_PC_G2
4338 -- : BFD_RELOC_ARM_ALU_SB_G0_NC
4339 -- : BFD_RELOC_ARM_ALU_SB_G0
4340 -- : BFD_RELOC_ARM_ALU_SB_G1_NC
4341 -- : BFD_RELOC_ARM_ALU_SB_G1
4342 -- : BFD_RELOC_ARM_ALU_SB_G2
4343 -- : BFD_RELOC_ARM_LDR_SB_G0
4344 -- : BFD_RELOC_ARM_LDR_SB_G1
4345 -- : BFD_RELOC_ARM_LDR_SB_G2
4346 -- : BFD_RELOC_ARM_LDRS_SB_G0
4347 -- : BFD_RELOC_ARM_LDRS_SB_G1
4348 -- : BFD_RELOC_ARM_LDRS_SB_G2
4349 -- : BFD_RELOC_ARM_LDC_SB_G0
4350 -- : BFD_RELOC_ARM_LDC_SB_G1
4351 -- : BFD_RELOC_ARM_LDC_SB_G2
4352     ARM group relocations.
4353 -- : BFD_RELOC_ARM_V4BX
4354     Annotation of BX instructions.
4355 -- : BFD_RELOC_ARM_IRELATIVE
4356     ARM support for STT_GNU_IFUNC.
4357 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC
4358 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC
4359 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC
4360 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC
4361     Thumb1 relocations to support execute-only code.
4362 -- : BFD_RELOC_ARM_IMMEDIATE
4363 -- : BFD_RELOC_ARM_ADRL_IMMEDIATE
4364 -- : BFD_RELOC_ARM_T32_IMMEDIATE
4365 -- : BFD_RELOC_ARM_T32_ADD_IMM
4366 -- : BFD_RELOC_ARM_T32_IMM12
4367 -- : BFD_RELOC_ARM_T32_ADD_PC12
4368 -- : BFD_RELOC_ARM_SHIFT_IMM
4369 -- : BFD_RELOC_ARM_SMC
4370 -- : BFD_RELOC_ARM_HVC
4371 -- : BFD_RELOC_ARM_SWI
4372 -- : BFD_RELOC_ARM_MULTI
4373 -- : BFD_RELOC_ARM_CP_OFF_IMM
4374 -- : BFD_RELOC_ARM_CP_OFF_IMM_S2
4375 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM
4376 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
4377 -- : BFD_RELOC_ARM_ADR_IMM
4378 -- : BFD_RELOC_ARM_LDR_IMM
4379 -- : BFD_RELOC_ARM_LITERAL
4380 -- : BFD_RELOC_ARM_IN_POOL
4381 -- : BFD_RELOC_ARM_OFFSET_IMM8
4382 -- : BFD_RELOC_ARM_T32_OFFSET_U8
4383 -- : BFD_RELOC_ARM_T32_OFFSET_IMM
4384 -- : BFD_RELOC_ARM_HWLITERAL
4385 -- : BFD_RELOC_ARM_THUMB_ADD
4386 -- : BFD_RELOC_ARM_THUMB_IMM
4387 -- : BFD_RELOC_ARM_THUMB_SHIFT
4388     These relocs are only used within the ARM assembler.  They are not
4389     (at present) written to any object files.
4390 -- : BFD_RELOC_SH_PCDISP8BY2
4391 -- : BFD_RELOC_SH_PCDISP12BY2
4392 -- : BFD_RELOC_SH_IMM3
4393 -- : BFD_RELOC_SH_IMM3U
4394 -- : BFD_RELOC_SH_DISP12
4395 -- : BFD_RELOC_SH_DISP12BY2
4396 -- : BFD_RELOC_SH_DISP12BY4
4397 -- : BFD_RELOC_SH_DISP12BY8
4398 -- : BFD_RELOC_SH_DISP20
4399 -- : BFD_RELOC_SH_DISP20BY8
4400 -- : BFD_RELOC_SH_IMM4
4401 -- : BFD_RELOC_SH_IMM4BY2
4402 -- : BFD_RELOC_SH_IMM4BY4
4403 -- : BFD_RELOC_SH_IMM8
4404 -- : BFD_RELOC_SH_IMM8BY2
4405 -- : BFD_RELOC_SH_IMM8BY4
4406 -- : BFD_RELOC_SH_PCRELIMM8BY2
4407 -- : BFD_RELOC_SH_PCRELIMM8BY4
4408 -- : BFD_RELOC_SH_SWITCH16
4409 -- : BFD_RELOC_SH_SWITCH32
4410 -- : BFD_RELOC_SH_USES
4411 -- : BFD_RELOC_SH_COUNT
4412 -- : BFD_RELOC_SH_ALIGN
4413 -- : BFD_RELOC_SH_CODE
4414 -- : BFD_RELOC_SH_DATA
4415 -- : BFD_RELOC_SH_LABEL
4416 -- : BFD_RELOC_SH_LOOP_START
4417 -- : BFD_RELOC_SH_LOOP_END
4418 -- : BFD_RELOC_SH_COPY
4419 -- : BFD_RELOC_SH_GLOB_DAT
4420 -- : BFD_RELOC_SH_JMP_SLOT
4421 -- : BFD_RELOC_SH_RELATIVE
4422 -- : BFD_RELOC_SH_GOTPC
4423 -- : BFD_RELOC_SH_GOT_LOW16
4424 -- : BFD_RELOC_SH_GOT_MEDLOW16
4425 -- : BFD_RELOC_SH_GOT_MEDHI16
4426 -- : BFD_RELOC_SH_GOT_HI16
4427 -- : BFD_RELOC_SH_GOTPLT_LOW16
4428 -- : BFD_RELOC_SH_GOTPLT_MEDLOW16
4429 -- : BFD_RELOC_SH_GOTPLT_MEDHI16
4430 -- : BFD_RELOC_SH_GOTPLT_HI16
4431 -- : BFD_RELOC_SH_PLT_LOW16
4432 -- : BFD_RELOC_SH_PLT_MEDLOW16
4433 -- : BFD_RELOC_SH_PLT_MEDHI16
4434 -- : BFD_RELOC_SH_PLT_HI16
4435 -- : BFD_RELOC_SH_GOTOFF_LOW16
4436 -- : BFD_RELOC_SH_GOTOFF_MEDLOW16
4437 -- : BFD_RELOC_SH_GOTOFF_MEDHI16
4438 -- : BFD_RELOC_SH_GOTOFF_HI16
4439 -- : BFD_RELOC_SH_GOTPC_LOW16
4440 -- : BFD_RELOC_SH_GOTPC_MEDLOW16
4441 -- : BFD_RELOC_SH_GOTPC_MEDHI16
4442 -- : BFD_RELOC_SH_GOTPC_HI16
4443 -- : BFD_RELOC_SH_COPY64
4444 -- : BFD_RELOC_SH_GLOB_DAT64
4445 -- : BFD_RELOC_SH_JMP_SLOT64
4446 -- : BFD_RELOC_SH_RELATIVE64
4447 -- : BFD_RELOC_SH_GOT10BY4
4448 -- : BFD_RELOC_SH_GOT10BY8
4449 -- : BFD_RELOC_SH_GOTPLT10BY4
4450 -- : BFD_RELOC_SH_GOTPLT10BY8
4451 -- : BFD_RELOC_SH_GOTPLT32
4452 -- : BFD_RELOC_SH_SHMEDIA_CODE
4453 -- : BFD_RELOC_SH_IMMU5
4454 -- : BFD_RELOC_SH_IMMS6
4455 -- : BFD_RELOC_SH_IMMS6BY32
4456 -- : BFD_RELOC_SH_IMMU6
4457 -- : BFD_RELOC_SH_IMMS10
4458 -- : BFD_RELOC_SH_IMMS10BY2
4459 -- : BFD_RELOC_SH_IMMS10BY4
4460 -- : BFD_RELOC_SH_IMMS10BY8
4461 -- : BFD_RELOC_SH_IMMS16
4462 -- : BFD_RELOC_SH_IMMU16
4463 -- : BFD_RELOC_SH_IMM_LOW16
4464 -- : BFD_RELOC_SH_IMM_LOW16_PCREL
4465 -- : BFD_RELOC_SH_IMM_MEDLOW16
4466 -- : BFD_RELOC_SH_IMM_MEDLOW16_PCREL
4467 -- : BFD_RELOC_SH_IMM_MEDHI16
4468 -- : BFD_RELOC_SH_IMM_MEDHI16_PCREL
4469 -- : BFD_RELOC_SH_IMM_HI16
4470 -- : BFD_RELOC_SH_IMM_HI16_PCREL
4471 -- : BFD_RELOC_SH_PT_16
4472 -- : BFD_RELOC_SH_TLS_GD_32
4473 -- : BFD_RELOC_SH_TLS_LD_32
4474 -- : BFD_RELOC_SH_TLS_LDO_32
4475 -- : BFD_RELOC_SH_TLS_IE_32
4476 -- : BFD_RELOC_SH_TLS_LE_32
4477 -- : BFD_RELOC_SH_TLS_DTPMOD32
4478 -- : BFD_RELOC_SH_TLS_DTPOFF32
4479 -- : BFD_RELOC_SH_TLS_TPOFF32
4480 -- : BFD_RELOC_SH_GOT20
4481 -- : BFD_RELOC_SH_GOTOFF20
4482 -- : BFD_RELOC_SH_GOTFUNCDESC
4483 -- : BFD_RELOC_SH_GOTFUNCDESC20
4484 -- : BFD_RELOC_SH_GOTOFFFUNCDESC
4485 -- : BFD_RELOC_SH_GOTOFFFUNCDESC20
4486 -- : BFD_RELOC_SH_FUNCDESC
4487     Renesas / SuperH SH relocs.  Not all of these appear in object
4488     files.
4489 -- : BFD_RELOC_ARC_NONE
4490 -- : BFD_RELOC_ARC_8
4491 -- : BFD_RELOC_ARC_16
4492 -- : BFD_RELOC_ARC_24
4493 -- : BFD_RELOC_ARC_32
4494 -- : BFD_RELOC_ARC_N8
4495 -- : BFD_RELOC_ARC_N16
4496 -- : BFD_RELOC_ARC_N24
4497 -- : BFD_RELOC_ARC_N32
4498 -- : BFD_RELOC_ARC_SDA
4499 -- : BFD_RELOC_ARC_SECTOFF
4500 -- : BFD_RELOC_ARC_S21H_PCREL
4501 -- : BFD_RELOC_ARC_S21W_PCREL
4502 -- : BFD_RELOC_ARC_S25H_PCREL
4503 -- : BFD_RELOC_ARC_S25W_PCREL
4504 -- : BFD_RELOC_ARC_SDA32
4505 -- : BFD_RELOC_ARC_SDA_LDST
4506 -- : BFD_RELOC_ARC_SDA_LDST1
4507 -- : BFD_RELOC_ARC_SDA_LDST2
4508 -- : BFD_RELOC_ARC_SDA16_LD
4509 -- : BFD_RELOC_ARC_SDA16_LD1
4510 -- : BFD_RELOC_ARC_SDA16_LD2
4511 -- : BFD_RELOC_ARC_S13_PCREL
4512 -- : BFD_RELOC_ARC_W
4513 -- : BFD_RELOC_ARC_32_ME
4514 -- : BFD_RELOC_ARC_32_ME_S
4515 -- : BFD_RELOC_ARC_N32_ME
4516 -- : BFD_RELOC_ARC_SECTOFF_ME
4517 -- : BFD_RELOC_ARC_SDA32_ME
4518 -- : BFD_RELOC_ARC_W_ME
4519 -- : BFD_RELOC_AC_SECTOFF_U8
4520 -- : BFD_RELOC_AC_SECTOFF_U8_1
4521 -- : BFD_RELOC_AC_SECTOFF_U8_2
4522 -- : BFD_RELOC_AC_SECTOFF_S9
4523 -- : BFD_RELOC_AC_SECTOFF_S9_1
4524 -- : BFD_RELOC_AC_SECTOFF_S9_2
4525 -- : BFD_RELOC_ARC_SECTOFF_ME_1
4526 -- : BFD_RELOC_ARC_SECTOFF_ME_2
4527 -- : BFD_RELOC_ARC_SECTOFF_1
4528 -- : BFD_RELOC_ARC_SECTOFF_2
4529 -- : BFD_RELOC_ARC_SDA_12
4530 -- : BFD_RELOC_ARC_SDA16_ST2
4531 -- : BFD_RELOC_ARC_32_PCREL
4532 -- : BFD_RELOC_ARC_PC32
4533 -- : BFD_RELOC_ARC_GOT32
4534 -- : BFD_RELOC_ARC_GOTPC32
4535 -- : BFD_RELOC_ARC_PLT32
4536 -- : BFD_RELOC_ARC_COPY
4537 -- : BFD_RELOC_ARC_GLOB_DAT
4538 -- : BFD_RELOC_ARC_JMP_SLOT
4539 -- : BFD_RELOC_ARC_RELATIVE
4540 -- : BFD_RELOC_ARC_GOTOFF
4541 -- : BFD_RELOC_ARC_GOTPC
4542 -- : BFD_RELOC_ARC_S21W_PCREL_PLT
4543 -- : BFD_RELOC_ARC_S25H_PCREL_PLT
4544 -- : BFD_RELOC_ARC_TLS_DTPMOD
4545 -- : BFD_RELOC_ARC_TLS_TPOFF
4546 -- : BFD_RELOC_ARC_TLS_GD_GOT
4547 -- : BFD_RELOC_ARC_TLS_GD_LD
4548 -- : BFD_RELOC_ARC_TLS_GD_CALL
4549 -- : BFD_RELOC_ARC_TLS_IE_GOT
4550 -- : BFD_RELOC_ARC_TLS_DTPOFF
4551 -- : BFD_RELOC_ARC_TLS_DTPOFF_S9
4552 -- : BFD_RELOC_ARC_TLS_LE_S9
4553 -- : BFD_RELOC_ARC_TLS_LE_32
4554 -- : BFD_RELOC_ARC_S25W_PCREL_PLT
4555 -- : BFD_RELOC_ARC_S21H_PCREL_PLT
4556 -- : BFD_RELOC_ARC_NPS_CMEM16
4557 -- : BFD_RELOC_ARC_JLI_SECTOFF
4558     ARC relocs.
4559 -- : BFD_RELOC_BFIN_16_IMM
4560     ADI Blackfin 16 bit immediate absolute reloc.
4561 -- : BFD_RELOC_BFIN_16_HIGH
4562     ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
4563 -- : BFD_RELOC_BFIN_4_PCREL
4564     ADI Blackfin 'a' part of LSETUP.
4565 -- : BFD_RELOC_BFIN_5_PCREL
4566     ADI Blackfin.
4567 -- : BFD_RELOC_BFIN_16_LOW
4568     ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
4569 -- : BFD_RELOC_BFIN_10_PCREL
4570     ADI Blackfin.
4571 -- : BFD_RELOC_BFIN_11_PCREL
4572     ADI Blackfin 'b' part of LSETUP.
4573 -- : BFD_RELOC_BFIN_12_PCREL_JUMP
4574     ADI Blackfin.
4575 -- : BFD_RELOC_BFIN_12_PCREL_JUMP_S
4576     ADI Blackfin Short jump, pcrel.
4577 -- : BFD_RELOC_BFIN_24_PCREL_CALL_X
4578     ADI Blackfin Call.x not implemented.
4579 -- : BFD_RELOC_BFIN_24_PCREL_JUMP_L
4580     ADI Blackfin Long Jump pcrel.
4581 -- : BFD_RELOC_BFIN_GOT17M4
4582 -- : BFD_RELOC_BFIN_GOTHI
4583 -- : BFD_RELOC_BFIN_GOTLO
4584 -- : BFD_RELOC_BFIN_FUNCDESC
4585 -- : BFD_RELOC_BFIN_FUNCDESC_GOT17M4
4586 -- : BFD_RELOC_BFIN_FUNCDESC_GOTHI
4587 -- : BFD_RELOC_BFIN_FUNCDESC_GOTLO
4588 -- : BFD_RELOC_BFIN_FUNCDESC_VALUE
4589 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
4590 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
4591 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
4592 -- : BFD_RELOC_BFIN_GOTOFF17M4
4593 -- : BFD_RELOC_BFIN_GOTOFFHI
4594 -- : BFD_RELOC_BFIN_GOTOFFLO
4595     ADI Blackfin FD-PIC relocations.
4596 -- : BFD_RELOC_BFIN_GOT
4597     ADI Blackfin GOT relocation.
4598 -- : BFD_RELOC_BFIN_PLTPC
4599     ADI Blackfin PLTPC relocation.
4600 -- : BFD_ARELOC_BFIN_PUSH
4601     ADI Blackfin arithmetic relocation.
4602 -- : BFD_ARELOC_BFIN_CONST
4603     ADI Blackfin arithmetic relocation.
4604 -- : BFD_ARELOC_BFIN_ADD
4605     ADI Blackfin arithmetic relocation.
4606 -- : BFD_ARELOC_BFIN_SUB
4607     ADI Blackfin arithmetic relocation.
4608 -- : BFD_ARELOC_BFIN_MULT
4609     ADI Blackfin arithmetic relocation.
4610 -- : BFD_ARELOC_BFIN_DIV
4611     ADI Blackfin arithmetic relocation.
4612 -- : BFD_ARELOC_BFIN_MOD
4613     ADI Blackfin arithmetic relocation.
4614 -- : BFD_ARELOC_BFIN_LSHIFT
4615     ADI Blackfin arithmetic relocation.
4616 -- : BFD_ARELOC_BFIN_RSHIFT
4617     ADI Blackfin arithmetic relocation.
4618 -- : BFD_ARELOC_BFIN_AND
4619     ADI Blackfin arithmetic relocation.
4620 -- : BFD_ARELOC_BFIN_OR
4621     ADI Blackfin arithmetic relocation.
4622 -- : BFD_ARELOC_BFIN_XOR
4623     ADI Blackfin arithmetic relocation.
4624 -- : BFD_ARELOC_BFIN_LAND
4625     ADI Blackfin arithmetic relocation.
4626 -- : BFD_ARELOC_BFIN_LOR
4627     ADI Blackfin arithmetic relocation.
4628 -- : BFD_ARELOC_BFIN_LEN
4629     ADI Blackfin arithmetic relocation.
4630 -- : BFD_ARELOC_BFIN_NEG
4631     ADI Blackfin arithmetic relocation.
4632 -- : BFD_ARELOC_BFIN_COMP
4633     ADI Blackfin arithmetic relocation.
4634 -- : BFD_ARELOC_BFIN_PAGE
4635     ADI Blackfin arithmetic relocation.
4636 -- : BFD_ARELOC_BFIN_HWPAGE
4637     ADI Blackfin arithmetic relocation.
4638 -- : BFD_ARELOC_BFIN_ADDR
4639     ADI Blackfin arithmetic relocation.
4640 -- : BFD_RELOC_D10V_10_PCREL_R
4641     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4642     bits assumed to be 0.
4643 -- : BFD_RELOC_D10V_10_PCREL_L
4644     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4645     bits assumed to be 0.  This is the same as the previous reloc
4646     except it is in the left container, i.e., shifted left 15 bits.
4647 -- : BFD_RELOC_D10V_18
4648     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4649 -- : BFD_RELOC_D10V_18_PCREL
4650     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4651 -- : BFD_RELOC_D30V_6
4652     Mitsubishi D30V relocs.  This is a 6-bit absolute reloc.
4653 -- : BFD_RELOC_D30V_9_PCREL
4654     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4655     be 0.
4656 -- : BFD_RELOC_D30V_9_PCREL_R
4657     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4658     be 0.  Same as the previous reloc but on the right side of the
4659     container.
4660 -- : BFD_RELOC_D30V_15
4661     This is a 12-bit absolute reloc with the right 3 bitsassumed to be
4662     0.
4663 -- : BFD_RELOC_D30V_15_PCREL
4664     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4665     be 0.
4666 -- : BFD_RELOC_D30V_15_PCREL_R
4667     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4668     be 0.  Same as the previous reloc but on the right side of the
4669     container.
4670 -- : BFD_RELOC_D30V_21
4671     This is an 18-bit absolute reloc with the right 3 bits assumed to
4672     be 0.
4673 -- : BFD_RELOC_D30V_21_PCREL
4674     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4675     to be 0.
4676 -- : BFD_RELOC_D30V_21_PCREL_R
4677     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4678     to be 0.  Same as the previous reloc but on the right side of the
4679     container.
4680 -- : BFD_RELOC_D30V_32
4681     This is a 32-bit absolute reloc.
4682 -- : BFD_RELOC_D30V_32_PCREL
4683     This is a 32-bit pc-relative reloc.
4684 -- : BFD_RELOC_DLX_HI16_S
4685     DLX relocs
4686 -- : BFD_RELOC_DLX_LO16
4687     DLX relocs
4688 -- : BFD_RELOC_DLX_JMP26
4689     DLX relocs
4690 -- : BFD_RELOC_M32C_HI8
4691 -- : BFD_RELOC_M32C_RL_JUMP
4692 -- : BFD_RELOC_M32C_RL_1ADDR
4693 -- : BFD_RELOC_M32C_RL_2ADDR
4694     Renesas M16C/M32C Relocations.
4695 -- : BFD_RELOC_M32R_24
4696     Renesas M32R (formerly Mitsubishi M32R) relocs.  This is a 24 bit
4697     absolute address.
4698 -- : BFD_RELOC_M32R_10_PCREL
4699     This is a 10-bit pc-relative reloc with the right 2 bits assumed to
4700     be 0.
4701 -- : BFD_RELOC_M32R_18_PCREL
4702     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4703 -- : BFD_RELOC_M32R_26_PCREL
4704     This is a 26-bit reloc with the right 2 bits assumed to be 0.
4705 -- : BFD_RELOC_M32R_HI16_ULO
4706     This is a 16-bit reloc containing the high 16 bits of an address
4707     used when the lower 16 bits are treated as unsigned.
4708 -- : BFD_RELOC_M32R_HI16_SLO
4709     This is a 16-bit reloc containing the high 16 bits of an address
4710     used when the lower 16 bits are treated as signed.
4711 -- : BFD_RELOC_M32R_LO16
4712     This is a 16-bit reloc containing the lower 16 bits of an address.
4713 -- : BFD_RELOC_M32R_SDA16
4714     This is a 16-bit reloc containing the small data area offset for
4715     use in add3, load, and store instructions.
4716 -- : BFD_RELOC_M32R_GOT24
4717 -- : BFD_RELOC_M32R_26_PLTREL
4718 -- : BFD_RELOC_M32R_COPY
4719 -- : BFD_RELOC_M32R_GLOB_DAT
4720 -- : BFD_RELOC_M32R_JMP_SLOT
4721 -- : BFD_RELOC_M32R_RELATIVE
4722 -- : BFD_RELOC_M32R_GOTOFF
4723 -- : BFD_RELOC_M32R_GOTOFF_HI_ULO
4724 -- : BFD_RELOC_M32R_GOTOFF_HI_SLO
4725 -- : BFD_RELOC_M32R_GOTOFF_LO
4726 -- : BFD_RELOC_M32R_GOTPC24
4727 -- : BFD_RELOC_M32R_GOT16_HI_ULO
4728 -- : BFD_RELOC_M32R_GOT16_HI_SLO
4729 -- : BFD_RELOC_M32R_GOT16_LO
4730 -- : BFD_RELOC_M32R_GOTPC_HI_ULO
4731 -- : BFD_RELOC_M32R_GOTPC_HI_SLO
4732 -- : BFD_RELOC_M32R_GOTPC_LO
4733     For PIC.
4734 -- : BFD_RELOC_NDS32_20
4735     NDS32 relocs.  This is a 20 bit absolute address.
4736 -- : BFD_RELOC_NDS32_9_PCREL
4737     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4738     be 0.
4739 -- : BFD_RELOC_NDS32_WORD_9_PCREL
4740     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4741     be 0.
4742 -- : BFD_RELOC_NDS32_15_PCREL
4743     This is an 15-bit reloc with the right 1 bit assumed to be 0.
4744 -- : BFD_RELOC_NDS32_17_PCREL
4745     This is an 17-bit reloc with the right 1 bit assumed to be 0.
4746 -- : BFD_RELOC_NDS32_25_PCREL
4747     This is a 25-bit reloc with the right 1 bit assumed to be 0.
4748 -- : BFD_RELOC_NDS32_HI20
4749     This is a 20-bit reloc containing the high 20 bits of an address
4750     used with the lower 12 bits
4751 -- : BFD_RELOC_NDS32_LO12S3
4752     This is a 12-bit reloc containing the lower 12 bits of an address
4753     then shift right by 3.  This is used with ldi,sdi...
4754 -- : BFD_RELOC_NDS32_LO12S2
4755     This is a 12-bit reloc containing the lower 12 bits of an address
4756     then shift left by 2.  This is used with lwi,swi...
4757 -- : BFD_RELOC_NDS32_LO12S1
4758     This is a 12-bit reloc containing the lower 12 bits of an address
4759     then shift left by 1.  This is used with lhi,shi...
4760 -- : BFD_RELOC_NDS32_LO12S0
4761     This is a 12-bit reloc containing the lower 12 bits of an address
4762     then shift left by 0.  This is used with lbisbi...
4763 -- : BFD_RELOC_NDS32_LO12S0_ORI
4764     This is a 12-bit reloc containing the lower 12 bits of an address
4765     then shift left by 0.  This is only used with branch relaxations
4766 -- : BFD_RELOC_NDS32_SDA15S3
4767     This is a 15-bit reloc containing the small data area 18-bit signed
4768     offset and shift left by 3 for use in ldi, sdi...
4769 -- : BFD_RELOC_NDS32_SDA15S2
4770     This is a 15-bit reloc containing the small data area 17-bit signed
4771     offset and shift left by 2 for use in lwi, swi...
4772 -- : BFD_RELOC_NDS32_SDA15S1
4773     This is a 15-bit reloc containing the small data area 16-bit signed
4774     offset and shift left by 1 for use in lhi, shi...
4775 -- : BFD_RELOC_NDS32_SDA15S0
4776     This is a 15-bit reloc containing the small data area 15-bit signed
4777     offset and shift left by 0 for use in lbi, sbi...
4778 -- : BFD_RELOC_NDS32_SDA16S3
4779     This is a 16-bit reloc containing the small data area 16-bit signed
4780     offset and shift left by 3
4781 -- : BFD_RELOC_NDS32_SDA17S2
4782     This is a 17-bit reloc containing the small data area 17-bit signed
4783     offset and shift left by 2 for use in lwi.gp, swi.gp...
4784 -- : BFD_RELOC_NDS32_SDA18S1
4785     This is a 18-bit reloc containing the small data area 18-bit signed
4786     offset and shift left by 1 for use in lhi.gp, shi.gp...
4787 -- : BFD_RELOC_NDS32_SDA19S0
4788     This is a 19-bit reloc containing the small data area 19-bit signed
4789     offset and shift left by 0 for use in lbi.gp, sbi.gp...
4790 -- : BFD_RELOC_NDS32_GOT20
4791 -- : BFD_RELOC_NDS32_9_PLTREL
4792 -- : BFD_RELOC_NDS32_25_PLTREL
4793 -- : BFD_RELOC_NDS32_COPY
4794 -- : BFD_RELOC_NDS32_GLOB_DAT
4795 -- : BFD_RELOC_NDS32_JMP_SLOT
4796 -- : BFD_RELOC_NDS32_RELATIVE
4797 -- : BFD_RELOC_NDS32_GOTOFF
4798 -- : BFD_RELOC_NDS32_GOTOFF_HI20
4799 -- : BFD_RELOC_NDS32_GOTOFF_LO12
4800 -- : BFD_RELOC_NDS32_GOTPC20
4801 -- : BFD_RELOC_NDS32_GOT_HI20
4802 -- : BFD_RELOC_NDS32_GOT_LO12
4803 -- : BFD_RELOC_NDS32_GOTPC_HI20
4804 -- : BFD_RELOC_NDS32_GOTPC_LO12
4805     for PIC
4806 -- : BFD_RELOC_NDS32_INSN16
4807 -- : BFD_RELOC_NDS32_LABEL
4808 -- : BFD_RELOC_NDS32_LONGCALL1
4809 -- : BFD_RELOC_NDS32_LONGCALL2
4810 -- : BFD_RELOC_NDS32_LONGCALL3
4811 -- : BFD_RELOC_NDS32_LONGJUMP1
4812 -- : BFD_RELOC_NDS32_LONGJUMP2
4813 -- : BFD_RELOC_NDS32_LONGJUMP3
4814 -- : BFD_RELOC_NDS32_LOADSTORE
4815 -- : BFD_RELOC_NDS32_9_FIXED
4816 -- : BFD_RELOC_NDS32_15_FIXED
4817 -- : BFD_RELOC_NDS32_17_FIXED
4818 -- : BFD_RELOC_NDS32_25_FIXED
4819 -- : BFD_RELOC_NDS32_LONGCALL4
4820 -- : BFD_RELOC_NDS32_LONGCALL5
4821 -- : BFD_RELOC_NDS32_LONGCALL6
4822 -- : BFD_RELOC_NDS32_LONGJUMP4
4823 -- : BFD_RELOC_NDS32_LONGJUMP5
4824 -- : BFD_RELOC_NDS32_LONGJUMP6
4825 -- : BFD_RELOC_NDS32_LONGJUMP7
4826     for relax
4827 -- : BFD_RELOC_NDS32_PLTREL_HI20
4828 -- : BFD_RELOC_NDS32_PLTREL_LO12
4829 -- : BFD_RELOC_NDS32_PLT_GOTREL_HI20
4830 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO12
4831     for PIC
4832 -- : BFD_RELOC_NDS32_SDA12S2_DP
4833 -- : BFD_RELOC_NDS32_SDA12S2_SP
4834 -- : BFD_RELOC_NDS32_LO12S2_DP
4835 -- : BFD_RELOC_NDS32_LO12S2_SP
4836     for floating point
4837 -- : BFD_RELOC_NDS32_DWARF2_OP1
4838 -- : BFD_RELOC_NDS32_DWARF2_OP2
4839 -- : BFD_RELOC_NDS32_DWARF2_LEB
4840     for dwarf2 debug_line.
4841 -- : BFD_RELOC_NDS32_UPDATE_TA
4842     for eliminate 16-bit instructions
4843 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO20
4844 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO15
4845 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO19
4846 -- : BFD_RELOC_NDS32_GOT_LO15
4847 -- : BFD_RELOC_NDS32_GOT_LO19
4848 -- : BFD_RELOC_NDS32_GOTOFF_LO15
4849 -- : BFD_RELOC_NDS32_GOTOFF_LO19
4850 -- : BFD_RELOC_NDS32_GOT15S2
4851 -- : BFD_RELOC_NDS32_GOT17S2
4852     for PIC object relaxation
4853 -- : BFD_RELOC_NDS32_5
4854     NDS32 relocs.  This is a 5 bit absolute address.
4855 -- : BFD_RELOC_NDS32_10_UPCREL
4856     This is a 10-bit unsigned pc-relative reloc with the right 1 bit
4857     assumed to be 0.
4858 -- : BFD_RELOC_NDS32_SDA_FP7U2_RELA
4859     If fp were omitted, fp can used as another gp.
4860 -- : BFD_RELOC_NDS32_RELAX_ENTRY
4861 -- : BFD_RELOC_NDS32_GOT_SUFF
4862 -- : BFD_RELOC_NDS32_GOTOFF_SUFF
4863 -- : BFD_RELOC_NDS32_PLT_GOT_SUFF
4864 -- : BFD_RELOC_NDS32_MULCALL_SUFF
4865 -- : BFD_RELOC_NDS32_PTR
4866 -- : BFD_RELOC_NDS32_PTR_COUNT
4867 -- : BFD_RELOC_NDS32_PTR_RESOLVED
4868 -- : BFD_RELOC_NDS32_PLTBLOCK
4869 -- : BFD_RELOC_NDS32_RELAX_REGION_BEGIN
4870 -- : BFD_RELOC_NDS32_RELAX_REGION_END
4871 -- : BFD_RELOC_NDS32_MINUEND
4872 -- : BFD_RELOC_NDS32_SUBTRAHEND
4873 -- : BFD_RELOC_NDS32_DIFF8
4874 -- : BFD_RELOC_NDS32_DIFF16
4875 -- : BFD_RELOC_NDS32_DIFF32
4876 -- : BFD_RELOC_NDS32_DIFF_ULEB128
4877 -- : BFD_RELOC_NDS32_EMPTY
4878     relaxation relative relocation types
4879 -- : BFD_RELOC_NDS32_25_ABS
4880     This is a 25 bit absolute address.
4881 -- : BFD_RELOC_NDS32_DATA
4882 -- : BFD_RELOC_NDS32_TRAN
4883 -- : BFD_RELOC_NDS32_17IFC_PCREL
4884 -- : BFD_RELOC_NDS32_10IFCU_PCREL
4885     For ex9 and ifc using.
4886 -- : BFD_RELOC_NDS32_TPOFF
4887 -- : BFD_RELOC_NDS32_TLS_LE_HI20
4888 -- : BFD_RELOC_NDS32_TLS_LE_LO12
4889 -- : BFD_RELOC_NDS32_TLS_LE_ADD
4890 -- : BFD_RELOC_NDS32_TLS_LE_LS
4891 -- : BFD_RELOC_NDS32_GOTTPOFF
4892 -- : BFD_RELOC_NDS32_TLS_IE_HI20
4893 -- : BFD_RELOC_NDS32_TLS_IE_LO12S2
4894 -- : BFD_RELOC_NDS32_TLS_TPOFF
4895 -- : BFD_RELOC_NDS32_TLS_LE_20
4896 -- : BFD_RELOC_NDS32_TLS_LE_15S0
4897 -- : BFD_RELOC_NDS32_TLS_LE_15S1
4898 -- : BFD_RELOC_NDS32_TLS_LE_15S2
4899     For TLS.
4900 -- : BFD_RELOC_V850_9_PCREL
4901     This is a 9-bit reloc
4902 -- : BFD_RELOC_V850_22_PCREL
4903     This is a 22-bit reloc
4904 -- : BFD_RELOC_V850_SDA_16_16_OFFSET
4905     This is a 16 bit offset from the short data area pointer.
4906 -- : BFD_RELOC_V850_SDA_15_16_OFFSET
4907     This is a 16 bit offset (of which only 15 bits are used) from the
4908     short data area pointer.
4909 -- : BFD_RELOC_V850_ZDA_16_16_OFFSET
4910     This is a 16 bit offset from the zero data area pointer.
4911 -- : BFD_RELOC_V850_ZDA_15_16_OFFSET
4912     This is a 16 bit offset (of which only 15 bits are used) from the
4913     zero data area pointer.
4914 -- : BFD_RELOC_V850_TDA_6_8_OFFSET
4915     This is an 8 bit offset (of which only 6 bits are used) from the
4916     tiny data area pointer.
4917 -- : BFD_RELOC_V850_TDA_7_8_OFFSET
4918     This is an 8bit offset (of which only 7 bits are used) from the
4919     tiny data area pointer.
4920 -- : BFD_RELOC_V850_TDA_7_7_OFFSET
4921     This is a 7 bit offset from the tiny data area pointer.
4922 -- : BFD_RELOC_V850_TDA_16_16_OFFSET
4923     This is a 16 bit offset from the tiny data area pointer.
4924 -- : BFD_RELOC_V850_TDA_4_5_OFFSET
4925     This is a 5 bit offset (of which only 4 bits are used) from the
4926     tiny data area pointer.
4927 -- : BFD_RELOC_V850_TDA_4_4_OFFSET
4928     This is a 4 bit offset from the tiny data area pointer.
4929 -- : BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
4930     This is a 16 bit offset from the short data area pointer, with the
4931     bits placed non-contiguously in the instruction.
4932 -- : BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
4933     This is a 16 bit offset from the zero data area pointer, with the
4934     bits placed non-contiguously in the instruction.
4935 -- : BFD_RELOC_V850_CALLT_6_7_OFFSET
4936     This is a 6 bit offset from the call table base pointer.
4937 -- : BFD_RELOC_V850_CALLT_16_16_OFFSET
4938     This is a 16 bit offset from the call table base pointer.
4939 -- : BFD_RELOC_V850_LONGCALL
4940     Used for relaxing indirect function calls.
4941 -- : BFD_RELOC_V850_LONGJUMP
4942     Used for relaxing indirect jumps.
4943 -- : BFD_RELOC_V850_ALIGN
4944     Used to maintain alignment whilst relaxing.
4945 -- : BFD_RELOC_V850_LO16_SPLIT_OFFSET
4946     This is a variation of BFD_RELOC_LO16 that can be used in v850e
4947     ld.bu instructions.
4948 -- : BFD_RELOC_V850_16_PCREL
4949     This is a 16-bit reloc.
4950 -- : BFD_RELOC_V850_17_PCREL
4951     This is a 17-bit reloc.
4952 -- : BFD_RELOC_V850_23
4953     This is a 23-bit reloc.
4954 -- : BFD_RELOC_V850_32_PCREL
4955     This is a 32-bit reloc.
4956 -- : BFD_RELOC_V850_32_ABS
4957     This is a 32-bit reloc.
4958 -- : BFD_RELOC_V850_16_SPLIT_OFFSET
4959     This is a 16-bit reloc.
4960 -- : BFD_RELOC_V850_16_S1
4961     This is a 16-bit reloc.
4962 -- : BFD_RELOC_V850_LO16_S1
4963     Low 16 bits.  16 bit shifted by 1.
4964 -- : BFD_RELOC_V850_CALLT_15_16_OFFSET
4965     This is a 16 bit offset from the call table base pointer.
4966 -- : BFD_RELOC_V850_32_GOTPCREL
4967     DSO relocations.
4968 -- : BFD_RELOC_V850_16_GOT
4969     DSO relocations.
4970 -- : BFD_RELOC_V850_32_GOT
4971     DSO relocations.
4972 -- : BFD_RELOC_V850_22_PLT_PCREL
4973     DSO relocations.
4974 -- : BFD_RELOC_V850_32_PLT_PCREL
4975     DSO relocations.
4976 -- : BFD_RELOC_V850_COPY
4977     DSO relocations.
4978 -- : BFD_RELOC_V850_GLOB_DAT
4979     DSO relocations.
4980 -- : BFD_RELOC_V850_JMP_SLOT
4981     DSO relocations.
4982 -- : BFD_RELOC_V850_RELATIVE
4983     DSO relocations.
4984 -- : BFD_RELOC_V850_16_GOTOFF
4985     DSO relocations.
4986 -- : BFD_RELOC_V850_32_GOTOFF
4987     DSO relocations.
4988 -- : BFD_RELOC_V850_CODE
4989     start code.
4990 -- : BFD_RELOC_V850_DATA
4991     start data in text.
4992 -- : BFD_RELOC_TIC30_LDP
4993     This is a 8bit DP reloc for the tms320c30, where the most
4994     significant 8 bits of a 24 bit word are placed into the least
4995     significant 8 bits of the opcode.
4996 -- : BFD_RELOC_TIC54X_PARTLS7
4997     This is a 7bit reloc for the tms320c54x, where the least
4998     significant 7 bits of a 16 bit word are placed into the least
4999     significant 7 bits of the opcode.
5000 -- : BFD_RELOC_TIC54X_PARTMS9
5001     This is a 9bit DP reloc for the tms320c54x, where the most
5002     significant 9 bits of a 16 bit word are placed into the least
5003     significant 9 bits of the opcode.
5004 -- : BFD_RELOC_TIC54X_23
5005     This is an extended address 23-bit reloc for the tms320c54x.
5006 -- : BFD_RELOC_TIC54X_16_OF_23
5007     This is a 16-bit reloc for the tms320c54x, where the least
5008     significant 16 bits of a 23-bit extended address are placed into
5009     the opcode.
5010 -- : BFD_RELOC_TIC54X_MS7_OF_23
5011     This is a reloc for the tms320c54x, where the most significant 7
5012     bits of a 23-bit extended address are placed into the opcode.
5013 -- : BFD_RELOC_C6000_PCR_S21
5014 -- : BFD_RELOC_C6000_PCR_S12
5015 -- : BFD_RELOC_C6000_PCR_S10
5016 -- : BFD_RELOC_C6000_PCR_S7
5017 -- : BFD_RELOC_C6000_ABS_S16
5018 -- : BFD_RELOC_C6000_ABS_L16
5019 -- : BFD_RELOC_C6000_ABS_H16
5020 -- : BFD_RELOC_C6000_SBR_U15_B
5021 -- : BFD_RELOC_C6000_SBR_U15_H
5022 -- : BFD_RELOC_C6000_SBR_U15_W
5023 -- : BFD_RELOC_C6000_SBR_S16
5024 -- : BFD_RELOC_C6000_SBR_L16_B
5025 -- : BFD_RELOC_C6000_SBR_L16_H
5026 -- : BFD_RELOC_C6000_SBR_L16_W
5027 -- : BFD_RELOC_C6000_SBR_H16_B
5028 -- : BFD_RELOC_C6000_SBR_H16_H
5029 -- : BFD_RELOC_C6000_SBR_H16_W
5030 -- : BFD_RELOC_C6000_SBR_GOT_U15_W
5031 -- : BFD_RELOC_C6000_SBR_GOT_L16_W
5032 -- : BFD_RELOC_C6000_SBR_GOT_H16_W
5033 -- : BFD_RELOC_C6000_DSBT_INDEX
5034 -- : BFD_RELOC_C6000_PREL31
5035 -- : BFD_RELOC_C6000_COPY
5036 -- : BFD_RELOC_C6000_JUMP_SLOT
5037 -- : BFD_RELOC_C6000_EHTYPE
5038 -- : BFD_RELOC_C6000_PCR_H16
5039 -- : BFD_RELOC_C6000_PCR_L16
5040 -- : BFD_RELOC_C6000_ALIGN
5041 -- : BFD_RELOC_C6000_FPHEAD
5042 -- : BFD_RELOC_C6000_NOCMP
5043     TMS320C6000 relocations.
5044 -- : BFD_RELOC_FR30_48
5045     This is a 48 bit reloc for the FR30 that stores 32 bits.
5046 -- : BFD_RELOC_FR30_20
5047     This is a 32 bit reloc for the FR30 that stores 20 bits split up
5048     into two sections.
5049 -- : BFD_RELOC_FR30_6_IN_4
5050     This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
5051     in 4 bits.
5052 -- : BFD_RELOC_FR30_8_IN_8
5053     This is a 16 bit reloc for the FR30 that stores an 8 bit byte
5054     offset into 8 bits.
5055 -- : BFD_RELOC_FR30_9_IN_8
5056     This is a 16 bit reloc for the FR30 that stores a 9 bit short
5057     offset into 8 bits.
5058 -- : BFD_RELOC_FR30_10_IN_8
5059     This is a 16 bit reloc for the FR30 that stores a 10 bit word
5060     offset into 8 bits.
5061 -- : BFD_RELOC_FR30_9_PCREL
5062     This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
5063     short offset into 8 bits.
5064 -- : BFD_RELOC_FR30_12_PCREL
5065     This is a 16 bit reloc for the FR30 that stores a 12 bit pc
5066     relative short offset into 11 bits.
5067 -- : BFD_RELOC_MCORE_PCREL_IMM8BY4
5068 -- : BFD_RELOC_MCORE_PCREL_IMM11BY2
5069 -- : BFD_RELOC_MCORE_PCREL_IMM4BY2
5070 -- : BFD_RELOC_MCORE_PCREL_32
5071 -- : BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
5072 -- : BFD_RELOC_MCORE_RVA
5073     Motorola Mcore relocations.
5074 -- : BFD_RELOC_MEP_8
5075 -- : BFD_RELOC_MEP_16
5076 -- : BFD_RELOC_MEP_32
5077 -- : BFD_RELOC_MEP_PCREL8A2
5078 -- : BFD_RELOC_MEP_PCREL12A2
5079 -- : BFD_RELOC_MEP_PCREL17A2
5080 -- : BFD_RELOC_MEP_PCREL24A2
5081 -- : BFD_RELOC_MEP_PCABS24A2
5082 -- : BFD_RELOC_MEP_LOW16
5083 -- : BFD_RELOC_MEP_HI16U
5084 -- : BFD_RELOC_MEP_HI16S
5085 -- : BFD_RELOC_MEP_GPREL
5086 -- : BFD_RELOC_MEP_TPREL
5087 -- : BFD_RELOC_MEP_TPREL7
5088 -- : BFD_RELOC_MEP_TPREL7A2
5089 -- : BFD_RELOC_MEP_TPREL7A4
5090 -- : BFD_RELOC_MEP_UIMM24
5091 -- : BFD_RELOC_MEP_ADDR24A4
5092 -- : BFD_RELOC_MEP_GNU_VTINHERIT
5093 -- : BFD_RELOC_MEP_GNU_VTENTRY
5094     Toshiba Media Processor Relocations.
5095 -- : BFD_RELOC_METAG_HIADDR16
5096 -- : BFD_RELOC_METAG_LOADDR16
5097 -- : BFD_RELOC_METAG_RELBRANCH
5098 -- : BFD_RELOC_METAG_GETSETOFF
5099 -- : BFD_RELOC_METAG_HIOG
5100 -- : BFD_RELOC_METAG_LOOG
5101 -- : BFD_RELOC_METAG_REL8
5102 -- : BFD_RELOC_METAG_REL16
5103 -- : BFD_RELOC_METAG_HI16_GOTOFF
5104 -- : BFD_RELOC_METAG_LO16_GOTOFF
5105 -- : BFD_RELOC_METAG_GETSET_GOTOFF
5106 -- : BFD_RELOC_METAG_GETSET_GOT
5107 -- : BFD_RELOC_METAG_HI16_GOTPC
5108 -- : BFD_RELOC_METAG_LO16_GOTPC
5109 -- : BFD_RELOC_METAG_HI16_PLT
5110 -- : BFD_RELOC_METAG_LO16_PLT
5111 -- : BFD_RELOC_METAG_RELBRANCH_PLT
5112 -- : BFD_RELOC_METAG_GOTOFF
5113 -- : BFD_RELOC_METAG_PLT
5114 -- : BFD_RELOC_METAG_COPY
5115 -- : BFD_RELOC_METAG_JMP_SLOT
5116 -- : BFD_RELOC_METAG_RELATIVE
5117 -- : BFD_RELOC_METAG_GLOB_DAT
5118 -- : BFD_RELOC_METAG_TLS_GD
5119 -- : BFD_RELOC_METAG_TLS_LDM
5120 -- : BFD_RELOC_METAG_TLS_LDO_HI16
5121 -- : BFD_RELOC_METAG_TLS_LDO_LO16
5122 -- : BFD_RELOC_METAG_TLS_LDO
5123 -- : BFD_RELOC_METAG_TLS_IE
5124 -- : BFD_RELOC_METAG_TLS_IENONPIC
5125 -- : BFD_RELOC_METAG_TLS_IENONPIC_HI16
5126 -- : BFD_RELOC_METAG_TLS_IENONPIC_LO16
5127 -- : BFD_RELOC_METAG_TLS_TPOFF
5128 -- : BFD_RELOC_METAG_TLS_DTPMOD
5129 -- : BFD_RELOC_METAG_TLS_DTPOFF
5130 -- : BFD_RELOC_METAG_TLS_LE
5131 -- : BFD_RELOC_METAG_TLS_LE_HI16
5132 -- : BFD_RELOC_METAG_TLS_LE_LO16
5133     Imagination Technologies Meta relocations.
5134 -- : BFD_RELOC_MMIX_GETA
5135 -- : BFD_RELOC_MMIX_GETA_1
5136 -- : BFD_RELOC_MMIX_GETA_2
5137 -- : BFD_RELOC_MMIX_GETA_3
5138     These are relocations for the GETA instruction.
5139 -- : BFD_RELOC_MMIX_CBRANCH
5140 -- : BFD_RELOC_MMIX_CBRANCH_J
5141 -- : BFD_RELOC_MMIX_CBRANCH_1
5142 -- : BFD_RELOC_MMIX_CBRANCH_2
5143 -- : BFD_RELOC_MMIX_CBRANCH_3
5144     These are relocations for a conditional branch instruction.
5145 -- : BFD_RELOC_MMIX_PUSHJ
5146 -- : BFD_RELOC_MMIX_PUSHJ_1
5147 -- : BFD_RELOC_MMIX_PUSHJ_2
5148 -- : BFD_RELOC_MMIX_PUSHJ_3
5149 -- : BFD_RELOC_MMIX_PUSHJ_STUBBABLE
5150     These are relocations for the PUSHJ instruction.
5151 -- : BFD_RELOC_MMIX_JMP
5152 -- : BFD_RELOC_MMIX_JMP_1
5153 -- : BFD_RELOC_MMIX_JMP_2
5154 -- : BFD_RELOC_MMIX_JMP_3
5155     These are relocations for the JMP instruction.
5156 -- : BFD_RELOC_MMIX_ADDR19
5157     This is a relocation for a relative address as in a GETA
5158     instruction or a branch.
5159 -- : BFD_RELOC_MMIX_ADDR27
5160     This is a relocation for a relative address as in a JMP
5161     instruction.
5162 -- : BFD_RELOC_MMIX_REG_OR_BYTE
5163     This is a relocation for an instruction field that may be a general
5164     register or a value 0..255.
5165 -- : BFD_RELOC_MMIX_REG
5166     This is a relocation for an instruction field that may be a general
5167     register.
5168 -- : BFD_RELOC_MMIX_BASE_PLUS_OFFSET
5169     This is a relocation for two instruction fields holding a register
5170     and an offset, the equivalent of the relocation.
5171 -- : BFD_RELOC_MMIX_LOCAL
5172     This relocation is an assertion that the expression is not
5173     allocated as a global register.  It does not modify contents.
5174 -- : BFD_RELOC_AVR_7_PCREL
5175     This is a 16 bit reloc for the AVR that stores 8 bit pc relative
5176     short offset into 7 bits.
5177 -- : BFD_RELOC_AVR_13_PCREL
5178     This is a 16 bit reloc for the AVR that stores 13 bit pc relative
5179     short offset into 12 bits.
5180 -- : BFD_RELOC_AVR_16_PM
5181     This is a 16 bit reloc for the AVR that stores 17 bit value
5182     (usually program memory address) into 16 bits.
5183 -- : BFD_RELOC_AVR_LO8_LDI
5184     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5185     data memory address) into 8 bit immediate value of LDI insn.
5186 -- : BFD_RELOC_AVR_HI8_LDI
5187     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5188     bit of data memory address) into 8 bit immediate value of LDI insn.
5189 -- : BFD_RELOC_AVR_HH8_LDI
5190     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5191     high 8 bit of program memory address) into 8 bit immediate value of
5192     LDI insn.
5193 -- : BFD_RELOC_AVR_MS8_LDI
5194     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5195     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.
5196 -- : BFD_RELOC_AVR_LO8_LDI_NEG
5197     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5198     (usually data memory address) into 8 bit immediate value of SUBI
5199     insn.
5200 -- : BFD_RELOC_AVR_HI8_LDI_NEG
5201     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5202     (high 8 bit of data memory address) into 8 bit immediate value of
5203     SUBI insn.
5204 -- : BFD_RELOC_AVR_HH8_LDI_NEG
5205     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5206     (most high 8 bit of program memory address) into 8 bit immediate
5207     value of LDI or SUBI insn.
5208 -- : BFD_RELOC_AVR_MS8_LDI_NEG
5209     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5210     (msb of 32 bit value) into 8 bit immediate value of LDI insn.
5211 -- : BFD_RELOC_AVR_LO8_LDI_PM
5212     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5213     command address) into 8 bit immediate value of LDI insn.
5214 -- : BFD_RELOC_AVR_LO8_LDI_GS
5215     This is a 16 bit reloc for the AVR that stores 8 bit value (command
5216     address) into 8 bit immediate value of LDI insn.  If the address is
5217     beyond the 128k boundary, the linker inserts a jump stub for this
5218     reloc in the lower 128k.
5219 -- : BFD_RELOC_AVR_HI8_LDI_PM
5220     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5221     bit of command address) into 8 bit immediate value of LDI insn.
5222 -- : BFD_RELOC_AVR_HI8_LDI_GS
5223     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5224     bit of command address) into 8 bit immediate value of LDI insn.  If
5225     the address is beyond the 128k boundary, the linker inserts a jump
5226     stub for this reloc below 128k.
5227 -- : BFD_RELOC_AVR_HH8_LDI_PM
5228     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5229     high 8 bit of command address) into 8 bit immediate value of LDI
5230     insn.
5231 -- : BFD_RELOC_AVR_LO8_LDI_PM_NEG
5232     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5233     (usually command address) into 8 bit immediate value of SUBI insn.
5234 -- : BFD_RELOC_AVR_HI8_LDI_PM_NEG
5235     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5236     (high 8 bit of 16 bit command address) into 8 bit immediate value
5237     of SUBI insn.
5238 -- : BFD_RELOC_AVR_HH8_LDI_PM_NEG
5239     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5240     (high 6 bit of 22 bit command address) into 8 bit immediate value
5241     of SUBI insn.
5242 -- : BFD_RELOC_AVR_CALL
5243     This is a 32 bit reloc for the AVR that stores 23 bit value into 22
5244     bits.
5245 -- : BFD_RELOC_AVR_LDI
5246     This is a 16 bit reloc for the AVR that stores all needed bits for
5247     absolute addressing with ldi with overflow check to linktime
5248 -- : BFD_RELOC_AVR_6
5249     This is a 6 bit reloc for the AVR that stores offset for ldd/std
5250     instructions
5251 -- : BFD_RELOC_AVR_6_ADIW
5252     This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
5253     instructions
5254 -- : BFD_RELOC_AVR_8_LO
5255     This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
5256     in .byte lo8(symbol)
5257 -- : BFD_RELOC_AVR_8_HI
5258     This is a 8 bit reloc for the AVR that stores bits 8..15 of a
5259     symbol in .byte hi8(symbol)
5260 -- : BFD_RELOC_AVR_8_HLO
5261     This is a 8 bit reloc for the AVR that stores bits 16..23 of a
5262     symbol in .byte hlo8(symbol)
5263 -- : BFD_RELOC_AVR_DIFF8
5264 -- : BFD_RELOC_AVR_DIFF16
5265 -- : BFD_RELOC_AVR_DIFF32
5266     AVR relocations to mark the difference of two local symbols.  These
5267     are only needed to support linker relaxation and can be ignored
5268     when not relaxing.  The field is set to the value of the difference
5269     assuming no relaxation.  The relocation encodes the position of the
5270     second symbol so the linker can determine whether to adjust the
5271     field value.
5272 -- : BFD_RELOC_AVR_LDS_STS_16
5273     This is a 7 bit reloc for the AVR that stores SRAM address for
5274     16bit lds and sts instructions supported only tiny core.
5275 -- : BFD_RELOC_AVR_PORT6
5276     This is a 6 bit reloc for the AVR that stores an I/O register
5277     number for the IN and OUT instructions
5278 -- : BFD_RELOC_AVR_PORT5
5279     This is a 5 bit reloc for the AVR that stores an I/O register
5280     number for the SBIC, SBIS, SBI and CBI instructions
5281 -- : BFD_RELOC_RISCV_HI20
5282 -- : BFD_RELOC_RISCV_PCREL_HI20
5283 -- : BFD_RELOC_RISCV_PCREL_LO12_I
5284 -- : BFD_RELOC_RISCV_PCREL_LO12_S
5285 -- : BFD_RELOC_RISCV_LO12_I
5286 -- : BFD_RELOC_RISCV_LO12_S
5287 -- : BFD_RELOC_RISCV_GPREL12_I
5288 -- : BFD_RELOC_RISCV_GPREL12_S
5289 -- : BFD_RELOC_RISCV_TPREL_HI20
5290 -- : BFD_RELOC_RISCV_TPREL_LO12_I
5291 -- : BFD_RELOC_RISCV_TPREL_LO12_S
5292 -- : BFD_RELOC_RISCV_TPREL_ADD
5293 -- : BFD_RELOC_RISCV_CALL
5294 -- : BFD_RELOC_RISCV_CALL_PLT
5295 -- : BFD_RELOC_RISCV_ADD8
5296 -- : BFD_RELOC_RISCV_ADD16
5297 -- : BFD_RELOC_RISCV_ADD32
5298 -- : BFD_RELOC_RISCV_ADD64
5299 -- : BFD_RELOC_RISCV_SUB8
5300 -- : BFD_RELOC_RISCV_SUB16
5301 -- : BFD_RELOC_RISCV_SUB32
5302 -- : BFD_RELOC_RISCV_SUB64
5303 -- : BFD_RELOC_RISCV_GOT_HI20
5304 -- : BFD_RELOC_RISCV_TLS_GOT_HI20
5305 -- : BFD_RELOC_RISCV_TLS_GD_HI20
5306 -- : BFD_RELOC_RISCV_JMP
5307 -- : BFD_RELOC_RISCV_TLS_DTPMOD32
5308 -- : BFD_RELOC_RISCV_TLS_DTPREL32
5309 -- : BFD_RELOC_RISCV_TLS_DTPMOD64
5310 -- : BFD_RELOC_RISCV_TLS_DTPREL64
5311 -- : BFD_RELOC_RISCV_TLS_TPREL32
5312 -- : BFD_RELOC_RISCV_TLS_TPREL64
5313 -- : BFD_RELOC_RISCV_ALIGN
5314 -- : BFD_RELOC_RISCV_RVC_BRANCH
5315 -- : BFD_RELOC_RISCV_RVC_JUMP
5316 -- : BFD_RELOC_RISCV_RVC_LUI
5317 -- : BFD_RELOC_RISCV_GPREL_I
5318 -- : BFD_RELOC_RISCV_GPREL_S
5319 -- : BFD_RELOC_RISCV_TPREL_I
5320 -- : BFD_RELOC_RISCV_TPREL_S
5321 -- : BFD_RELOC_RISCV_RELAX
5322 -- : BFD_RELOC_RISCV_CFA
5323 -- : BFD_RELOC_RISCV_SUB6
5324 -- : BFD_RELOC_RISCV_SET6
5325 -- : BFD_RELOC_RISCV_SET8
5326 -- : BFD_RELOC_RISCV_SET16
5327 -- : BFD_RELOC_RISCV_SET32
5328 -- : BFD_RELOC_RISCV_32_PCREL
5329     RISC-V relocations.
5330 -- : BFD_RELOC_RL78_NEG8
5331 -- : BFD_RELOC_RL78_NEG16
5332 -- : BFD_RELOC_RL78_NEG24
5333 -- : BFD_RELOC_RL78_NEG32
5334 -- : BFD_RELOC_RL78_16_OP
5335 -- : BFD_RELOC_RL78_24_OP
5336 -- : BFD_RELOC_RL78_32_OP
5337 -- : BFD_RELOC_RL78_8U
5338 -- : BFD_RELOC_RL78_16U
5339 -- : BFD_RELOC_RL78_24U
5340 -- : BFD_RELOC_RL78_DIR3U_PCREL
5341 -- : BFD_RELOC_RL78_DIFF
5342 -- : BFD_RELOC_RL78_GPRELB
5343 -- : BFD_RELOC_RL78_GPRELW
5344 -- : BFD_RELOC_RL78_GPRELL
5345 -- : BFD_RELOC_RL78_SYM
5346 -- : BFD_RELOC_RL78_OP_SUBTRACT
5347 -- : BFD_RELOC_RL78_OP_NEG
5348 -- : BFD_RELOC_RL78_OP_AND
5349 -- : BFD_RELOC_RL78_OP_SHRA
5350 -- : BFD_RELOC_RL78_ABS8
5351 -- : BFD_RELOC_RL78_ABS16
5352 -- : BFD_RELOC_RL78_ABS16_REV
5353 -- : BFD_RELOC_RL78_ABS32
5354 -- : BFD_RELOC_RL78_ABS32_REV
5355 -- : BFD_RELOC_RL78_ABS16U
5356 -- : BFD_RELOC_RL78_ABS16UW
5357 -- : BFD_RELOC_RL78_ABS16UL
5358 -- : BFD_RELOC_RL78_RELAX
5359 -- : BFD_RELOC_RL78_HI16
5360 -- : BFD_RELOC_RL78_HI8
5361 -- : BFD_RELOC_RL78_LO16
5362 -- : BFD_RELOC_RL78_CODE
5363 -- : BFD_RELOC_RL78_SADDR
5364     Renesas RL78 Relocations.
5365 -- : BFD_RELOC_RX_NEG8
5366 -- : BFD_RELOC_RX_NEG16
5367 -- : BFD_RELOC_RX_NEG24
5368 -- : BFD_RELOC_RX_NEG32
5369 -- : BFD_RELOC_RX_16_OP
5370 -- : BFD_RELOC_RX_24_OP
5371 -- : BFD_RELOC_RX_32_OP
5372 -- : BFD_RELOC_RX_8U
5373 -- : BFD_RELOC_RX_16U
5374 -- : BFD_RELOC_RX_24U
5375 -- : BFD_RELOC_RX_DIR3U_PCREL
5376 -- : BFD_RELOC_RX_DIFF
5377 -- : BFD_RELOC_RX_GPRELB
5378 -- : BFD_RELOC_RX_GPRELW
5379 -- : BFD_RELOC_RX_GPRELL
5380 -- : BFD_RELOC_RX_SYM
5381 -- : BFD_RELOC_RX_OP_SUBTRACT
5382 -- : BFD_RELOC_RX_OP_NEG
5383 -- : BFD_RELOC_RX_ABS8
5384 -- : BFD_RELOC_RX_ABS16
5385 -- : BFD_RELOC_RX_ABS16_REV
5386 -- : BFD_RELOC_RX_ABS32
5387 -- : BFD_RELOC_RX_ABS32_REV
5388 -- : BFD_RELOC_RX_ABS16U
5389 -- : BFD_RELOC_RX_ABS16UW
5390 -- : BFD_RELOC_RX_ABS16UL
5391 -- : BFD_RELOC_RX_RELAX
5392     Renesas RX Relocations.
5393 -- : BFD_RELOC_390_12
5394     Direct 12 bit.
5395 -- : BFD_RELOC_390_GOT12
5396     12 bit GOT offset.
5397 -- : BFD_RELOC_390_PLT32
5398     32 bit PC relative PLT address.
5399 -- : BFD_RELOC_390_COPY
5400     Copy symbol at runtime.
5401 -- : BFD_RELOC_390_GLOB_DAT
5402     Create GOT entry.
5403 -- : BFD_RELOC_390_JMP_SLOT
5404     Create PLT entry.
5405 -- : BFD_RELOC_390_RELATIVE
5406     Adjust by program base.
5407 -- : BFD_RELOC_390_GOTPC
5408     32 bit PC relative offset to GOT.
5409 -- : BFD_RELOC_390_GOT16
5410     16 bit GOT offset.
5411 -- : BFD_RELOC_390_PC12DBL
5412     PC relative 12 bit shifted by 1.
5413 -- : BFD_RELOC_390_PLT12DBL
5414     12 bit PC rel.  PLT shifted by 1.
5415 -- : BFD_RELOC_390_PC16DBL
5416     PC relative 16 bit shifted by 1.
5417 -- : BFD_RELOC_390_PLT16DBL
5418     16 bit PC rel.  PLT shifted by 1.
5419 -- : BFD_RELOC_390_PC24DBL
5420     PC relative 24 bit shifted by 1.
5421 -- : BFD_RELOC_390_PLT24DBL
5422     24 bit PC rel.  PLT shifted by 1.
5423 -- : BFD_RELOC_390_PC32DBL
5424     PC relative 32 bit shifted by 1.
5425 -- : BFD_RELOC_390_PLT32DBL
5426     32 bit PC rel.  PLT shifted by 1.
5427 -- : BFD_RELOC_390_GOTPCDBL
5428     32 bit PC rel.  GOT shifted by 1.
5429 -- : BFD_RELOC_390_GOT64
5430     64 bit GOT offset.
5431 -- : BFD_RELOC_390_PLT64
5432     64 bit PC relative PLT address.
5433 -- : BFD_RELOC_390_GOTENT
5434     32 bit rel.  offset to GOT entry.
5435 -- : BFD_RELOC_390_GOTOFF64
5436     64 bit offset to GOT.
5437 -- : BFD_RELOC_390_GOTPLT12
5438     12-bit offset to symbol-entry within GOT, with PLT handling.
5439 -- : BFD_RELOC_390_GOTPLT16
5440     16-bit offset to symbol-entry within GOT, with PLT handling.
5441 -- : BFD_RELOC_390_GOTPLT32
5442     32-bit offset to symbol-entry within GOT, with PLT handling.
5443 -- : BFD_RELOC_390_GOTPLT64
5444     64-bit offset to symbol-entry within GOT, with PLT handling.
5445 -- : BFD_RELOC_390_GOTPLTENT
5446     32-bit rel.  offset to symbol-entry within GOT, with PLT handling.
5447 -- : BFD_RELOC_390_PLTOFF16
5448     16-bit rel.  offset from the GOT to a PLT entry.
5449 -- : BFD_RELOC_390_PLTOFF32
5450     32-bit rel.  offset from the GOT to a PLT entry.
5451 -- : BFD_RELOC_390_PLTOFF64
5452     64-bit rel.  offset from the GOT to a PLT entry.
5453 -- : BFD_RELOC_390_TLS_LOAD
5454 -- : BFD_RELOC_390_TLS_GDCALL
5455 -- : BFD_RELOC_390_TLS_LDCALL
5456 -- : BFD_RELOC_390_TLS_GD32
5457 -- : BFD_RELOC_390_TLS_GD64
5458 -- : BFD_RELOC_390_TLS_GOTIE12
5459 -- : BFD_RELOC_390_TLS_GOTIE32
5460 -- : BFD_RELOC_390_TLS_GOTIE64
5461 -- : BFD_RELOC_390_TLS_LDM32
5462 -- : BFD_RELOC_390_TLS_LDM64
5463 -- : BFD_RELOC_390_TLS_IE32
5464 -- : BFD_RELOC_390_TLS_IE64
5465 -- : BFD_RELOC_390_TLS_IEENT
5466 -- : BFD_RELOC_390_TLS_LE32
5467 -- : BFD_RELOC_390_TLS_LE64
5468 -- : BFD_RELOC_390_TLS_LDO32
5469 -- : BFD_RELOC_390_TLS_LDO64
5470 -- : BFD_RELOC_390_TLS_DTPMOD
5471 -- : BFD_RELOC_390_TLS_DTPOFF
5472 -- : BFD_RELOC_390_TLS_TPOFF
5473     s390 tls relocations.
5474 -- : BFD_RELOC_390_20
5475 -- : BFD_RELOC_390_GOT20
5476 -- : BFD_RELOC_390_GOTPLT20
5477 -- : BFD_RELOC_390_TLS_GOTIE20
5478     Long displacement extension.
5479 -- : BFD_RELOC_390_IRELATIVE
5480     STT_GNU_IFUNC relocation.
5481 -- : BFD_RELOC_SCORE_GPREL15
5482     Score relocations Low 16 bit for load/store
5483 -- : BFD_RELOC_SCORE_DUMMY2
5484 -- : BFD_RELOC_SCORE_JMP
5485     This is a 24-bit reloc with the right 1 bit assumed to be 0
5486 -- : BFD_RELOC_SCORE_BRANCH
5487     This is a 19-bit reloc with the right 1 bit assumed to be 0
5488 -- : BFD_RELOC_SCORE_IMM30
5489     This is a 32-bit reloc for 48-bit instructions.
5490 -- : BFD_RELOC_SCORE_IMM32
5491     This is a 32-bit reloc for 48-bit instructions.
5492 -- : BFD_RELOC_SCORE16_JMP
5493     This is a 11-bit reloc with the right 1 bit assumed to be 0
5494 -- : BFD_RELOC_SCORE16_BRANCH
5495     This is a 8-bit reloc with the right 1 bit assumed to be 0
5496 -- : BFD_RELOC_SCORE_BCMP
5497     This is a 9-bit reloc with the right 1 bit assumed to be 0
5498 -- : BFD_RELOC_SCORE_GOT15
5499 -- : BFD_RELOC_SCORE_GOT_LO16
5500 -- : BFD_RELOC_SCORE_CALL15
5501 -- : BFD_RELOC_SCORE_DUMMY_HI16
5502     Undocumented Score relocs
5503 -- : BFD_RELOC_IP2K_FR9
5504     Scenix IP2K - 9-bit register number / data address
5505 -- : BFD_RELOC_IP2K_BANK
5506     Scenix IP2K - 4-bit register/data bank number
5507 -- : BFD_RELOC_IP2K_ADDR16CJP
5508     Scenix IP2K - low 13 bits of instruction word address
5509 -- : BFD_RELOC_IP2K_PAGE3
5510     Scenix IP2K - high 3 bits of instruction word address
5511 -- : BFD_RELOC_IP2K_LO8DATA
5512 -- : BFD_RELOC_IP2K_HI8DATA
5513 -- : BFD_RELOC_IP2K_EX8DATA
5514     Scenix IP2K - ext/low/high 8 bits of data address
5515 -- : BFD_RELOC_IP2K_LO8INSN
5516 -- : BFD_RELOC_IP2K_HI8INSN
5517     Scenix IP2K - low/high 8 bits of instruction word address
5518 -- : BFD_RELOC_IP2K_PC_SKIP
5519     Scenix IP2K - even/odd PC modifier to modify snb pcl.0
5520 -- : BFD_RELOC_IP2K_TEXT
5521     Scenix IP2K - 16 bit word address in text section.
5522 -- : BFD_RELOC_IP2K_FR_OFFSET
5523     Scenix IP2K - 7-bit sp or dp offset
5524 -- : BFD_RELOC_VPE4KMATH_DATA
5525 -- : BFD_RELOC_VPE4KMATH_INSN
5526     Scenix VPE4K coprocessor - data/insn-space addressing
5527 -- : BFD_RELOC_VTABLE_INHERIT
5528 -- : BFD_RELOC_VTABLE_ENTRY
5529     These two relocations are used by the linker to determine which of
5530     the entries in a C++ virtual function table are actually used.
5531     When the -gc-sections option is given, the linker will zero out the
5532     entries that are not used, so that the code for those functions
5533     need not be included in the output.
5534
5535     VTABLE_INHERIT is a zero-space relocation used to describe to the
5536     linker the inheritance tree of a C++ virtual function table.  The
5537     relocation's symbol should be the parent class' vtable, and the
5538     relocation should be located at the child vtable.
5539
5540     VTABLE_ENTRY is a zero-space relocation that describes the use of a
5541     virtual function table entry.  The reloc's symbol should refer to
5542     the table of the class mentioned in the code.  Off of that base, an
5543     offset describes the entry that is being used.  For Rela hosts,
5544     this offset is stored in the reloc's addend.  For Rel hosts, we are
5545     forced to put this offset in the reloc's section offset.
5546 -- : BFD_RELOC_IA64_IMM14
5547 -- : BFD_RELOC_IA64_IMM22
5548 -- : BFD_RELOC_IA64_IMM64
5549 -- : BFD_RELOC_IA64_DIR32MSB
5550 -- : BFD_RELOC_IA64_DIR32LSB
5551 -- : BFD_RELOC_IA64_DIR64MSB
5552 -- : BFD_RELOC_IA64_DIR64LSB
5553 -- : BFD_RELOC_IA64_GPREL22
5554 -- : BFD_RELOC_IA64_GPREL64I
5555 -- : BFD_RELOC_IA64_GPREL32MSB
5556 -- : BFD_RELOC_IA64_GPREL32LSB
5557 -- : BFD_RELOC_IA64_GPREL64MSB
5558 -- : BFD_RELOC_IA64_GPREL64LSB
5559 -- : BFD_RELOC_IA64_LTOFF22
5560 -- : BFD_RELOC_IA64_LTOFF64I
5561 -- : BFD_RELOC_IA64_PLTOFF22
5562 -- : BFD_RELOC_IA64_PLTOFF64I
5563 -- : BFD_RELOC_IA64_PLTOFF64MSB
5564 -- : BFD_RELOC_IA64_PLTOFF64LSB
5565 -- : BFD_RELOC_IA64_FPTR64I
5566 -- : BFD_RELOC_IA64_FPTR32MSB
5567 -- : BFD_RELOC_IA64_FPTR32LSB
5568 -- : BFD_RELOC_IA64_FPTR64MSB
5569 -- : BFD_RELOC_IA64_FPTR64LSB
5570 -- : BFD_RELOC_IA64_PCREL21B
5571 -- : BFD_RELOC_IA64_PCREL21BI
5572 -- : BFD_RELOC_IA64_PCREL21M
5573 -- : BFD_RELOC_IA64_PCREL21F
5574 -- : BFD_RELOC_IA64_PCREL22
5575 -- : BFD_RELOC_IA64_PCREL60B
5576 -- : BFD_RELOC_IA64_PCREL64I
5577 -- : BFD_RELOC_IA64_PCREL32MSB
5578 -- : BFD_RELOC_IA64_PCREL32LSB
5579 -- : BFD_RELOC_IA64_PCREL64MSB
5580 -- : BFD_RELOC_IA64_PCREL64LSB
5581 -- : BFD_RELOC_IA64_LTOFF_FPTR22
5582 -- : BFD_RELOC_IA64_LTOFF_FPTR64I
5583 -- : BFD_RELOC_IA64_LTOFF_FPTR32MSB
5584 -- : BFD_RELOC_IA64_LTOFF_FPTR32LSB
5585 -- : BFD_RELOC_IA64_LTOFF_FPTR64MSB
5586 -- : BFD_RELOC_IA64_LTOFF_FPTR64LSB
5587 -- : BFD_RELOC_IA64_SEGREL32MSB
5588 -- : BFD_RELOC_IA64_SEGREL32LSB
5589 -- : BFD_RELOC_IA64_SEGREL64MSB
5590 -- : BFD_RELOC_IA64_SEGREL64LSB
5591 -- : BFD_RELOC_IA64_SECREL32MSB
5592 -- : BFD_RELOC_IA64_SECREL32LSB
5593 -- : BFD_RELOC_IA64_SECREL64MSB
5594 -- : BFD_RELOC_IA64_SECREL64LSB
5595 -- : BFD_RELOC_IA64_REL32MSB
5596 -- : BFD_RELOC_IA64_REL32LSB
5597 -- : BFD_RELOC_IA64_REL64MSB
5598 -- : BFD_RELOC_IA64_REL64LSB
5599 -- : BFD_RELOC_IA64_LTV32MSB
5600 -- : BFD_RELOC_IA64_LTV32LSB
5601 -- : BFD_RELOC_IA64_LTV64MSB
5602 -- : BFD_RELOC_IA64_LTV64LSB
5603 -- : BFD_RELOC_IA64_IPLTMSB
5604 -- : BFD_RELOC_IA64_IPLTLSB
5605 -- : BFD_RELOC_IA64_COPY
5606 -- : BFD_RELOC_IA64_LTOFF22X
5607 -- : BFD_RELOC_IA64_LDXMOV
5608 -- : BFD_RELOC_IA64_TPREL14
5609 -- : BFD_RELOC_IA64_TPREL22
5610 -- : BFD_RELOC_IA64_TPREL64I
5611 -- : BFD_RELOC_IA64_TPREL64MSB
5612 -- : BFD_RELOC_IA64_TPREL64LSB
5613 -- : BFD_RELOC_IA64_LTOFF_TPREL22
5614 -- : BFD_RELOC_IA64_DTPMOD64MSB
5615 -- : BFD_RELOC_IA64_DTPMOD64LSB
5616 -- : BFD_RELOC_IA64_LTOFF_DTPMOD22
5617 -- : BFD_RELOC_IA64_DTPREL14
5618 -- : BFD_RELOC_IA64_DTPREL22
5619 -- : BFD_RELOC_IA64_DTPREL64I
5620 -- : BFD_RELOC_IA64_DTPREL32MSB
5621 -- : BFD_RELOC_IA64_DTPREL32LSB
5622 -- : BFD_RELOC_IA64_DTPREL64MSB
5623 -- : BFD_RELOC_IA64_DTPREL64LSB
5624 -- : BFD_RELOC_IA64_LTOFF_DTPREL22
5625     Intel IA64 Relocations.
5626 -- : BFD_RELOC_M68HC11_HI8
5627     Motorola 68HC11 reloc.  This is the 8 bit high part of an absolute
5628     address.
5629 -- : BFD_RELOC_M68HC11_LO8
5630     Motorola 68HC11 reloc.  This is the 8 bit low part of an absolute
5631     address.
5632 -- : BFD_RELOC_M68HC11_3B
5633     Motorola 68HC11 reloc.  This is the 3 bit of a value.
5634 -- : BFD_RELOC_M68HC11_RL_JUMP
5635     Motorola 68HC11 reloc.  This reloc marks the beginning of a
5636     jump/call instruction.  It is used for linker relaxation to
5637     correctly identify beginning of instruction and change some
5638     branches to use PC-relative addressing mode.
5639 -- : BFD_RELOC_M68HC11_RL_GROUP
5640     Motorola 68HC11 reloc.  This reloc marks a group of several
5641     instructions that gcc generates and for which the linker relaxation
5642     pass can modify and/or remove some of them.
5643 -- : BFD_RELOC_M68HC11_LO16
5644     Motorola 68HC11 reloc.  This is the 16-bit lower part of an
5645     address.  It is used for 'call' instruction to specify the symbol
5646     address without any special transformation (due to memory bank
5647     window).
5648 -- : BFD_RELOC_M68HC11_PAGE
5649     Motorola 68HC11 reloc.  This is a 8-bit reloc that specifies the
5650     page number of an address.  It is used by 'call' instruction to
5651     specify the page number of the symbol.
5652 -- : BFD_RELOC_M68HC11_24
5653     Motorola 68HC11 reloc.  This is a 24-bit reloc that represents the
5654     address with a 16-bit value and a 8-bit page number.  The symbol
5655     address is transformed to follow the 16K memory bank of 68HC12
5656     (seen as mapped in the window).
5657 -- : BFD_RELOC_M68HC12_5B
5658     Motorola 68HC12 reloc.  This is the 5 bits of a value.
5659 -- : BFD_RELOC_XGATE_RL_JUMP
5660     Freescale XGATE reloc.  This reloc marks the beginning of a bra/jal
5661     instruction.
5662 -- : BFD_RELOC_XGATE_RL_GROUP
5663     Freescale XGATE reloc.  This reloc marks a group of several
5664     instructions that gcc generates and for which the linker relaxation
5665     pass can modify and/or remove some of them.
5666 -- : BFD_RELOC_XGATE_LO16
5667     Freescale XGATE reloc.  This is the 16-bit lower part of an
5668     address.  It is used for the '16-bit' instructions.
5669 -- : BFD_RELOC_XGATE_GPAGE
5670     Freescale XGATE reloc.
5671 -- : BFD_RELOC_XGATE_24
5672     Freescale XGATE reloc.
5673 -- : BFD_RELOC_XGATE_PCREL_9
5674     Freescale XGATE reloc.  This is a 9-bit pc-relative reloc.
5675 -- : BFD_RELOC_XGATE_PCREL_10
5676     Freescale XGATE reloc.  This is a 10-bit pc-relative reloc.
5677 -- : BFD_RELOC_XGATE_IMM8_LO
5678     Freescale XGATE reloc.  This is the 16-bit lower part of an
5679     address.  It is used for the '16-bit' instructions.
5680 -- : BFD_RELOC_XGATE_IMM8_HI
5681     Freescale XGATE reloc.  This is the 16-bit higher part of an
5682     address.  It is used for the '16-bit' instructions.
5683 -- : BFD_RELOC_XGATE_IMM3
5684     Freescale XGATE reloc.  This is a 3-bit pc-relative reloc.
5685 -- : BFD_RELOC_XGATE_IMM4
5686     Freescale XGATE reloc.  This is a 4-bit pc-relative reloc.
5687 -- : BFD_RELOC_XGATE_IMM5
5688     Freescale XGATE reloc.  This is a 5-bit pc-relative reloc.
5689 -- : BFD_RELOC_M68HC12_9B
5690     Motorola 68HC12 reloc.  This is the 9 bits of a value.
5691 -- : BFD_RELOC_M68HC12_16B
5692     Motorola 68HC12 reloc.  This is the 16 bits of a value.
5693 -- : BFD_RELOC_M68HC12_9_PCREL
5694     Motorola 68HC12/XGATE reloc.  This is a PCREL9 branch.
5695 -- : BFD_RELOC_M68HC12_10_PCREL
5696     Motorola 68HC12/XGATE reloc.  This is a PCREL10 branch.
5697 -- : BFD_RELOC_M68HC12_LO8XG
5698     Motorola 68HC12/XGATE reloc.  This is the 8 bit low part of an
5699     absolute address and immediately precedes a matching HI8XG part.
5700 -- : BFD_RELOC_M68HC12_HI8XG
5701     Motorola 68HC12/XGATE reloc.  This is the 8 bit high part of an
5702     absolute address and immediately follows a matching LO8XG part.
5703 -- : BFD_RELOC_16C_NUM08
5704 -- : BFD_RELOC_16C_NUM08_C
5705 -- : BFD_RELOC_16C_NUM16
5706 -- : BFD_RELOC_16C_NUM16_C
5707 -- : BFD_RELOC_16C_NUM32
5708 -- : BFD_RELOC_16C_NUM32_C
5709 -- : BFD_RELOC_16C_DISP04
5710 -- : BFD_RELOC_16C_DISP04_C
5711 -- : BFD_RELOC_16C_DISP08
5712 -- : BFD_RELOC_16C_DISP08_C
5713 -- : BFD_RELOC_16C_DISP16
5714 -- : BFD_RELOC_16C_DISP16_C
5715 -- : BFD_RELOC_16C_DISP24
5716 -- : BFD_RELOC_16C_DISP24_C
5717 -- : BFD_RELOC_16C_DISP24a
5718 -- : BFD_RELOC_16C_DISP24a_C
5719 -- : BFD_RELOC_16C_REG04
5720 -- : BFD_RELOC_16C_REG04_C
5721 -- : BFD_RELOC_16C_REG04a
5722 -- : BFD_RELOC_16C_REG04a_C
5723 -- : BFD_RELOC_16C_REG14
5724 -- : BFD_RELOC_16C_REG14_C
5725 -- : BFD_RELOC_16C_REG16
5726 -- : BFD_RELOC_16C_REG16_C
5727 -- : BFD_RELOC_16C_REG20
5728 -- : BFD_RELOC_16C_REG20_C
5729 -- : BFD_RELOC_16C_ABS20
5730 -- : BFD_RELOC_16C_ABS20_C
5731 -- : BFD_RELOC_16C_ABS24
5732 -- : BFD_RELOC_16C_ABS24_C
5733 -- : BFD_RELOC_16C_IMM04
5734 -- : BFD_RELOC_16C_IMM04_C
5735 -- : BFD_RELOC_16C_IMM16
5736 -- : BFD_RELOC_16C_IMM16_C
5737 -- : BFD_RELOC_16C_IMM20
5738 -- : BFD_RELOC_16C_IMM20_C
5739 -- : BFD_RELOC_16C_IMM24
5740 -- : BFD_RELOC_16C_IMM24_C
5741 -- : BFD_RELOC_16C_IMM32
5742 -- : BFD_RELOC_16C_IMM32_C
5743     NS CR16C Relocations.
5744 -- : BFD_RELOC_CR16_NUM8
5745 -- : BFD_RELOC_CR16_NUM16
5746 -- : BFD_RELOC_CR16_NUM32
5747 -- : BFD_RELOC_CR16_NUM32a
5748 -- : BFD_RELOC_CR16_REGREL0
5749 -- : BFD_RELOC_CR16_REGREL4
5750 -- : BFD_RELOC_CR16_REGREL4a
5751 -- : BFD_RELOC_CR16_REGREL14
5752 -- : BFD_RELOC_CR16_REGREL14a
5753 -- : BFD_RELOC_CR16_REGREL16
5754 -- : BFD_RELOC_CR16_REGREL20
5755 -- : BFD_RELOC_CR16_REGREL20a
5756 -- : BFD_RELOC_CR16_ABS20
5757 -- : BFD_RELOC_CR16_ABS24
5758 -- : BFD_RELOC_CR16_IMM4
5759 -- : BFD_RELOC_CR16_IMM8
5760 -- : BFD_RELOC_CR16_IMM16
5761 -- : BFD_RELOC_CR16_IMM20
5762 -- : BFD_RELOC_CR16_IMM24
5763 -- : BFD_RELOC_CR16_IMM32
5764 -- : BFD_RELOC_CR16_IMM32a
5765 -- : BFD_RELOC_CR16_DISP4
5766 -- : BFD_RELOC_CR16_DISP8
5767 -- : BFD_RELOC_CR16_DISP16
5768 -- : BFD_RELOC_CR16_DISP20
5769 -- : BFD_RELOC_CR16_DISP24
5770 -- : BFD_RELOC_CR16_DISP24a
5771 -- : BFD_RELOC_CR16_SWITCH8
5772 -- : BFD_RELOC_CR16_SWITCH16
5773 -- : BFD_RELOC_CR16_SWITCH32
5774 -- : BFD_RELOC_CR16_GOT_REGREL20
5775 -- : BFD_RELOC_CR16_GOTC_REGREL20
5776 -- : BFD_RELOC_CR16_GLOB_DAT
5777     NS CR16 Relocations.
5778 -- : BFD_RELOC_CRX_REL4
5779 -- : BFD_RELOC_CRX_REL8
5780 -- : BFD_RELOC_CRX_REL8_CMP
5781 -- : BFD_RELOC_CRX_REL16
5782 -- : BFD_RELOC_CRX_REL24
5783 -- : BFD_RELOC_CRX_REL32
5784 -- : BFD_RELOC_CRX_REGREL12
5785 -- : BFD_RELOC_CRX_REGREL22
5786 -- : BFD_RELOC_CRX_REGREL28
5787 -- : BFD_RELOC_CRX_REGREL32
5788 -- : BFD_RELOC_CRX_ABS16
5789 -- : BFD_RELOC_CRX_ABS32
5790 -- : BFD_RELOC_CRX_NUM8
5791 -- : BFD_RELOC_CRX_NUM16
5792 -- : BFD_RELOC_CRX_NUM32
5793 -- : BFD_RELOC_CRX_IMM16
5794 -- : BFD_RELOC_CRX_IMM32
5795 -- : BFD_RELOC_CRX_SWITCH8
5796 -- : BFD_RELOC_CRX_SWITCH16
5797 -- : BFD_RELOC_CRX_SWITCH32
5798     NS CRX Relocations.
5799 -- : BFD_RELOC_CRIS_BDISP8
5800 -- : BFD_RELOC_CRIS_UNSIGNED_5
5801 -- : BFD_RELOC_CRIS_SIGNED_6
5802 -- : BFD_RELOC_CRIS_UNSIGNED_6
5803 -- : BFD_RELOC_CRIS_SIGNED_8
5804 -- : BFD_RELOC_CRIS_UNSIGNED_8
5805 -- : BFD_RELOC_CRIS_SIGNED_16
5806 -- : BFD_RELOC_CRIS_UNSIGNED_16
5807 -- : BFD_RELOC_CRIS_LAPCQ_OFFSET
5808 -- : BFD_RELOC_CRIS_UNSIGNED_4
5809     These relocs are only used within the CRIS assembler.  They are not
5810     (at present) written to any object files.
5811 -- : BFD_RELOC_CRIS_COPY
5812 -- : BFD_RELOC_CRIS_GLOB_DAT
5813 -- : BFD_RELOC_CRIS_JUMP_SLOT
5814 -- : BFD_RELOC_CRIS_RELATIVE
5815     Relocs used in ELF shared libraries for CRIS.
5816 -- : BFD_RELOC_CRIS_32_GOT
5817     32-bit offset to symbol-entry within GOT.
5818 -- : BFD_RELOC_CRIS_16_GOT
5819     16-bit offset to symbol-entry within GOT.
5820 -- : BFD_RELOC_CRIS_32_GOTPLT
5821     32-bit offset to symbol-entry within GOT, with PLT handling.
5822 -- : BFD_RELOC_CRIS_16_GOTPLT
5823     16-bit offset to symbol-entry within GOT, with PLT handling.
5824 -- : BFD_RELOC_CRIS_32_GOTREL
5825     32-bit offset to symbol, relative to GOT.
5826 -- : BFD_RELOC_CRIS_32_PLT_GOTREL
5827     32-bit offset to symbol with PLT entry, relative to GOT.
5828 -- : BFD_RELOC_CRIS_32_PLT_PCREL
5829     32-bit offset to symbol with PLT entry, relative to this
5830     relocation.
5831 -- : BFD_RELOC_CRIS_32_GOT_GD
5832 -- : BFD_RELOC_CRIS_16_GOT_GD
5833 -- : BFD_RELOC_CRIS_32_GD
5834 -- : BFD_RELOC_CRIS_DTP
5835 -- : BFD_RELOC_CRIS_32_DTPREL
5836 -- : BFD_RELOC_CRIS_16_DTPREL
5837 -- : BFD_RELOC_CRIS_32_GOT_TPREL
5838 -- : BFD_RELOC_CRIS_16_GOT_TPREL
5839 -- : BFD_RELOC_CRIS_32_TPREL
5840 -- : BFD_RELOC_CRIS_16_TPREL
5841 -- : BFD_RELOC_CRIS_DTPMOD
5842 -- : BFD_RELOC_CRIS_32_IE
5843     Relocs used in TLS code for CRIS.
5844 -- : BFD_RELOC_860_COPY
5845 -- : BFD_RELOC_860_GLOB_DAT
5846 -- : BFD_RELOC_860_JUMP_SLOT
5847 -- : BFD_RELOC_860_RELATIVE
5848 -- : BFD_RELOC_860_PC26
5849 -- : BFD_RELOC_860_PLT26
5850 -- : BFD_RELOC_860_PC16
5851 -- : BFD_RELOC_860_LOW0
5852 -- : BFD_RELOC_860_SPLIT0
5853 -- : BFD_RELOC_860_LOW1
5854 -- : BFD_RELOC_860_SPLIT1
5855 -- : BFD_RELOC_860_LOW2
5856 -- : BFD_RELOC_860_SPLIT2
5857 -- : BFD_RELOC_860_LOW3
5858 -- : BFD_RELOC_860_LOGOT0
5859 -- : BFD_RELOC_860_SPGOT0
5860 -- : BFD_RELOC_860_LOGOT1
5861 -- : BFD_RELOC_860_SPGOT1
5862 -- : BFD_RELOC_860_LOGOTOFF0
5863 -- : BFD_RELOC_860_SPGOTOFF0
5864 -- : BFD_RELOC_860_LOGOTOFF1
5865 -- : BFD_RELOC_860_SPGOTOFF1
5866 -- : BFD_RELOC_860_LOGOTOFF2
5867 -- : BFD_RELOC_860_LOGOTOFF3
5868 -- : BFD_RELOC_860_LOPC
5869 -- : BFD_RELOC_860_HIGHADJ
5870 -- : BFD_RELOC_860_HAGOT
5871 -- : BFD_RELOC_860_HAGOTOFF
5872 -- : BFD_RELOC_860_HAPC
5873 -- : BFD_RELOC_860_HIGH
5874 -- : BFD_RELOC_860_HIGOT
5875 -- : BFD_RELOC_860_HIGOTOFF
5876     Intel i860 Relocations.
5877 -- : BFD_RELOC_OR1K_REL_26
5878 -- : BFD_RELOC_OR1K_GOTPC_HI16
5879 -- : BFD_RELOC_OR1K_GOTPC_LO16
5880 -- : BFD_RELOC_OR1K_GOT16
5881 -- : BFD_RELOC_OR1K_PLT26
5882 -- : BFD_RELOC_OR1K_GOTOFF_HI16
5883 -- : BFD_RELOC_OR1K_GOTOFF_LO16
5884 -- : BFD_RELOC_OR1K_COPY
5885 -- : BFD_RELOC_OR1K_GLOB_DAT
5886 -- : BFD_RELOC_OR1K_JMP_SLOT
5887 -- : BFD_RELOC_OR1K_RELATIVE
5888 -- : BFD_RELOC_OR1K_TLS_GD_HI16
5889 -- : BFD_RELOC_OR1K_TLS_GD_LO16
5890 -- : BFD_RELOC_OR1K_TLS_LDM_HI16
5891 -- : BFD_RELOC_OR1K_TLS_LDM_LO16
5892 -- : BFD_RELOC_OR1K_TLS_LDO_HI16
5893 -- : BFD_RELOC_OR1K_TLS_LDO_LO16
5894 -- : BFD_RELOC_OR1K_TLS_IE_HI16
5895 -- : BFD_RELOC_OR1K_TLS_IE_LO16
5896 -- : BFD_RELOC_OR1K_TLS_LE_HI16
5897 -- : BFD_RELOC_OR1K_TLS_LE_LO16
5898 -- : BFD_RELOC_OR1K_TLS_TPOFF
5899 -- : BFD_RELOC_OR1K_TLS_DTPOFF
5900 -- : BFD_RELOC_OR1K_TLS_DTPMOD
5901     OpenRISC 1000 Relocations.
5902 -- : BFD_RELOC_H8_DIR16A8
5903 -- : BFD_RELOC_H8_DIR16R8
5904 -- : BFD_RELOC_H8_DIR24A8
5905 -- : BFD_RELOC_H8_DIR24R8
5906 -- : BFD_RELOC_H8_DIR32A16
5907 -- : BFD_RELOC_H8_DISP32A16
5908     H8 elf Relocations.
5909 -- : BFD_RELOC_XSTORMY16_REL_12
5910 -- : BFD_RELOC_XSTORMY16_12
5911 -- : BFD_RELOC_XSTORMY16_24
5912 -- : BFD_RELOC_XSTORMY16_FPTR16
5913     Sony Xstormy16 Relocations.
5914 -- : BFD_RELOC_RELC
5915     Self-describing complex relocations.
5916 -- : BFD_RELOC_XC16X_PAG
5917 -- : BFD_RELOC_XC16X_POF
5918 -- : BFD_RELOC_XC16X_SEG
5919 -- : BFD_RELOC_XC16X_SOF
5920     Infineon Relocations.
5921 -- : BFD_RELOC_VAX_GLOB_DAT
5922 -- : BFD_RELOC_VAX_JMP_SLOT
5923 -- : BFD_RELOC_VAX_RELATIVE
5924     Relocations used by VAX ELF.
5925 -- : BFD_RELOC_MT_PC16
5926     Morpho MT - 16 bit immediate relocation.
5927 -- : BFD_RELOC_MT_HI16
5928     Morpho MT - Hi 16 bits of an address.
5929 -- : BFD_RELOC_MT_LO16
5930     Morpho MT - Low 16 bits of an address.
5931 -- : BFD_RELOC_MT_GNU_VTINHERIT
5932     Morpho MT - Used to tell the linker which vtable entries are used.
5933 -- : BFD_RELOC_MT_GNU_VTENTRY
5934     Morpho MT - Used to tell the linker which vtable entries are used.
5935 -- : BFD_RELOC_MT_PCINSN8
5936     Morpho MT - 8 bit immediate relocation.
5937 -- : BFD_RELOC_MSP430_10_PCREL
5938 -- : BFD_RELOC_MSP430_16_PCREL
5939 -- : BFD_RELOC_MSP430_16
5940 -- : BFD_RELOC_MSP430_16_PCREL_BYTE
5941 -- : BFD_RELOC_MSP430_16_BYTE
5942 -- : BFD_RELOC_MSP430_2X_PCREL
5943 -- : BFD_RELOC_MSP430_RL_PCREL
5944 -- : BFD_RELOC_MSP430_ABS8
5945 -- : BFD_RELOC_MSP430X_PCR20_EXT_SRC
5946 -- : BFD_RELOC_MSP430X_PCR20_EXT_DST
5947 -- : BFD_RELOC_MSP430X_PCR20_EXT_ODST
5948 -- : BFD_RELOC_MSP430X_ABS20_EXT_SRC
5949 -- : BFD_RELOC_MSP430X_ABS20_EXT_DST
5950 -- : BFD_RELOC_MSP430X_ABS20_EXT_ODST
5951 -- : BFD_RELOC_MSP430X_ABS20_ADR_SRC
5952 -- : BFD_RELOC_MSP430X_ABS20_ADR_DST
5953 -- : BFD_RELOC_MSP430X_PCR16
5954 -- : BFD_RELOC_MSP430X_PCR20_CALL
5955 -- : BFD_RELOC_MSP430X_ABS16
5956 -- : BFD_RELOC_MSP430_ABS_HI16
5957 -- : BFD_RELOC_MSP430_PREL31
5958 -- : BFD_RELOC_MSP430_SYM_DIFF
5959     msp430 specific relocation codes
5960 -- : BFD_RELOC_NIOS2_S16
5961 -- : BFD_RELOC_NIOS2_U16
5962 -- : BFD_RELOC_NIOS2_CALL26
5963 -- : BFD_RELOC_NIOS2_IMM5
5964 -- : BFD_RELOC_NIOS2_CACHE_OPX
5965 -- : BFD_RELOC_NIOS2_IMM6
5966 -- : BFD_RELOC_NIOS2_IMM8
5967 -- : BFD_RELOC_NIOS2_HI16
5968 -- : BFD_RELOC_NIOS2_LO16
5969 -- : BFD_RELOC_NIOS2_HIADJ16
5970 -- : BFD_RELOC_NIOS2_GPREL
5971 -- : BFD_RELOC_NIOS2_UJMP
5972 -- : BFD_RELOC_NIOS2_CJMP
5973 -- : BFD_RELOC_NIOS2_CALLR
5974 -- : BFD_RELOC_NIOS2_ALIGN
5975 -- : BFD_RELOC_NIOS2_GOT16
5976 -- : BFD_RELOC_NIOS2_CALL16
5977 -- : BFD_RELOC_NIOS2_GOTOFF_LO
5978 -- : BFD_RELOC_NIOS2_GOTOFF_HA
5979 -- : BFD_RELOC_NIOS2_PCREL_LO
5980 -- : BFD_RELOC_NIOS2_PCREL_HA
5981 -- : BFD_RELOC_NIOS2_TLS_GD16
5982 -- : BFD_RELOC_NIOS2_TLS_LDM16
5983 -- : BFD_RELOC_NIOS2_TLS_LDO16
5984 -- : BFD_RELOC_NIOS2_TLS_IE16
5985 -- : BFD_RELOC_NIOS2_TLS_LE16
5986 -- : BFD_RELOC_NIOS2_TLS_DTPMOD
5987 -- : BFD_RELOC_NIOS2_TLS_DTPREL
5988 -- : BFD_RELOC_NIOS2_TLS_TPREL
5989 -- : BFD_RELOC_NIOS2_COPY
5990 -- : BFD_RELOC_NIOS2_GLOB_DAT
5991 -- : BFD_RELOC_NIOS2_JUMP_SLOT
5992 -- : BFD_RELOC_NIOS2_RELATIVE
5993 -- : BFD_RELOC_NIOS2_GOTOFF
5994 -- : BFD_RELOC_NIOS2_CALL26_NOAT
5995 -- : BFD_RELOC_NIOS2_GOT_LO
5996 -- : BFD_RELOC_NIOS2_GOT_HA
5997 -- : BFD_RELOC_NIOS2_CALL_LO
5998 -- : BFD_RELOC_NIOS2_CALL_HA
5999 -- : BFD_RELOC_NIOS2_R2_S12
6000 -- : BFD_RELOC_NIOS2_R2_I10_1_PCREL
6001 -- : BFD_RELOC_NIOS2_R2_T1I7_1_PCREL
6002 -- : BFD_RELOC_NIOS2_R2_T1I7_2
6003 -- : BFD_RELOC_NIOS2_R2_T2I4
6004 -- : BFD_RELOC_NIOS2_R2_T2I4_1
6005 -- : BFD_RELOC_NIOS2_R2_T2I4_2
6006 -- : BFD_RELOC_NIOS2_R2_X1I7_2
6007 -- : BFD_RELOC_NIOS2_R2_X2L5
6008 -- : BFD_RELOC_NIOS2_R2_F1I5_2
6009 -- : BFD_RELOC_NIOS2_R2_L5I4X1
6010 -- : BFD_RELOC_NIOS2_R2_T1X1I6
6011 -- : BFD_RELOC_NIOS2_R2_T1X1I6_2
6012     Relocations used by the Altera Nios II core.
6013 -- : BFD_RELOC_PRU_U16
6014     PRU LDI 16-bit unsigned data-memory relocation.
6015 -- : BFD_RELOC_PRU_U16_PMEMIMM
6016     PRU LDI 16-bit unsigned instruction-memory relocation.
6017 -- : BFD_RELOC_PRU_LDI32
6018     PRU relocation for two consecutive LDI load instructions that load
6019     a 32 bit value into a register.  If the higher bits are all zero,
6020     then the second instruction may be relaxed.
6021 -- : BFD_RELOC_PRU_S10_PCREL
6022     PRU QBBx 10-bit signed PC-relative relocation.
6023 -- : BFD_RELOC_PRU_U8_PCREL
6024     PRU 8-bit unsigned relocation used for the LOOP instruction.
6025 -- : BFD_RELOC_PRU_32_PMEM
6026 -- : BFD_RELOC_PRU_16_PMEM
6027     PRU Program Memory relocations.  Used to convert from byte
6028     addressing to 32-bit word addressing.
6029 -- : BFD_RELOC_PRU_GNU_DIFF8
6030 -- : BFD_RELOC_PRU_GNU_DIFF16
6031 -- : BFD_RELOC_PRU_GNU_DIFF32
6032 -- : BFD_RELOC_PRU_GNU_DIFF16_PMEM
6033 -- : BFD_RELOC_PRU_GNU_DIFF32_PMEM
6034     PRU relocations to mark the difference of two local symbols.  These
6035     are only needed to support linker relaxation and can be ignored
6036     when not relaxing.  The field is set to the value of the difference
6037     assuming no relaxation.  The relocation encodes the position of the
6038     second symbol so the linker can determine whether to adjust the
6039     field value.  The PMEM variants encode the word difference, instead
6040     of byte difference between symbols.
6041 -- : BFD_RELOC_IQ2000_OFFSET_16
6042 -- : BFD_RELOC_IQ2000_OFFSET_21
6043 -- : BFD_RELOC_IQ2000_UHI16
6044     IQ2000 Relocations.
6045 -- : BFD_RELOC_XTENSA_RTLD
6046     Special Xtensa relocation used only by PLT entries in ELF shared
6047     objects to indicate that the runtime linker should set the value to
6048     one of its own internal functions or data structures.
6049 -- : BFD_RELOC_XTENSA_GLOB_DAT
6050 -- : BFD_RELOC_XTENSA_JMP_SLOT
6051 -- : BFD_RELOC_XTENSA_RELATIVE
6052     Xtensa relocations for ELF shared objects.
6053 -- : BFD_RELOC_XTENSA_PLT
6054     Xtensa relocation used in ELF object files for symbols that may
6055     require PLT entries.  Otherwise, this is just a generic 32-bit
6056     relocation.
6057 -- : BFD_RELOC_XTENSA_DIFF8
6058 -- : BFD_RELOC_XTENSA_DIFF16
6059 -- : BFD_RELOC_XTENSA_DIFF32
6060     Xtensa relocations to mark the difference of two local symbols.
6061     These are only needed to support linker relaxation and can be
6062     ignored when not relaxing.  The field is set to the value of the
6063     difference assuming no relaxation.  The relocation encodes the
6064     position of the first symbol so the linker can determine whether to
6065     adjust the field value.
6066 -- : BFD_RELOC_XTENSA_SLOT0_OP
6067 -- : BFD_RELOC_XTENSA_SLOT1_OP
6068 -- : BFD_RELOC_XTENSA_SLOT2_OP
6069 -- : BFD_RELOC_XTENSA_SLOT3_OP
6070 -- : BFD_RELOC_XTENSA_SLOT4_OP
6071 -- : BFD_RELOC_XTENSA_SLOT5_OP
6072 -- : BFD_RELOC_XTENSA_SLOT6_OP
6073 -- : BFD_RELOC_XTENSA_SLOT7_OP
6074 -- : BFD_RELOC_XTENSA_SLOT8_OP
6075 -- : BFD_RELOC_XTENSA_SLOT9_OP
6076 -- : BFD_RELOC_XTENSA_SLOT10_OP
6077 -- : BFD_RELOC_XTENSA_SLOT11_OP
6078 -- : BFD_RELOC_XTENSA_SLOT12_OP
6079 -- : BFD_RELOC_XTENSA_SLOT13_OP
6080 -- : BFD_RELOC_XTENSA_SLOT14_OP
6081     Generic Xtensa relocations for instruction operands.  Only the slot
6082     number is encoded in the relocation.  The relocation applies to the
6083     last PC-relative immediate operand, or if there are no PC-relative
6084     immediates, to the last immediate operand.
6085 -- : BFD_RELOC_XTENSA_SLOT0_ALT
6086 -- : BFD_RELOC_XTENSA_SLOT1_ALT
6087 -- : BFD_RELOC_XTENSA_SLOT2_ALT
6088 -- : BFD_RELOC_XTENSA_SLOT3_ALT
6089 -- : BFD_RELOC_XTENSA_SLOT4_ALT
6090 -- : BFD_RELOC_XTENSA_SLOT5_ALT
6091 -- : BFD_RELOC_XTENSA_SLOT6_ALT
6092 -- : BFD_RELOC_XTENSA_SLOT7_ALT
6093 -- : BFD_RELOC_XTENSA_SLOT8_ALT
6094 -- : BFD_RELOC_XTENSA_SLOT9_ALT
6095 -- : BFD_RELOC_XTENSA_SLOT10_ALT
6096 -- : BFD_RELOC_XTENSA_SLOT11_ALT
6097 -- : BFD_RELOC_XTENSA_SLOT12_ALT
6098 -- : BFD_RELOC_XTENSA_SLOT13_ALT
6099 -- : BFD_RELOC_XTENSA_SLOT14_ALT
6100     Alternate Xtensa relocations.  Only the slot is encoded in the
6101     relocation.  The meaning of these relocations is opcode-specific.
6102 -- : BFD_RELOC_XTENSA_OP0
6103 -- : BFD_RELOC_XTENSA_OP1
6104 -- : BFD_RELOC_XTENSA_OP2
6105     Xtensa relocations for backward compatibility.  These have all been
6106     replaced by BFD_RELOC_XTENSA_SLOT0_OP.
6107 -- : BFD_RELOC_XTENSA_ASM_EXPAND
6108     Xtensa relocation to mark that the assembler expanded the
6109     instructions from an original target.  The expansion size is
6110     encoded in the reloc size.
6111 -- : BFD_RELOC_XTENSA_ASM_SIMPLIFY
6112     Xtensa relocation to mark that the linker should simplify
6113     assembler-expanded instructions.  This is commonly used internally
6114     by the linker after analysis of a BFD_RELOC_XTENSA_ASM_EXPAND.
6115 -- : BFD_RELOC_XTENSA_TLSDESC_FN
6116 -- : BFD_RELOC_XTENSA_TLSDESC_ARG
6117 -- : BFD_RELOC_XTENSA_TLS_DTPOFF
6118 -- : BFD_RELOC_XTENSA_TLS_TPOFF
6119 -- : BFD_RELOC_XTENSA_TLS_FUNC
6120 -- : BFD_RELOC_XTENSA_TLS_ARG
6121 -- : BFD_RELOC_XTENSA_TLS_CALL
6122     Xtensa TLS relocations.
6123 -- : BFD_RELOC_Z80_DISP8
6124     8 bit signed offset in (ix+d) or (iy+d).
6125 -- : BFD_RELOC_Z8K_DISP7
6126     DJNZ offset.
6127 -- : BFD_RELOC_Z8K_CALLR
6128     CALR offset.
6129 -- : BFD_RELOC_Z8K_IMM4L
6130     4 bit value.
6131 -- : BFD_RELOC_LM32_CALL
6132 -- : BFD_RELOC_LM32_BRANCH
6133 -- : BFD_RELOC_LM32_16_GOT
6134 -- : BFD_RELOC_LM32_GOTOFF_HI16
6135 -- : BFD_RELOC_LM32_GOTOFF_LO16
6136 -- : BFD_RELOC_LM32_COPY
6137 -- : BFD_RELOC_LM32_GLOB_DAT
6138 -- : BFD_RELOC_LM32_JMP_SLOT
6139 -- : BFD_RELOC_LM32_RELATIVE
6140     Lattice Mico32 relocations.
6141 -- : BFD_RELOC_MACH_O_SECTDIFF
6142     Difference between two section addreses.  Must be followed by a
6143     BFD_RELOC_MACH_O_PAIR.
6144 -- : BFD_RELOC_MACH_O_LOCAL_SECTDIFF
6145     Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
6146 -- : BFD_RELOC_MACH_O_PAIR
6147     Pair of relocation.  Contains the first symbol.
6148 -- : BFD_RELOC_MACH_O_SUBTRACTOR32
6149     Symbol will be substracted.  Must be followed by a BFD_RELOC_32.
6150 -- : BFD_RELOC_MACH_O_SUBTRACTOR64
6151     Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
6152 -- : BFD_RELOC_MACH_O_X86_64_BRANCH32
6153 -- : BFD_RELOC_MACH_O_X86_64_BRANCH8
6154     PCREL relocations.  They are marked as branch to create PLT entry
6155     if required.
6156 -- : BFD_RELOC_MACH_O_X86_64_GOT
6157     Used when referencing a GOT entry.
6158 -- : BFD_RELOC_MACH_O_X86_64_GOT_LOAD
6159     Used when loading a GOT entry with movq.  It is specially marked so
6160     that the linker could optimize the movq to a leaq if possible.
6161 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_1
6162     Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
6163 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_2
6164     Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
6165 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_4
6166     Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
6167 -- : BFD_RELOC_MACH_O_ARM64_ADDEND
6168     Addend for PAGE or PAGEOFF.
6169 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21
6170     Relative offset to page of GOT slot.
6171 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12
6172     Relative offset within page of GOT slot.
6173 -- : BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT
6174     Address of a GOT entry.
6175 -- : BFD_RELOC_MICROBLAZE_32_LO
6176     This is a 32 bit reloc for the microblaze that stores the low 16
6177     bits of a value
6178 -- : BFD_RELOC_MICROBLAZE_32_LO_PCREL
6179     This is a 32 bit pc-relative reloc for the microblaze that stores
6180     the low 16 bits of a value
6181 -- : BFD_RELOC_MICROBLAZE_32_ROSDA
6182     This is a 32 bit reloc for the microblaze that stores a value
6183     relative to the read-only small data area anchor
6184 -- : BFD_RELOC_MICROBLAZE_32_RWSDA
6185     This is a 32 bit reloc for the microblaze that stores a value
6186     relative to the read-write small data area anchor
6187 -- : BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
6188     This is a 32 bit reloc for the microblaze to handle expressions of
6189     the form "Symbol Op Symbol"
6190 -- : BFD_RELOC_MICROBLAZE_64_NONE
6191     This is a 64 bit reloc that stores the 32 bit pc relative value in
6192     two words (with an imm instruction).  No relocation is done here -
6193     only used for relaxing
6194 -- : BFD_RELOC_MICROBLAZE_64_GOTPC
6195     This is a 64 bit reloc that stores the 32 bit pc relative value in
6196     two words (with an imm instruction).  The relocation is PC-relative
6197     GOT offset
6198 -- : BFD_RELOC_MICROBLAZE_64_GOT
6199     This is a 64 bit reloc that stores the 32 bit pc relative value in
6200     two words (with an imm instruction).  The relocation is GOT offset
6201 -- : BFD_RELOC_MICROBLAZE_64_PLT
6202     This is a 64 bit reloc that stores the 32 bit pc relative value in
6203     two words (with an imm instruction).  The relocation is PC-relative
6204     offset into PLT
6205 -- : BFD_RELOC_MICROBLAZE_64_GOTOFF
6206     This is a 64 bit reloc that stores the 32 bit GOT relative value in
6207     two words (with an imm instruction).  The relocation is relative
6208     offset from _GLOBAL_OFFSET_TABLE_
6209 -- : BFD_RELOC_MICROBLAZE_32_GOTOFF
6210     This is a 32 bit reloc that stores the 32 bit GOT relative value in
6211     a word.  The relocation is relative offset from
6212 -- : BFD_RELOC_MICROBLAZE_COPY
6213     This is used to tell the dynamic linker to copy the value out of
6214     the dynamic object into the runtime process image.
6215 -- : BFD_RELOC_MICROBLAZE_64_TLS
6216     Unused Reloc
6217 -- : BFD_RELOC_MICROBLAZE_64_TLSGD
6218     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6219     the GOT TLS GD info entry in two words (with an imm instruction).
6220     The relocation is GOT offset.
6221 -- : BFD_RELOC_MICROBLAZE_64_TLSLD
6222     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6223     the GOT TLS LD info entry in two words (with an imm instruction).
6224     The relocation is GOT offset.
6225 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPMOD
6226     This is a 32 bit reloc that stores the Module ID to GOT(n).
6227 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPREL
6228     This is a 32 bit reloc that stores TLS offset to GOT(n+1).
6229 -- : BFD_RELOC_MICROBLAZE_64_TLSDTPREL
6230     This is a 32 bit reloc for storing TLS offset to two words (uses
6231     imm instruction)
6232 -- : BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL
6233     This is a 64 bit reloc that stores 32-bit thread pointer relative
6234     offset to two words (uses imm instruction).
6235 -- : BFD_RELOC_MICROBLAZE_64_TLSTPREL
6236     This is a 64 bit reloc that stores 32-bit thread pointer relative
6237     offset to two words (uses imm instruction).
6238 -- : BFD_RELOC_AARCH64_RELOC_START
6239     AArch64 pseudo relocation code to mark the start of the AArch64
6240     relocation enumerators.  N.B. the order of the enumerators is
6241     important as several tables in the AArch64 bfd backend are indexed
6242     by these enumerators; make sure they are all synced.
6243 -- : BFD_RELOC_AARCH64_NULL
6244     Deprecated AArch64 null relocation code.
6245 -- : BFD_RELOC_AARCH64_NONE
6246     AArch64 null relocation code.
6247 -- : BFD_RELOC_AARCH64_64
6248 -- : BFD_RELOC_AARCH64_32
6249 -- : BFD_RELOC_AARCH64_16
6250     Basic absolute relocations of N bits.  These are equivalent to
6251     BFD_RELOC_N and they were added to assist the indexing of the howto
6252     table.
6253 -- : BFD_RELOC_AARCH64_64_PCREL
6254 -- : BFD_RELOC_AARCH64_32_PCREL
6255 -- : BFD_RELOC_AARCH64_16_PCREL
6256     PC-relative relocations.  These are equivalent to BFD_RELOC_N_PCREL
6257     and they were added to assist the indexing of the howto table.
6258 -- : BFD_RELOC_AARCH64_MOVW_G0
6259     AArch64 MOV[NZK] instruction with most significant bits 0 to 15 of
6260     an unsigned address/value.
6261 -- : BFD_RELOC_AARCH64_MOVW_G0_NC
6262     AArch64 MOV[NZK] instruction with less significant bits 0 to 15 of
6263     an address/value.  No overflow checking.
6264 -- : BFD_RELOC_AARCH64_MOVW_G1
6265     AArch64 MOV[NZK] instruction with most significant bits 16 to 31 of
6266     an unsigned address/value.
6267 -- : BFD_RELOC_AARCH64_MOVW_G1_NC
6268     AArch64 MOV[NZK] instruction with less significant bits 16 to 31 of
6269     an address/value.  No overflow checking.
6270 -- : BFD_RELOC_AARCH64_MOVW_G2
6271     AArch64 MOV[NZK] instruction with most significant bits 32 to 47 of
6272     an unsigned address/value.
6273 -- : BFD_RELOC_AARCH64_MOVW_G2_NC
6274     AArch64 MOV[NZK] instruction with less significant bits 32 to 47 of
6275     an address/value.  No overflow checking.
6276 -- : BFD_RELOC_AARCH64_MOVW_G3
6277     AArch64 MOV[NZK] instruction with most signficant bits 48 to 64 of
6278     a signed or unsigned address/value.
6279 -- : BFD_RELOC_AARCH64_MOVW_G0_S
6280     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6281     signed value.  Changes instruction to MOVZ or MOVN depending on the
6282     value's sign.
6283 -- : BFD_RELOC_AARCH64_MOVW_G1_S
6284     AArch64 MOV[NZ] instruction with most significant bits 16 to 31 of
6285     a signed value.  Changes instruction to MOVZ or MOVN depending on
6286     the value's sign.
6287 -- : BFD_RELOC_AARCH64_MOVW_G2_S
6288     AArch64 MOV[NZ] instruction with most significant bits 32 to 47 of
6289     a signed value.  Changes instruction to MOVZ or MOVN depending on
6290     the value's sign.
6291 -- : BFD_RELOC_AARCH64_LD_LO19_PCREL
6292     AArch64 Load Literal instruction, holding a 19 bit pc-relative word
6293     offset.  The lowest two bits must be zero and are not stored in the
6294     instruction, giving a 21 bit signed byte offset.
6295 -- : BFD_RELOC_AARCH64_ADR_LO21_PCREL
6296     AArch64 ADR instruction, holding a simple 21 bit pc-relative byte
6297     offset.
6298 -- : BFD_RELOC_AARCH64_ADR_HI21_PCREL
6299     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6300     offset, giving a 4KB aligned page base address.
6301 -- : BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL
6302     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6303     offset, giving a 4KB aligned page base address, but with no
6304     overflow checking.
6305 -- : BFD_RELOC_AARCH64_ADD_LO12
6306     AArch64 ADD immediate instruction, holding bits 0 to 11 of the
6307     address.  Used in conjunction with
6308     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6309 -- : BFD_RELOC_AARCH64_LDST8_LO12
6310     AArch64 8-bit load/store instruction, holding bits 0 to 11 of the
6311     address.  Used in conjunction with
6312     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6313 -- : BFD_RELOC_AARCH64_TSTBR14
6314     AArch64 14 bit pc-relative test bit and branch.  The lowest two
6315     bits must be zero and are not stored in the instruction, giving a
6316     16 bit signed byte offset.
6317 -- : BFD_RELOC_AARCH64_BRANCH19
6318     AArch64 19 bit pc-relative conditional branch and compare & branch.
6319     The lowest two bits must be zero and are not stored in the
6320     instruction, giving a 21 bit signed byte offset.
6321 -- : BFD_RELOC_AARCH64_JUMP26
6322     AArch64 26 bit pc-relative unconditional branch.  The lowest two
6323     bits must be zero and are not stored in the instruction, giving a
6324     28 bit signed byte offset.
6325 -- : BFD_RELOC_AARCH64_CALL26
6326     AArch64 26 bit pc-relative unconditional branch and link.  The
6327     lowest two bits must be zero and are not stored in the instruction,
6328     giving a 28 bit signed byte offset.
6329 -- : BFD_RELOC_AARCH64_LDST16_LO12
6330     AArch64 16-bit load/store instruction, holding bits 0 to 11 of the
6331     address.  Used in conjunction with
6332     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6333 -- : BFD_RELOC_AARCH64_LDST32_LO12
6334     AArch64 32-bit load/store instruction, holding bits 0 to 11 of the
6335     address.  Used in conjunction with
6336     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6337 -- : BFD_RELOC_AARCH64_LDST64_LO12
6338     AArch64 64-bit load/store instruction, holding bits 0 to 11 of the
6339     address.  Used in conjunction with
6340     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6341 -- : BFD_RELOC_AARCH64_LDST128_LO12
6342     AArch64 128-bit load/store instruction, holding bits 0 to 11 of the
6343     address.  Used in conjunction with
6344     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6345 -- : BFD_RELOC_AARCH64_GOT_LD_PREL19
6346     AArch64 Load Literal instruction, holding a 19 bit PC relative word
6347     offset of the global offset table entry for a symbol.  The lowest
6348     two bits must be zero and are not stored in the instruction, giving
6349     a 21 bit signed byte offset.  This relocation type requires signed
6350     overflow checking.
6351 -- : BFD_RELOC_AARCH64_ADR_GOT_PAGE
6352     Get to the page base of the global offset table entry for a symbol
6353     as part of an ADRP instruction using a 21 bit PC relative
6354     value.Used in conjunction with BFD_RELOC_AARCH64_LD64_GOT_LO12_NC.
6355 -- : BFD_RELOC_AARCH64_LD64_GOT_LO12_NC
6356     Unsigned 12 bit byte offset for 64 bit load/store from the page of
6357     the GOT entry for this symbol.  Used in conjunction with
6358     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in LP64 ABI only.
6359 -- : BFD_RELOC_AARCH64_LD32_GOT_LO12_NC
6360     Unsigned 12 bit byte offset for 32 bit load/store from the page of
6361     the GOT entry for this symbol.  Used in conjunction with
6362     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in ILP32 ABI only.
6363 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC
6364     Unsigned 16 bit byte offset for 64 bit load/store from the GOT
6365     entry for this symbol.  Valid in LP64 ABI only.
6366 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G1
6367     Unsigned 16 bit byte higher offset for 64 bit load/store from the
6368     GOT entry for this symbol.  Valid in LP64 ABI only.
6369 -- : BFD_RELOC_AARCH64_LD64_GOTOFF_LO15
6370     Unsigned 15 bit byte offset for 64 bit load/store from the page of
6371     the GOT entry for this symbol.  Valid in LP64 ABI only.
6372 -- : BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14
6373     Scaled 14 bit byte offset to the page base of the global offset
6374     table.
6375 -- : BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15
6376     Scaled 15 bit byte offset to the page base of the global offset
6377     table.
6378 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21
6379     Get to the page base of the global offset table entry for a symbols
6380     tls_index structure as part of an adrp instruction using a 21 bit
6381     PC relative value.  Used in conjunction with
6382     BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC.
6383 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PREL21
6384     AArch64 TLS General Dynamic
6385 -- : BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC
6386     Unsigned 12 bit byte offset to global offset table entry for a
6387     symbols tls_index structure.  Used in conjunction with
6388     BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21.
6389 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC
6390     AArch64 TLS General Dynamic relocation.
6391 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G1
6392     AArch64 TLS General Dynamic relocation.
6393 -- : BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21
6394     AArch64 TLS INITIAL EXEC relocation.
6395 -- : BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC
6396     AArch64 TLS INITIAL EXEC relocation.
6397 -- : BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC
6398     AArch64 TLS INITIAL EXEC relocation.
6399 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19
6400     AArch64 TLS INITIAL EXEC relocation.
6401 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC
6402     AArch64 TLS INITIAL EXEC relocation.
6403 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1
6404     AArch64 TLS INITIAL EXEC relocation.
6405 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12
6406     bit[23:12] of byte offset to module TLS base address.
6407 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12
6408     Unsigned 12 bit byte offset to module TLS base address.
6409 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC
6410     No overflow check version of
6411     BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12.
6412 -- : BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC
6413     Unsigned 12 bit byte offset to global offset table entry for a
6414     symbols tls_index structure.  Used in conjunction with
6415     BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21.
6416 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21
6417     GOT entry page address for AArch64 TLS Local Dynamic, used with
6418     ADRP instruction.
6419 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PREL21
6420     GOT entry address for AArch64 TLS Local Dynamic, used with ADR
6421     instruction.
6422 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12
6423     bit[11:1] of byte offset to module TLS base address, encoded in
6424     ldst instructions.
6425 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC
6426     Similar as BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12, but no
6427     overflow check.
6428 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12
6429     bit[11:2] of byte offset to module TLS base address, encoded in
6430     ldst instructions.
6431 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC
6432     Similar as BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12, but no
6433     overflow check.
6434 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12
6435     bit[11:3] of byte offset to module TLS base address, encoded in
6436     ldst instructions.
6437 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC
6438     Similar as BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12, but no
6439     overflow check.
6440 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12
6441     bit[11:0] of byte offset to module TLS base address, encoded in
6442     ldst instructions.
6443 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC
6444     Similar as BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12, but no
6445     overflow check.
6446 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6447     bit[15:0] of byte offset to module TLS base address.
6448 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC
6449     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6450 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6451     bit[31:16] of byte offset to module TLS base address.
6452 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC
6453     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6454 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2
6455     bit[47:32] of byte offset to module TLS base address.
6456 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2
6457     AArch64 TLS LOCAL EXEC relocation.
6458 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1
6459     AArch64 TLS LOCAL EXEC relocation.
6460 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC
6461     AArch64 TLS LOCAL EXEC relocation.
6462 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0
6463     AArch64 TLS LOCAL EXEC relocation.
6464 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC
6465     AArch64 TLS LOCAL EXEC relocation.
6466 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12
6467     AArch64 TLS LOCAL EXEC relocation.
6468 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12
6469     AArch64 TLS LOCAL EXEC relocation.
6470 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC
6471     AArch64 TLS LOCAL EXEC relocation.
6472 -- : BFD_RELOC_AARCH64_TLSDESC_LD_PREL19
6473     AArch64 TLS DESC relocation.
6474 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21
6475     AArch64 TLS DESC relocation.
6476 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21
6477     AArch64 TLS DESC relocation.
6478 -- : BFD_RELOC_AARCH64_TLSDESC_LD64_LO12
6479     AArch64 TLS DESC relocation.
6480 -- : BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC
6481     AArch64 TLS DESC relocation.
6482 -- : BFD_RELOC_AARCH64_TLSDESC_ADD_LO12
6483     AArch64 TLS DESC relocation.
6484 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G1
6485     AArch64 TLS DESC relocation.
6486 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC
6487     AArch64 TLS DESC relocation.
6488 -- : BFD_RELOC_AARCH64_TLSDESC_LDR
6489     AArch64 TLS DESC relocation.
6490 -- : BFD_RELOC_AARCH64_TLSDESC_ADD
6491     AArch64 TLS DESC relocation.
6492 -- : BFD_RELOC_AARCH64_TLSDESC_CALL
6493     AArch64 TLS DESC relocation.
6494 -- : BFD_RELOC_AARCH64_COPY
6495     AArch64 TLS relocation.
6496 -- : BFD_RELOC_AARCH64_GLOB_DAT
6497     AArch64 TLS relocation.
6498 -- : BFD_RELOC_AARCH64_JUMP_SLOT
6499     AArch64 TLS relocation.
6500 -- : BFD_RELOC_AARCH64_RELATIVE
6501     AArch64 TLS relocation.
6502 -- : BFD_RELOC_AARCH64_TLS_DTPMOD
6503     AArch64 TLS relocation.
6504 -- : BFD_RELOC_AARCH64_TLS_DTPREL
6505     AArch64 TLS relocation.
6506 -- : BFD_RELOC_AARCH64_TLS_TPREL
6507     AArch64 TLS relocation.
6508 -- : BFD_RELOC_AARCH64_TLSDESC
6509     AArch64 TLS relocation.
6510 -- : BFD_RELOC_AARCH64_IRELATIVE
6511     AArch64 support for STT_GNU_IFUNC.
6512 -- : BFD_RELOC_AARCH64_RELOC_END
6513     AArch64 pseudo relocation code to mark the end of the AArch64
6514     relocation enumerators that have direct mapping to ELF reloc codes.
6515     There are a few more enumerators after this one; those are mainly
6516     used by the AArch64 assembler for the internal fixup or to select
6517     one of the above enumerators.
6518 -- : BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP
6519     AArch64 pseudo relocation code to be used internally by the AArch64
6520     assembler and not (currently) written to any object files.
6521 -- : BFD_RELOC_AARCH64_LDST_LO12
6522     AArch64 unspecified load/store instruction, holding bits 0 to 11 of
6523     the address.  Used in conjunction with
6524     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6525 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12
6526     AArch64 pseudo relocation code for TLS local dynamic mode.  It's to
6527     be used internally by the AArch64 assembler and not (currently)
6528     written to any object files.
6529 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC
6530     Similar as BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12, but no
6531     overflow check.
6532 -- : BFD_RELOC_AARCH64_LD_GOT_LO12_NC
6533     AArch64 pseudo relocation code to be used internally by the AArch64
6534     assembler and not (currently) written to any object files.
6535 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC
6536     AArch64 pseudo relocation code to be used internally by the AArch64
6537     assembler and not (currently) written to any object files.
6538 -- : BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC
6539     AArch64 pseudo relocation code to be used internally by the AArch64
6540     assembler and not (currently) written to any object files.
6541 -- : BFD_RELOC_TILEPRO_COPY
6542 -- : BFD_RELOC_TILEPRO_GLOB_DAT
6543 -- : BFD_RELOC_TILEPRO_JMP_SLOT
6544 -- : BFD_RELOC_TILEPRO_RELATIVE
6545 -- : BFD_RELOC_TILEPRO_BROFF_X1
6546 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1
6547 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
6548 -- : BFD_RELOC_TILEPRO_IMM8_X0
6549 -- : BFD_RELOC_TILEPRO_IMM8_Y0
6550 -- : BFD_RELOC_TILEPRO_IMM8_X1
6551 -- : BFD_RELOC_TILEPRO_IMM8_Y1
6552 -- : BFD_RELOC_TILEPRO_DEST_IMM8_X1
6553 -- : BFD_RELOC_TILEPRO_MT_IMM15_X1
6554 -- : BFD_RELOC_TILEPRO_MF_IMM15_X1
6555 -- : BFD_RELOC_TILEPRO_IMM16_X0
6556 -- : BFD_RELOC_TILEPRO_IMM16_X1
6557 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO
6558 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO
6559 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI
6560 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI
6561 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA
6562 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA
6563 -- : BFD_RELOC_TILEPRO_IMM16_X0_PCREL
6564 -- : BFD_RELOC_TILEPRO_IMM16_X1_PCREL
6565 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
6566 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
6567 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
6568 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
6569 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
6570 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
6571 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT
6572 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT
6573 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
6574 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
6575 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
6576 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
6577 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
6578 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
6579 -- : BFD_RELOC_TILEPRO_MMSTART_X0
6580 -- : BFD_RELOC_TILEPRO_MMEND_X0
6581 -- : BFD_RELOC_TILEPRO_MMSTART_X1
6582 -- : BFD_RELOC_TILEPRO_MMEND_X1
6583 -- : BFD_RELOC_TILEPRO_SHAMT_X0
6584 -- : BFD_RELOC_TILEPRO_SHAMT_X1
6585 -- : BFD_RELOC_TILEPRO_SHAMT_Y0
6586 -- : BFD_RELOC_TILEPRO_SHAMT_Y1
6587 -- : BFD_RELOC_TILEPRO_TLS_GD_CALL
6588 -- : BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
6589 -- : BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
6590 -- : BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
6591 -- : BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
6592 -- : BFD_RELOC_TILEPRO_TLS_IE_LOAD
6593 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
6594 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
6595 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
6596 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
6597 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
6598 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
6599 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
6600 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
6601 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
6602 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
6603 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
6604 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
6605 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
6606 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
6607 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
6608 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
6609 -- : BFD_RELOC_TILEPRO_TLS_DTPMOD32
6610 -- : BFD_RELOC_TILEPRO_TLS_DTPOFF32
6611 -- : BFD_RELOC_TILEPRO_TLS_TPOFF32
6612 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
6613 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
6614 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
6615 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
6616 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
6617 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
6618 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
6619 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
6620     Tilera TILEPro Relocations.
6621 -- : BFD_RELOC_TILEGX_HW0
6622 -- : BFD_RELOC_TILEGX_HW1
6623 -- : BFD_RELOC_TILEGX_HW2
6624 -- : BFD_RELOC_TILEGX_HW3
6625 -- : BFD_RELOC_TILEGX_HW0_LAST
6626 -- : BFD_RELOC_TILEGX_HW1_LAST
6627 -- : BFD_RELOC_TILEGX_HW2_LAST
6628 -- : BFD_RELOC_TILEGX_COPY
6629 -- : BFD_RELOC_TILEGX_GLOB_DAT
6630 -- : BFD_RELOC_TILEGX_JMP_SLOT
6631 -- : BFD_RELOC_TILEGX_RELATIVE
6632 -- : BFD_RELOC_TILEGX_BROFF_X1
6633 -- : BFD_RELOC_TILEGX_JUMPOFF_X1
6634 -- : BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
6635 -- : BFD_RELOC_TILEGX_IMM8_X0
6636 -- : BFD_RELOC_TILEGX_IMM8_Y0
6637 -- : BFD_RELOC_TILEGX_IMM8_X1
6638 -- : BFD_RELOC_TILEGX_IMM8_Y1
6639 -- : BFD_RELOC_TILEGX_DEST_IMM8_X1
6640 -- : BFD_RELOC_TILEGX_MT_IMM14_X1
6641 -- : BFD_RELOC_TILEGX_MF_IMM14_X1
6642 -- : BFD_RELOC_TILEGX_MMSTART_X0
6643 -- : BFD_RELOC_TILEGX_MMEND_X0
6644 -- : BFD_RELOC_TILEGX_SHAMT_X0
6645 -- : BFD_RELOC_TILEGX_SHAMT_X1
6646 -- : BFD_RELOC_TILEGX_SHAMT_Y0
6647 -- : BFD_RELOC_TILEGX_SHAMT_Y1
6648 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0
6649 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0
6650 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1
6651 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1
6652 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2
6653 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2
6654 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3
6655 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3
6656 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6657 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6658 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6659 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
6660 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
6661 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
6662 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
6663 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
6664 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
6665 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
6666 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
6667 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
6668 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
6669 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
6670 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
6671 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
6672 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
6673 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
6674 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
6675 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
6676 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
6677 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
6678 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL
6679 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL
6680 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL
6681 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL
6682 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL
6683 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL
6684 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
6685 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
6686 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
6687 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
6688 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL
6689 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL
6690 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
6691 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
6692 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
6693 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
6694 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
6695 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
6696 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
6697 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
6698 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
6699 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
6700 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
6701 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
6702 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
6703 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
6704 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL
6705 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL
6706 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL
6707 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL
6708 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL
6709 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL
6710 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
6711 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
6712 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
6713 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
6714 -- : BFD_RELOC_TILEGX_TLS_DTPMOD64
6715 -- : BFD_RELOC_TILEGX_TLS_DTPOFF64
6716 -- : BFD_RELOC_TILEGX_TLS_TPOFF64
6717 -- : BFD_RELOC_TILEGX_TLS_DTPMOD32
6718 -- : BFD_RELOC_TILEGX_TLS_DTPOFF32
6719 -- : BFD_RELOC_TILEGX_TLS_TPOFF32
6720 -- : BFD_RELOC_TILEGX_TLS_GD_CALL
6721 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
6722 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
6723 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
6724 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
6725 -- : BFD_RELOC_TILEGX_TLS_IE_LOAD
6726 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
6727 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
6728 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
6729 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
6730     Tilera TILE-Gx Relocations.
6731 -- : BFD_RELOC_EPIPHANY_SIMM8
6732     Adapteva EPIPHANY - 8 bit signed pc-relative displacement
6733 -- : BFD_RELOC_EPIPHANY_SIMM24
6734     Adapteva EPIPHANY - 24 bit signed pc-relative displacement
6735 -- : BFD_RELOC_EPIPHANY_HIGH
6736     Adapteva EPIPHANY - 16 most-significant bits of absolute address
6737 -- : BFD_RELOC_EPIPHANY_LOW
6738     Adapteva EPIPHANY - 16 least-significant bits of absolute address
6739 -- : BFD_RELOC_EPIPHANY_SIMM11
6740     Adapteva EPIPHANY - 11 bit signed number - add/sub immediate
6741 -- : BFD_RELOC_EPIPHANY_IMM11
6742     Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st
6743     displacement)
6744 -- : BFD_RELOC_EPIPHANY_IMM8
6745     Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
6746 -- : BFD_RELOC_VISIUM_HI16
6747 -- : BFD_RELOC_VISIUM_LO16
6748 -- : BFD_RELOC_VISIUM_IM16
6749 -- : BFD_RELOC_VISIUM_REL16
6750 -- : BFD_RELOC_VISIUM_HI16_PCREL
6751 -- : BFD_RELOC_VISIUM_LO16_PCREL
6752 -- : BFD_RELOC_VISIUM_IM16_PCREL
6753     Visium Relocations.
6754 -- : BFD_RELOC_WASM32_LEB128
6755 -- : BFD_RELOC_WASM32_LEB128_GOT
6756 -- : BFD_RELOC_WASM32_LEB128_GOT_CODE
6757 -- : BFD_RELOC_WASM32_LEB128_PLT
6758 -- : BFD_RELOC_WASM32_PLT_INDEX
6759 -- : BFD_RELOC_WASM32_ABS32_CODE
6760 -- : BFD_RELOC_WASM32_COPY
6761 -- : BFD_RELOC_WASM32_CODE_POINTER
6762 -- : BFD_RELOC_WASM32_INDEX
6763 -- : BFD_RELOC_WASM32_PLT_SIG
6764     WebAssembly relocations.
6765
6766
6767     typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
6768
67692.10.2.2 'bfd_reloc_type_lookup'
6770................................
6771
6772*Synopsis*
6773     reloc_howto_type *bfd_reloc_type_lookup
6774        (bfd *abfd, bfd_reloc_code_real_type code);
6775     reloc_howto_type *bfd_reloc_name_lookup
6776        (bfd *abfd, const char *reloc_name);
6777   *Description*
6778Return a pointer to a howto structure which, when invoked, will perform
6779the relocation CODE on data from the architecture noted.
6780
67812.10.2.3 'bfd_default_reloc_type_lookup'
6782........................................
6783
6784*Synopsis*
6785     reloc_howto_type *bfd_default_reloc_type_lookup
6786        (bfd *abfd, bfd_reloc_code_real_type  code);
6787   *Description*
6788Provides a default relocation lookup routine for any architecture.
6789
67902.10.2.4 'bfd_get_reloc_code_name'
6791..................................
6792
6793*Synopsis*
6794     const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
6795   *Description*
6796Provides a printable name for the supplied relocation code.  Useful
6797mainly for printing error messages.
6798
67992.10.2.5 'bfd_generic_relax_section'
6800....................................
6801
6802*Synopsis*
6803     bfd_boolean bfd_generic_relax_section
6804        (bfd *abfd,
6805         asection *section,
6806         struct bfd_link_info *,
6807         bfd_boolean *);
6808   *Description*
6809Provides default handling for relaxing for back ends which don't do
6810relaxing.
6811
68122.10.2.6 'bfd_generic_gc_sections'
6813..................................
6814
6815*Synopsis*
6816     bfd_boolean bfd_generic_gc_sections
6817        (bfd *, struct bfd_link_info *);
6818   *Description*
6819Provides default handling for relaxing for back ends which don't do
6820section gc - i.e., does nothing.
6821
68222.10.2.7 'bfd_generic_lookup_section_flags'
6823...........................................
6824
6825*Synopsis*
6826     bfd_boolean bfd_generic_lookup_section_flags
6827        (struct bfd_link_info *, struct flag_info *, asection *);
6828   *Description*
6829Provides default handling for section flags lookup - i.e., does nothing.
6830Returns FALSE if the section should be omitted, otherwise TRUE.
6831
68322.10.2.8 'bfd_generic_merge_sections'
6833.....................................
6834
6835*Synopsis*
6836     bfd_boolean bfd_generic_merge_sections
6837        (bfd *, struct bfd_link_info *);
6838   *Description*
6839Provides default handling for SEC_MERGE section merging for back ends
6840which don't have SEC_MERGE support - i.e., does nothing.
6841
68422.10.2.9 'bfd_generic_get_relocated_section_contents'
6843.....................................................
6844
6845*Synopsis*
6846     bfd_byte *bfd_generic_get_relocated_section_contents
6847        (bfd *abfd,
6848         struct bfd_link_info *link_info,
6849         struct bfd_link_order *link_order,
6850         bfd_byte *data,
6851         bfd_boolean relocatable,
6852         asymbol **symbols);
6853   *Description*
6854Provides default handling of relocation effort for back ends which can't
6855be bothered to do it efficiently.
6856
68572.10.2.10 '_bfd_generic_set_reloc'
6858..................................
6859
6860*Synopsis*
6861     void _bfd_generic_set_reloc
6862        (bfd *abfd,
6863         sec_ptr section,
6864         arelent **relptr,
6865         unsigned int count);
6866   *Description*
6867Installs a new set of internal relocations in SECTION.
6868
68692.10.2.11 '_bfd_unrecognized_reloc'
6870...................................
6871
6872*Synopsis*
6873     bfd_boolean _bfd_unrecognized_reloc
6874        (bfd * abfd,
6875         sec_ptr section,
6876         unsigned int r_type);
6877   *Description*
6878Reports an unrecognized reloc.  Written as a function in order to reduce
6879code duplication.  Returns FALSE so that it can be called from a return
6880statement.
6881
6882
6883File: bfd.info,  Node: Core Files,  Next: Targets,  Prev: Relocations,  Up: BFD front end
6884
68852.11 Core files
6886===============
6887
68882.11.1 Core file functions
6889--------------------------
6890
6891*Description*
6892These are functions pertaining to core files.
6893
68942.11.1.1 'bfd_core_file_failing_command'
6895........................................
6896
6897*Synopsis*
6898     const char *bfd_core_file_failing_command (bfd *abfd);
6899   *Description*
6900Return a read-only string explaining which program was running when it
6901failed and produced the core file ABFD.
6902
69032.11.1.2 'bfd_core_file_failing_signal'
6904.......................................
6905
6906*Synopsis*
6907     int bfd_core_file_failing_signal (bfd *abfd);
6908   *Description*
6909Returns the signal number which caused the core dump which generated the
6910file the BFD ABFD is attached to.
6911
69122.11.1.3 'bfd_core_file_pid'
6913............................
6914
6915*Synopsis*
6916     int bfd_core_file_pid (bfd *abfd);
6917   *Description*
6918Returns the PID of the process the core dump the BFD ABFD is attached to
6919was generated from.
6920
69212.11.1.4 'core_file_matches_executable_p'
6922.........................................
6923
6924*Synopsis*
6925     bfd_boolean core_file_matches_executable_p
6926        (bfd *core_bfd, bfd *exec_bfd);
6927   *Description*
6928Return 'TRUE' if the core file attached to CORE_BFD was generated by a
6929run of the executable file attached to EXEC_BFD, 'FALSE' otherwise.
6930
69312.11.1.5 'generic_core_file_matches_executable_p'
6932.................................................
6933
6934*Synopsis*
6935     bfd_boolean generic_core_file_matches_executable_p
6936        (bfd *core_bfd, bfd *exec_bfd);
6937   *Description*
6938Return TRUE if the core file attached to CORE_BFD was generated by a run
6939of the executable file attached to EXEC_BFD.  The match is based on
6940executable basenames only.
6941
6942   Note: When not able to determine the core file failing command or the
6943executable name, we still return TRUE even though we're not sure that
6944core file and executable match.  This is to avoid generating a false
6945warning in situations where we really don't know whether they match or
6946not.
6947
6948
6949File: bfd.info,  Node: Targets,  Next: Architectures,  Prev: Core Files,  Up: BFD front end
6950
69512.12 Targets
6952============
6953
6954*Description*
6955Each port of BFD to a different machine requires the creation of a
6956target back end.  All the back end provides to the root part of BFD is a
6957structure containing pointers to functions which perform certain low
6958level operations on files.  BFD translates the applications's requests
6959through a pointer into calls to the back end routines.
6960
6961   When a file is opened with 'bfd_openr', its format and target are
6962unknown.  BFD uses various mechanisms to determine how to interpret the
6963file.  The operations performed are:
6964
6965   * Create a BFD by calling the internal routine '_bfd_new_bfd', then
6966     call 'bfd_find_target' with the target string supplied to
6967     'bfd_openr' and the new BFD pointer.
6968
6969   * If a null target string was provided to 'bfd_find_target', look up
6970     the environment variable 'GNUTARGET' and use that as the target
6971     string.
6972
6973   * If the target string is still 'NULL', or the target string is
6974     'default', then use the first item in the target vector as the
6975     target type, and set 'target_defaulted' in the BFD to cause
6976     'bfd_check_format' to loop through all the targets.  *Note
6977     bfd_target::.  *Note Formats::.
6978
6979   * Otherwise, inspect the elements in the target vector one by one,
6980     until a match on target name is found.  When found, use it.
6981
6982   * Otherwise return the error 'bfd_error_invalid_target' to
6983     'bfd_openr'.
6984
6985   * 'bfd_openr' attempts to open the file using 'bfd_open_file', and
6986     returns the BFD.
6987   Once the BFD has been opened and the target selected, the file format
6988may be determined.  This is done by calling 'bfd_check_format' on the
6989BFD with a suggested format.  If 'target_defaulted' has been set, each
6990possible target type is tried to see if it recognizes the specified
6991format.  'bfd_check_format' returns 'TRUE' when the caller guesses
6992right.
6993* Menu:
6994
6995* bfd_target::
6996
6997
6998File: bfd.info,  Node: bfd_target,  Prev: Targets,  Up: Targets
6999
70002.12.1 bfd_target
7001-----------------
7002
7003*Description*
7004This structure contains everything that BFD knows about a target.  It
7005includes things like its byte order, name, and which routines to call to
7006do various operations.
7007
7008   Every BFD points to a target structure with its 'xvec' member.
7009
7010   The macros below are used to dispatch to functions through the
7011'bfd_target' vector.  They are used in a number of macros further down
7012in 'bfd.h', and are also used when calling various routines by hand
7013inside the BFD implementation.  The ARGLIST argument must be
7014parenthesized; it contains all the arguments to the called function.
7015
7016   They make the documentation (more) unpleasant to read, so if someone
7017wants to fix this and not break the above, please do.
7018     #define BFD_SEND(bfd, message, arglist) \
7019       ((*((bfd)->xvec->message)) arglist)
7020
7021     #ifdef DEBUG_BFD_SEND
7022     #undef BFD_SEND
7023     #define BFD_SEND(bfd, message, arglist) \
7024       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7025         ((*((bfd)->xvec->message)) arglist) : \
7026         (bfd_assert (__FILE__,__LINE__), NULL))
7027     #endif
7028   For operations which index on the BFD format:
7029     #define BFD_SEND_FMT(bfd, message, arglist) \
7030       (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
7031
7032     #ifdef DEBUG_BFD_SEND
7033     #undef BFD_SEND_FMT
7034     #define BFD_SEND_FMT(bfd, message, arglist) \
7035       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7036        (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
7037        (bfd_assert (__FILE__,__LINE__), NULL))
7038     #endif
7039
7040   This is the structure which defines the type of BFD this is.  The
7041'xvec' member of the struct 'bfd' itself points here.  Each module that
7042implements access to a different target under BFD, defines one of these.
7043
7044   FIXME, these names should be rationalised with the names of the entry
7045points which call them.  Too bad we can't have one macro to define them
7046both!
7047     enum bfd_flavour
7048     {
7049       /* N.B. Update bfd_flavour_name if you change this.  */
7050       bfd_target_unknown_flavour,
7051       bfd_target_aout_flavour,
7052       bfd_target_coff_flavour,
7053       bfd_target_ecoff_flavour,
7054       bfd_target_xcoff_flavour,
7055       bfd_target_elf_flavour,
7056       bfd_target_ieee_flavour,
7057       bfd_target_nlm_flavour,
7058       bfd_target_oasys_flavour,
7059       bfd_target_tekhex_flavour,
7060       bfd_target_srec_flavour,
7061       bfd_target_verilog_flavour,
7062       bfd_target_ihex_flavour,
7063       bfd_target_som_flavour,
7064       bfd_target_os9k_flavour,
7065       bfd_target_versados_flavour,
7066       bfd_target_msdos_flavour,
7067       bfd_target_ovax_flavour,
7068       bfd_target_evax_flavour,
7069       bfd_target_mmo_flavour,
7070       bfd_target_mach_o_flavour,
7071       bfd_target_pef_flavour,
7072       bfd_target_pef_xlib_flavour,
7073       bfd_target_sym_flavour
7074     };
7075
7076     enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
7077
7078     /* Forward declaration.  */
7079     typedef struct bfd_link_info _bfd_link_info;
7080
7081     /* Forward declaration.  */
7082     typedef struct flag_info flag_info;
7083
7084     typedef struct bfd_target
7085     {
7086       /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
7087       char *name;
7088
7089      /* The "flavour" of a back end is a general indication about
7090         the contents of a file.  */
7091       enum bfd_flavour flavour;
7092
7093       /* The order of bytes within the data area of a file.  */
7094       enum bfd_endian byteorder;
7095
7096      /* The order of bytes within the header parts of a file.  */
7097       enum bfd_endian header_byteorder;
7098
7099       /* A mask of all the flags which an executable may have set -
7100          from the set BFD_NO_FLAGS, HAS_RELOC, ...D_PAGED.  */
7101       flagword object_flags;
7102
7103      /* A mask of all the flags which a section may have set - from
7104         the set SEC_NO_FLAGS, SEC_ALLOC, ...SET_NEVER_LOAD.  */
7105       flagword section_flags;
7106
7107      /* The character normally found at the front of a symbol.
7108         (if any), perhaps `_'.  */
7109       char symbol_leading_char;
7110
7111      /* The pad character for file names within an archive header.  */
7112       char ar_pad_char;
7113
7114       /* The maximum number of characters in an archive header.  */
7115       unsigned char ar_max_namelen;
7116
7117       /* How well this target matches, used to select between various
7118          possible targets when more than one target matches.  */
7119       unsigned char match_priority;
7120
7121       /* Entries for byte swapping for data. These are different from the
7122          other entry points, since they don't take a BFD as the first argument.
7123          Certain other handlers could do the same.  */
7124       bfd_uint64_t   (*bfd_getx64) (const void *);
7125       bfd_int64_t    (*bfd_getx_signed_64) (const void *);
7126       void           (*bfd_putx64) (bfd_uint64_t, void *);
7127       bfd_vma        (*bfd_getx32) (const void *);
7128       bfd_signed_vma (*bfd_getx_signed_32) (const void *);
7129       void           (*bfd_putx32) (bfd_vma, void *);
7130       bfd_vma        (*bfd_getx16) (const void *);
7131       bfd_signed_vma (*bfd_getx_signed_16) (const void *);
7132       void           (*bfd_putx16) (bfd_vma, void *);
7133
7134       /* Byte swapping for the headers.  */
7135       bfd_uint64_t   (*bfd_h_getx64) (const void *);
7136       bfd_int64_t    (*bfd_h_getx_signed_64) (const void *);
7137       void           (*bfd_h_putx64) (bfd_uint64_t, void *);
7138       bfd_vma        (*bfd_h_getx32) (const void *);
7139       bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
7140       void           (*bfd_h_putx32) (bfd_vma, void *);
7141       bfd_vma        (*bfd_h_getx16) (const void *);
7142       bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
7143       void           (*bfd_h_putx16) (bfd_vma, void *);
7144
7145       /* Format dependent routines: these are vectors of entry points
7146          within the target vector structure, one for each format to check.  */
7147
7148       /* Check the format of a file being read.  Return a bfd_target * or zero.  */
7149       const struct bfd_target *
7150                   (*_bfd_check_format[bfd_type_end]) (bfd *);
7151
7152       /* Set the format of a file being written.  */
7153       bfd_boolean (*_bfd_set_format[bfd_type_end]) (bfd *);
7154
7155       /* Write cached information into a file being written, at bfd_close.  */
7156       bfd_boolean (*_bfd_write_contents[bfd_type_end]) (bfd *);
7157
7158   The general target vector.  These vectors are initialized using the
7159BFD_JUMP_TABLE macros.
7160
7161       /* Generic entry points.  */
7162     #define BFD_JUMP_TABLE_GENERIC(NAME) \
7163       NAME##_close_and_cleanup, \
7164       NAME##_bfd_free_cached_info, \
7165       NAME##_new_section_hook, \
7166       NAME##_get_section_contents, \
7167       NAME##_get_section_contents_in_window
7168
7169       /* Called when the BFD is being closed to do any necessary cleanup.  */
7170       bfd_boolean (*_close_and_cleanup) (bfd *);
7171       /* Ask the BFD to free all cached information.  */
7172       bfd_boolean (*_bfd_free_cached_info) (bfd *);
7173       /* Called when a new section is created.  */
7174       bfd_boolean (*_new_section_hook) (bfd *, sec_ptr);
7175       /* Read the contents of a section.  */
7176       bfd_boolean (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
7177                                                 bfd_size_type);
7178       bfd_boolean (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr,
7179                                                           bfd_window *, file_ptr,
7180                                                           bfd_size_type);
7181
7182       /* Entry points to copy private data.  */
7183     #define BFD_JUMP_TABLE_COPY(NAME) \
7184       NAME##_bfd_copy_private_bfd_data, \
7185       NAME##_bfd_merge_private_bfd_data, \
7186       _bfd_generic_init_private_section_data, \
7187       NAME##_bfd_copy_private_section_data, \
7188       NAME##_bfd_copy_private_symbol_data, \
7189       NAME##_bfd_copy_private_header_data, \
7190       NAME##_bfd_set_private_flags, \
7191       NAME##_bfd_print_private_bfd_data
7192
7193       /* Called to copy BFD general private data from one object file
7194          to another.  */
7195       bfd_boolean (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
7196       /* Called to merge BFD general private data from one object file
7197          to a common output file when linking.  */
7198       bfd_boolean (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
7199       /* Called to initialize BFD private section data from one object file
7200          to another.  */
7201     #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
7202            BFD_SEND (obfd, _bfd_init_private_section_data, \
7203                      (ibfd, isec, obfd, osec, link_info))
7204       bfd_boolean (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *,
7205                                                      sec_ptr,
7206                                                      struct bfd_link_info *);
7207       /* Called to copy BFD private section data from one object file
7208          to another.  */
7209       bfd_boolean (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *,
7210                                                      sec_ptr);
7211       /* Called to copy BFD private symbol data from one symbol
7212          to another.  */
7213       bfd_boolean (*_bfd_copy_private_symbol_data) (bfd *, asymbol *, bfd *,
7214                                                     asymbol *);
7215       /* Called to copy BFD private header data from one object file
7216          to another.  */
7217       bfd_boolean (*_bfd_copy_private_header_data) (bfd *, bfd *);
7218       /* Called to set private backend flags.  */
7219       bfd_boolean (*_bfd_set_private_flags) (bfd *, flagword);
7220
7221       /* Called to print private BFD data.  */
7222       bfd_boolean (*_bfd_print_private_bfd_data) (bfd *, void *);
7223
7224       /* Core file entry points.  */
7225     #define BFD_JUMP_TABLE_CORE(NAME) \
7226       NAME##_core_file_failing_command, \
7227       NAME##_core_file_failing_signal, \
7228       NAME##_core_file_matches_executable_p, \
7229       NAME##_core_file_pid
7230
7231       char *      (*_core_file_failing_command) (bfd *);
7232       int         (*_core_file_failing_signal) (bfd *);
7233       bfd_boolean (*_core_file_matches_executable_p) (bfd *, bfd *);
7234       int         (*_core_file_pid) (bfd *);
7235
7236       /* Archive entry points.  */
7237     #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
7238       NAME##_slurp_armap, \
7239       NAME##_slurp_extended_name_table, \
7240       NAME##_construct_extended_name_table, \
7241       NAME##_truncate_arname, \
7242       NAME##_write_armap, \
7243       NAME##_read_ar_hdr, \
7244       NAME##_write_ar_hdr, \
7245       NAME##_openr_next_archived_file, \
7246       NAME##_get_elt_at_index, \
7247       NAME##_generic_stat_arch_elt, \
7248       NAME##_update_armap_timestamp
7249
7250       bfd_boolean (*_bfd_slurp_armap) (bfd *);
7251       bfd_boolean (*_bfd_slurp_extended_name_table) (bfd *);
7252       bfd_boolean (*_bfd_construct_extended_name_table) (bfd *, char **,
7253                                                          bfd_size_type *,
7254                                                          const char **);
7255       void        (*_bfd_truncate_arname) (bfd *, const char *, char *);
7256       bfd_boolean (*write_armap) (bfd *, unsigned int, struct orl *,
7257                                   unsigned int, int);
7258       void *      (*_bfd_read_ar_hdr_fn) (bfd *);
7259       bfd_boolean (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
7260       bfd *       (*openr_next_archived_file) (bfd *, bfd *);
7261     #define bfd_get_elt_at_index(b,i) \
7262            BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
7263       bfd *       (*_bfd_get_elt_at_index) (bfd *, symindex);
7264       int         (*_bfd_stat_arch_elt) (bfd *, struct stat *);
7265       bfd_boolean (*_bfd_update_armap_timestamp) (bfd *);
7266
7267       /* Entry points used for symbols.  */
7268     #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
7269       NAME##_get_symtab_upper_bound, \
7270       NAME##_canonicalize_symtab, \
7271       NAME##_make_empty_symbol, \
7272       NAME##_print_symbol, \
7273       NAME##_get_symbol_info, \
7274       NAME##_get_symbol_version_string, \
7275       NAME##_bfd_is_local_label_name, \
7276       NAME##_bfd_is_target_special_symbol, \
7277       NAME##_get_lineno, \
7278       NAME##_find_nearest_line, \
7279       NAME##_find_line, \
7280       NAME##_find_inliner_info, \
7281       NAME##_bfd_make_debug_symbol, \
7282       NAME##_read_minisymbols, \
7283       NAME##_minisymbol_to_symbol
7284
7285       long        (*_bfd_get_symtab_upper_bound) (bfd *);
7286       long        (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
7287       struct bfd_symbol *
7288                   (*_bfd_make_empty_symbol) (bfd *);
7289       void        (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
7290                                         bfd_print_symbol_type);
7291     #define bfd_print_symbol(b,p,s,e) \
7292            BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
7293       void        (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *,
7294                                            symbol_info *);
7295     #define bfd_get_symbol_info(b,p,e) \
7296            BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
7297       const char *(*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
7298                                                      bfd_boolean *);
7299     #define bfd_get_symbol_version_string(b,s,h) \
7300            BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,h))
7301       bfd_boolean (*_bfd_is_local_label_name) (bfd *, const char *);
7302       bfd_boolean (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
7303       alent *     (*_get_lineno) (bfd *, struct bfd_symbol *);
7304       bfd_boolean (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
7305                                              struct bfd_section *, bfd_vma,
7306                                              const char **, const char **,
7307                                              unsigned int *, unsigned int *);
7308       bfd_boolean (*_bfd_find_line) (bfd *, struct bfd_symbol **,
7309                                      struct bfd_symbol *, const char **,
7310                                      unsigned int *);
7311       bfd_boolean (*_bfd_find_inliner_info)
7312         (bfd *, const char **, const char **, unsigned int *);
7313      /* Back-door to allow format-aware applications to create debug symbols
7314         while using BFD for everything else.  Currently used by the assembler
7315         when creating COFF files.  */
7316       asymbol *   (*_bfd_make_debug_symbol) (bfd *, void *, unsigned long size);
7317     #define bfd_read_minisymbols(b, d, m, s) \
7318            BFD_SEND (b, _read_minisymbols, (b, d, m, s))
7319       long        (*_read_minisymbols) (bfd *, bfd_boolean, void **,
7320                                         unsigned int *);
7321     #define bfd_minisymbol_to_symbol(b, d, m, f) \
7322            BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
7323       asymbol *   (*_minisymbol_to_symbol) (bfd *, bfd_boolean, const void *,
7324                                             asymbol *);
7325
7326       /* Routines for relocs.  */
7327     #define BFD_JUMP_TABLE_RELOCS(NAME) \
7328       NAME##_get_reloc_upper_bound, \
7329       NAME##_canonicalize_reloc, \
7330       NAME##_set_reloc, \
7331       NAME##_bfd_reloc_type_lookup, \
7332       NAME##_bfd_reloc_name_lookup
7333
7334       long        (*_get_reloc_upper_bound) (bfd *, sec_ptr);
7335       long        (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
7336                                               struct bfd_symbol **);
7337       void        (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
7338       /* See documentation on reloc types.  */
7339       reloc_howto_type *
7340                   (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
7341       reloc_howto_type *
7342                   (*reloc_name_lookup) (bfd *, const char *);
7343
7344       /* Routines used when writing an object file.  */
7345     #define BFD_JUMP_TABLE_WRITE(NAME) \
7346       NAME##_set_arch_mach, \
7347       NAME##_set_section_contents
7348
7349       bfd_boolean (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
7350                                          unsigned long);
7351       bfd_boolean (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
7352                                                 file_ptr, bfd_size_type);
7353
7354       /* Routines used by the linker.  */
7355     #define BFD_JUMP_TABLE_LINK(NAME) \
7356       NAME##_sizeof_headers, \
7357       NAME##_bfd_get_relocated_section_contents, \
7358       NAME##_bfd_relax_section, \
7359       NAME##_bfd_link_hash_table_create, \
7360       NAME##_bfd_link_add_symbols, \
7361       NAME##_bfd_link_just_syms, \
7362       NAME##_bfd_copy_link_hash_symbol_type, \
7363       NAME##_bfd_final_link, \
7364       NAME##_bfd_link_split_section, \
7365       NAME##_bfd_link_check_relocs, \
7366       NAME##_bfd_gc_sections, \
7367       NAME##_bfd_lookup_section_flags, \
7368       NAME##_bfd_merge_sections, \
7369       NAME##_bfd_is_group_section, \
7370       NAME##_bfd_discard_group, \
7371       NAME##_section_already_linked, \
7372       NAME##_bfd_define_common_symbol, \
7373       NAME##_bfd_define_start_stop
7374
7375       int         (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
7376       bfd_byte *  (*_bfd_get_relocated_section_contents) (bfd *,
7377                                                           struct bfd_link_info *,
7378                                                           struct bfd_link_order *,
7379                                                           bfd_byte *, bfd_boolean,
7380                                                           struct bfd_symbol **);
7381
7382       bfd_boolean (*_bfd_relax_section) (bfd *, struct bfd_section *,
7383                                          struct bfd_link_info *, bfd_boolean *);
7384
7385       /* Create a hash table for the linker.  Different backends store
7386          different information in this table.  */
7387       struct bfd_link_hash_table *
7388                   (*_bfd_link_hash_table_create) (bfd *);
7389
7390       /* Add symbols from this object file into the hash table.  */
7391       bfd_boolean (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
7392
7393       /* Indicate that we are only retrieving symbol values from this section.  */
7394       void        (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
7395
7396       /* Copy the symbol type and other attributes for a linker script
7397          assignment of one symbol to another.  */
7398     #define bfd_copy_link_hash_symbol_type(b, t, f) \
7399            BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
7400       void        (*_bfd_copy_link_hash_symbol_type) (bfd *,
7401                                                       struct bfd_link_hash_entry *,
7402                                                       struct bfd_link_hash_entry *);
7403
7404       /* Do a link based on the link_order structures attached to each
7405          section of the BFD.  */
7406       bfd_boolean (*_bfd_final_link) (bfd *, struct bfd_link_info *);
7407
7408       /* Should this section be split up into smaller pieces during linking.  */
7409       bfd_boolean (*_bfd_link_split_section) (bfd *, struct bfd_section *);
7410
7411       /* Check the relocations in the bfd for validity.  */
7412       bfd_boolean (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
7413
7414       /* Remove sections that are not referenced from the output.  */
7415       bfd_boolean (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
7416
7417       /* Sets the bitmask of allowed and disallowed section flags.  */
7418       bfd_boolean (*_bfd_lookup_section_flags) (struct bfd_link_info *,
7419                                                 struct flag_info *, asection *);
7420
7421       /* Attempt to merge SEC_MERGE sections.  */
7422       bfd_boolean (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
7423
7424       /* Is this section a member of a group?  */
7425       bfd_boolean (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
7426
7427       /* Discard members of a group.  */
7428       bfd_boolean (*_bfd_discard_group) (bfd *, struct bfd_section *);
7429
7430       /* Check if SEC has been already linked during a reloceatable or
7431          final link.  */
7432       bfd_boolean (*_section_already_linked) (bfd *, asection *,
7433                                               struct bfd_link_info *);
7434
7435       /* Define a common symbol.  */
7436       bfd_boolean (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
7437                                                 struct bfd_link_hash_entry *);
7438
7439       /* Define a __start, __stop, .startof. or .sizeof. symbol.  */
7440       struct bfd_link_hash_entry *
7441                   (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
7442                                              asection *);
7443
7444       /* Routines to handle dynamic symbols and relocs.  */
7445     #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
7446       NAME##_get_dynamic_symtab_upper_bound, \
7447       NAME##_canonicalize_dynamic_symtab, \
7448       NAME##_get_synthetic_symtab, \
7449       NAME##_get_dynamic_reloc_upper_bound, \
7450       NAME##_canonicalize_dynamic_reloc
7451
7452       /* Get the amount of memory required to hold the dynamic symbols.  */
7453       long        (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
7454       /* Read in the dynamic symbols.  */
7455       long        (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
7456       /* Create synthetized symbols.  */
7457       long        (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
7458                                                 long, struct bfd_symbol **,
7459                                                 struct bfd_symbol **);
7460       /* Get the amount of memory required to hold the dynamic relocs.  */
7461       long        (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
7462       /* Read in the dynamic relocs.  */
7463       long        (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
7464                                                       struct bfd_symbol **);
7465
7466   A pointer to an alternative bfd_target in case the current one is not
7467satisfactory.  This can happen when the target cpu supports both big and
7468little endian code, and target chosen by the linker has the wrong
7469endianness.  The function open_output() in ld/ldlang.c uses this field
7470to find an alternative output format that is suitable.
7471       /* Opposite endian version of this target.  */
7472       const struct bfd_target *alternative_target;
7473
7474       /* Data for use by back-end routines, which isn't
7475          generic enough to belong in this structure.  */
7476       const void *backend_data;
7477
7478     } bfd_target;
7479
7480
74812.12.1.1 'bfd_set_default_target'
7482.................................
7483
7484*Synopsis*
7485     bfd_boolean bfd_set_default_target (const char *name);
7486   *Description*
7487Set the default target vector to use when recognizing a BFD. This takes
7488the name of the target, which may be a BFD target name or a
7489configuration triplet.
7490
74912.12.1.2 'bfd_find_target'
7492..........................
7493
7494*Synopsis*
7495     const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
7496   *Description*
7497Return a pointer to the transfer vector for the object target named
7498TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7499environment variable 'GNUTARGET'; if that is null or not defined, then
7500choose the first entry in the target list.  Passing in the string
7501"default" or setting the environment variable to "default" will cause
7502the first entry in the target list to be returned, and
7503"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7504causes 'bfd_check_format' to loop over all the targets to find the one
7505that matches the file being read.
7506
75072.12.1.3 'bfd_get_target_info'
7508..............................
7509
7510*Synopsis*
7511     const bfd_target *bfd_get_target_info (const char *target_name,
7512         bfd *abfd,
7513         bfd_boolean *is_bigendian,
7514         int *underscoring,
7515         const char **def_target_arch);
7516   *Description*
7517Return a pointer to the transfer vector for the object target named
7518TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7519environment variable 'GNUTARGET'; if that is null or not defined, then
7520choose the first entry in the target list.  Passing in the string
7521"default" or setting the environment variable to "default" will cause
7522the first entry in the target list to be returned, and
7523"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7524causes 'bfd_check_format' to loop over all the targets to find the one
7525that matches the file being read.  If IS_BIGENDIAN is not 'NULL', then
7526set this value to target's endian mode.  True for big-endian, FALSE for
7527little-endian or for invalid target.  If UNDERSCORING is not 'NULL',
7528then set this value to target's underscoring mode.  Zero for
7529none-underscoring, -1 for invalid target, else the value of target
7530vector's symbol underscoring.  If DEF_TARGET_ARCH is not 'NULL', then
7531set it to the architecture string specified by the target_name.
7532
75332.12.1.4 'bfd_target_list'
7534..........................
7535
7536*Synopsis*
7537     const char ** bfd_target_list (void);
7538   *Description*
7539Return a freshly malloced NULL-terminated vector of the names of all the
7540valid BFD targets.  Do not modify the names.
7541
75422.12.1.5 'bfd_iterate_over_targets'
7543...................................
7544
7545*Synopsis*
7546     const bfd_target *bfd_iterate_over_targets
7547        (int (*func) (const bfd_target *, void *),
7548         void *data);
7549   *Description*
7550Call FUNC for each target in the list of BFD target vectors, passing
7551DATA to FUNC.  Stop iterating if FUNC returns a non-zero result, and
7552return that target vector.  Return NULL if FUNC always returns zero.
7553
75542.12.1.6 'bfd_flavour_name'
7555...........................
7556
7557*Synopsis*
7558     const char *bfd_flavour_name (enum bfd_flavour flavour);
7559   *Description*
7560Return the string form of FLAVOUR.
7561
7562
7563File: bfd.info,  Node: Architectures,  Next: Opening and Closing,  Prev: Targets,  Up: BFD front end
7564
75652.13 Architectures
7566==================
7567
7568BFD keeps one atom in a BFD describing the architecture of the data
7569attached to the BFD: a pointer to a 'bfd_arch_info_type'.
7570
7571   Pointers to structures can be requested independently of a BFD so
7572that an architecture's information can be interrogated without access to
7573an open BFD.
7574
7575   The architecture information is provided by each architecture
7576package.  The set of default architectures is selected by the macro
7577'SELECT_ARCHITECTURES'.  This is normally set up in the
7578'config/TARGET.mt' file of your choice.  If the name is not defined,
7579then all the architectures supported are included.
7580
7581   When BFD starts up, all the architectures are called with an
7582initialize method.  It is up to the architecture back end to insert as
7583many items into the list of architectures as it wants to; generally this
7584would be one for each machine and one for the default case (an item with
7585a machine field of 0).
7586
7587   BFD's idea of an architecture is implemented in 'archures.c'.
7588
75892.13.1 bfd_architecture
7590-----------------------
7591
7592*Description*
7593This enum gives the object file's CPU architecture, in a global
7594sense--i.e., what processor family does it belong to?  Another field
7595indicates which processor within the family is in use.  The machine
7596gives a number which distinguishes different versions of the
7597architecture, containing, for example, 2 and 3 for Intel i960 KA and
7598i960 KB, and 68020 and 68030 for Motorola 68020 and 68030.
7599     enum bfd_architecture
7600     {
7601       bfd_arch_unknown,   /* File arch not known.  */
7602       bfd_arch_obscure,   /* Arch known, not one of these.  */
7603       bfd_arch_m68k,      /* Motorola 68xxx.  */
7604     #define bfd_mach_m68000                1
7605     #define bfd_mach_m68008                2
7606     #define bfd_mach_m68010                3
7607     #define bfd_mach_m68020                4
7608     #define bfd_mach_m68030                5
7609     #define bfd_mach_m68040                6
7610     #define bfd_mach_m68060                7
7611     #define bfd_mach_cpu32                 8
7612     #define bfd_mach_fido                  9
7613     #define bfd_mach_mcf_isa_a_nodiv       10
7614     #define bfd_mach_mcf_isa_a             11
7615     #define bfd_mach_mcf_isa_a_mac         12
7616     #define bfd_mach_mcf_isa_a_emac        13
7617     #define bfd_mach_mcf_isa_aplus         14
7618     #define bfd_mach_mcf_isa_aplus_mac     15
7619     #define bfd_mach_mcf_isa_aplus_emac    16
7620     #define bfd_mach_mcf_isa_b_nousp       17
7621     #define bfd_mach_mcf_isa_b_nousp_mac   18
7622     #define bfd_mach_mcf_isa_b_nousp_emac  19
7623     #define bfd_mach_mcf_isa_b             20
7624     #define bfd_mach_mcf_isa_b_mac         21
7625     #define bfd_mach_mcf_isa_b_emac        22
7626     #define bfd_mach_mcf_isa_b_float       23
7627     #define bfd_mach_mcf_isa_b_float_mac   24
7628     #define bfd_mach_mcf_isa_b_float_emac  25
7629     #define bfd_mach_mcf_isa_c             26
7630     #define bfd_mach_mcf_isa_c_mac         27
7631     #define bfd_mach_mcf_isa_c_emac        28
7632     #define bfd_mach_mcf_isa_c_nodiv       29
7633     #define bfd_mach_mcf_isa_c_nodiv_mac   30
7634     #define bfd_mach_mcf_isa_c_nodiv_emac  31
7635       bfd_arch_vax,       /* DEC Vax.  */
7636       bfd_arch_i960,      /* Intel 960.  */
7637         /* The order of the following is important.
7638            lower number indicates a machine type that
7639            only accepts a subset of the instructions
7640            available to machines with higher numbers.
7641            The exception is the "ca", which is
7642            incompatible with all other machines except
7643            "core".  */
7644
7645     #define bfd_mach_i960_core     1
7646     #define bfd_mach_i960_ka_sa    2
7647     #define bfd_mach_i960_kb_sb    3
7648     #define bfd_mach_i960_mc       4
7649     #define bfd_mach_i960_xa       5
7650     #define bfd_mach_i960_ca       6
7651     #define bfd_mach_i960_jx       7
7652     #define bfd_mach_i960_hx       8
7653
7654       bfd_arch_or1k,      /* OpenRISC 1000.  */
7655     #define bfd_mach_or1k          1
7656     #define bfd_mach_or1knd        2
7657
7658       bfd_arch_sparc,     /* SPARC.  */
7659     #define bfd_mach_sparc                 1
7660     /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
7661     #define bfd_mach_sparc_sparclet        2
7662     #define bfd_mach_sparc_sparclite       3
7663     #define bfd_mach_sparc_v8plus          4
7664     #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
7665     #define bfd_mach_sparc_sparclite_le    6
7666     #define bfd_mach_sparc_v9              7
7667     #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
7668     #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
7669     #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
7670     #define bfd_mach_sparc_v8plusc         11 /* with UA2005 and T1 add'ns.  */
7671     #define bfd_mach_sparc_v9c             12 /* with UA2005 and T1 add'ns.  */
7672     #define bfd_mach_sparc_v8plusd         13 /* with UA2007 and T3 add'ns.  */
7673     #define bfd_mach_sparc_v9d             14 /* with UA2007 and T3 add'ns.  */
7674     #define bfd_mach_sparc_v8pluse         15 /* with OSA2001 and T4 add'ns (no IMA).  */
7675     #define bfd_mach_sparc_v9e             16 /* with OSA2001 and T4 add'ns (no IMA).  */
7676     #define bfd_mach_sparc_v8plusv         17 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7677     #define bfd_mach_sparc_v9v             18 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7678     #define bfd_mach_sparc_v8plusm         19 /* with OSA2015 and M7 add'ns.  */
7679     #define bfd_mach_sparc_v9m             20 /* with OSA2015 and M7 add'ns.  */
7680     #define bfd_mach_sparc_v8plusm8        21 /* with OSA2017 and M8 add'ns.  */
7681     #define bfd_mach_sparc_v9m8            22 /* with OSA2017 and M8 add'ns.  */
7682     /* Nonzero if MACH has the v9 instruction set.  */
7683     #define bfd_mach_sparc_v9_p(mach) \
7684       ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9m8 \
7685        && (mach) != bfd_mach_sparc_sparclite_le)
7686     /* Nonzero if MACH is a 64 bit sparc architecture.  */
7687     #define bfd_mach_sparc_64bit_p(mach) \
7688       ((mach) >= bfd_mach_sparc_v9 \
7689        && (mach) != bfd_mach_sparc_v8plusb \
7690        && (mach) != bfd_mach_sparc_v8plusc \
7691        && (mach) != bfd_mach_sparc_v8plusd \
7692        && (mach) != bfd_mach_sparc_v8pluse \
7693        && (mach) != bfd_mach_sparc_v8plusv \
7694        && (mach) != bfd_mach_sparc_v8plusm \
7695        && (mach) != bfd_mach_sparc_v8plusm8)
7696       bfd_arch_spu,       /* PowerPC SPU.  */
7697     #define bfd_mach_spu           256
7698       bfd_arch_mips,      /* MIPS Rxxxx.  */
7699     #define bfd_mach_mips3000              3000
7700     #define bfd_mach_mips3900              3900
7701     #define bfd_mach_mips4000              4000
7702     #define bfd_mach_mips4010              4010
7703     #define bfd_mach_mips4100              4100
7704     #define bfd_mach_mips4111              4111
7705     #define bfd_mach_mips4120              4120
7706     #define bfd_mach_mips4300              4300
7707     #define bfd_mach_mips4400              4400
7708     #define bfd_mach_mips4600              4600
7709     #define bfd_mach_mips4650              4650
7710     #define bfd_mach_mips5000              5000
7711     #define bfd_mach_mips5400              5400
7712     #define bfd_mach_mips5500              5500
7713     #define bfd_mach_mips5900              5900
7714     #define bfd_mach_mips6000              6000
7715     #define bfd_mach_mips7000              7000
7716     #define bfd_mach_mips8000              8000
7717     #define bfd_mach_mips9000              9000
7718     #define bfd_mach_mips10000             10000
7719     #define bfd_mach_mips12000             12000
7720     #define bfd_mach_mips14000             14000
7721     #define bfd_mach_mips16000             16000
7722     #define bfd_mach_mips16                16
7723     #define bfd_mach_mips5                 5
7724     #define bfd_mach_mips_loongson_2e      3001
7725     #define bfd_mach_mips_loongson_2f      3002
7726     #define bfd_mach_mips_loongson_3a      3003
7727     #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01.  */
7728     #define bfd_mach_mips_octeon           6501
7729     #define bfd_mach_mips_octeonp          6601
7730     #define bfd_mach_mips_octeon2          6502
7731     #define bfd_mach_mips_octeon3          6503
7732     #define bfd_mach_mips_xlr              887682   /* decimal 'XLR'.  */
7733     #define bfd_mach_mips_interaptiv_mr2   736550   /* decimal 'IA2'.  */
7734     #define bfd_mach_mipsisa32             32
7735     #define bfd_mach_mipsisa32r2           33
7736     #define bfd_mach_mipsisa32r3           34
7737     #define bfd_mach_mipsisa32r5           36
7738     #define bfd_mach_mipsisa32r6           37
7739     #define bfd_mach_mipsisa64             64
7740     #define bfd_mach_mipsisa64r2           65
7741     #define bfd_mach_mipsisa64r3           66
7742     #define bfd_mach_mipsisa64r5           68
7743     #define bfd_mach_mipsisa64r6           69
7744     #define bfd_mach_mips_micromips        96
7745       bfd_arch_i386,      /* Intel 386.  */
7746     #define bfd_mach_i386_intel_syntax     (1 << 0)
7747     #define bfd_mach_i386_i8086            (1 << 1)
7748     #define bfd_mach_i386_i386             (1 << 2)
7749     #define bfd_mach_x86_64                (1 << 3)
7750     #define bfd_mach_x64_32                (1 << 4)
7751     #define bfd_mach_i386_i386_intel_syntax (bfd_mach_i386_i386 | bfd_mach_i386_intel_syntax)
7752     #define bfd_mach_x86_64_intel_syntax   (bfd_mach_x86_64 | bfd_mach_i386_intel_syntax)
7753     #define bfd_mach_x64_32_intel_syntax   (bfd_mach_x64_32 | bfd_mach_i386_intel_syntax)
7754       bfd_arch_l1om,      /* Intel L1OM.  */
7755     #define bfd_mach_l1om                  (1 << 5)
7756     #define bfd_mach_l1om_intel_syntax     (bfd_mach_l1om | bfd_mach_i386_intel_syntax)
7757       bfd_arch_k1om,      /* Intel K1OM.  */
7758     #define bfd_mach_k1om                  (1 << 6)
7759     #define bfd_mach_k1om_intel_syntax     (bfd_mach_k1om | bfd_mach_i386_intel_syntax)
7760     #define bfd_mach_i386_nacl             (1 << 7)
7761     #define bfd_mach_i386_i386_nacl        (bfd_mach_i386_i386 | bfd_mach_i386_nacl)
7762     #define bfd_mach_x86_64_nacl           (bfd_mach_x86_64 | bfd_mach_i386_nacl)
7763     #define bfd_mach_x64_32_nacl           (bfd_mach_x64_32 | bfd_mach_i386_nacl)
7764       bfd_arch_iamcu,     /* Intel MCU.  */
7765     #define bfd_mach_iamcu                 (1 << 8)
7766     #define bfd_mach_i386_iamcu            (bfd_mach_i386_i386 | bfd_mach_iamcu)
7767     #define bfd_mach_i386_iamcu_intel_syntax (bfd_mach_i386_iamcu | bfd_mach_i386_intel_syntax)
7768       bfd_arch_we32k,     /* AT&T WE32xxx.  */
7769       bfd_arch_tahoe,     /* CCI/Harris Tahoe.  */
7770       bfd_arch_i860,      /* Intel 860.  */
7771       bfd_arch_i370,      /* IBM 360/370 Mainframes.  */
7772       bfd_arch_romp,      /* IBM ROMP PC/RT.  */
7773       bfd_arch_convex,    /* Convex.  */
7774       bfd_arch_m88k,      /* Motorola 88xxx.  */
7775       bfd_arch_m98k,      /* Motorola 98xxx.  */
7776       bfd_arch_pyramid,   /* Pyramid Technology.  */
7777       bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300).  */
7778     #define bfd_mach_h8300         1
7779     #define bfd_mach_h8300h        2
7780     #define bfd_mach_h8300s        3
7781     #define bfd_mach_h8300hn       4
7782     #define bfd_mach_h8300sn       5
7783     #define bfd_mach_h8300sx       6
7784     #define bfd_mach_h8300sxn      7
7785       bfd_arch_pdp11,     /* DEC PDP-11.  */
7786       bfd_arch_plugin,
7787       bfd_arch_powerpc,   /* PowerPC.  */
7788     #define bfd_mach_ppc           32
7789     #define bfd_mach_ppc64         64
7790     #define bfd_mach_ppc_403       403
7791     #define bfd_mach_ppc_403gc     4030
7792     #define bfd_mach_ppc_405       405
7793     #define bfd_mach_ppc_505       505
7794     #define bfd_mach_ppc_601       601
7795     #define bfd_mach_ppc_602       602
7796     #define bfd_mach_ppc_603       603
7797     #define bfd_mach_ppc_ec603e    6031
7798     #define bfd_mach_ppc_604       604
7799     #define bfd_mach_ppc_620       620
7800     #define bfd_mach_ppc_630       630
7801     #define bfd_mach_ppc_750       750
7802     #define bfd_mach_ppc_860       860
7803     #define bfd_mach_ppc_a35       35
7804     #define bfd_mach_ppc_rs64ii    642
7805     #define bfd_mach_ppc_rs64iii   643
7806     #define bfd_mach_ppc_7400      7400
7807     #define bfd_mach_ppc_e500      500
7808     #define bfd_mach_ppc_e500mc    5001
7809     #define bfd_mach_ppc_e500mc64  5005
7810     #define bfd_mach_ppc_e5500     5006
7811     #define bfd_mach_ppc_e6500     5007
7812     #define bfd_mach_ppc_titan     83
7813     #define bfd_mach_ppc_vle       84
7814       bfd_arch_rs6000,    /* IBM RS/6000.  */
7815     #define bfd_mach_rs6k          6000
7816     #define bfd_mach_rs6k_rs1      6001
7817     #define bfd_mach_rs6k_rsc      6003
7818     #define bfd_mach_rs6k_rs2      6002
7819       bfd_arch_hppa,      /* HP PA RISC.  */
7820     #define bfd_mach_hppa10        10
7821     #define bfd_mach_hppa11        11
7822     #define bfd_mach_hppa20        20
7823     #define bfd_mach_hppa20w       25
7824       bfd_arch_d10v,      /* Mitsubishi D10V.  */
7825     #define bfd_mach_d10v          1
7826     #define bfd_mach_d10v_ts2      2
7827     #define bfd_mach_d10v_ts3      3
7828       bfd_arch_d30v,      /* Mitsubishi D30V.  */
7829       bfd_arch_dlx,       /* DLX.  */
7830       bfd_arch_m68hc11,   /* Motorola 68HC11.  */
7831       bfd_arch_m68hc12,   /* Motorola 68HC12.  */
7832     #define bfd_mach_m6812_default 0
7833     #define bfd_mach_m6812         1
7834     #define bfd_mach_m6812s        2
7835       bfd_arch_m9s12x,    /* Freescale S12X.  */
7836       bfd_arch_m9s12xg,   /* Freescale XGATE.  */
7837       bfd_arch_z8k,       /* Zilog Z8000.  */
7838     #define bfd_mach_z8001         1
7839     #define bfd_mach_z8002         2
7840       bfd_arch_h8500,     /* Renesas H8/500 (formerly Hitachi H8/500).  */
7841       bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH).  */
7842     #define bfd_mach_sh                            1
7843     #define bfd_mach_sh2                           0x20
7844     #define bfd_mach_sh_dsp                        0x2d
7845     #define bfd_mach_sh2a                          0x2a
7846     #define bfd_mach_sh2a_nofpu                    0x2b
7847     #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
7848     #define bfd_mach_sh2a_nofpu_or_sh3_nommu       0x2a2
7849     #define bfd_mach_sh2a_or_sh4                   0x2a3
7850     #define bfd_mach_sh2a_or_sh3e                  0x2a4
7851     #define bfd_mach_sh2e                          0x2e
7852     #define bfd_mach_sh3                           0x30
7853     #define bfd_mach_sh3_nommu                     0x31
7854     #define bfd_mach_sh3_dsp                       0x3d
7855     #define bfd_mach_sh3e                          0x3e
7856     #define bfd_mach_sh4                           0x40
7857     #define bfd_mach_sh4_nofpu                     0x41
7858     #define bfd_mach_sh4_nommu_nofpu               0x42
7859     #define bfd_mach_sh4a                          0x4a
7860     #define bfd_mach_sh4a_nofpu                    0x4b
7861     #define bfd_mach_sh4al_dsp                     0x4d
7862     #define bfd_mach_sh5                           0x50
7863       bfd_arch_alpha,     /* Dec Alpha.  */
7864     #define bfd_mach_alpha_ev4     0x10
7865     #define bfd_mach_alpha_ev5     0x20
7866     #define bfd_mach_alpha_ev6     0x30
7867       bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
7868     #define bfd_mach_arm_unknown   0
7869     #define bfd_mach_arm_2         1
7870     #define bfd_mach_arm_2a        2
7871     #define bfd_mach_arm_3         3
7872     #define bfd_mach_arm_3M        4
7873     #define bfd_mach_arm_4         5
7874     #define bfd_mach_arm_4T        6
7875     #define bfd_mach_arm_5         7
7876     #define bfd_mach_arm_5T        8
7877     #define bfd_mach_arm_5TE       9
7878     #define bfd_mach_arm_XScale    10
7879     #define bfd_mach_arm_ep9312    11
7880     #define bfd_mach_arm_iWMMXt    12
7881     #define bfd_mach_arm_iWMMXt2   13
7882       bfd_arch_nds32,     /* Andes NDS32.  */
7883     #define bfd_mach_n1            1
7884     #define bfd_mach_n1h           2
7885     #define bfd_mach_n1h_v2        3
7886     #define bfd_mach_n1h_v3        4
7887     #define bfd_mach_n1h_v3m       5
7888       bfd_arch_ns32k,     /* National Semiconductors ns32000.  */
7889       bfd_arch_w65,       /* WDC 65816.  */
7890       bfd_arch_tic30,     /* Texas Instruments TMS320C30.  */
7891       bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X.  */
7892     #define bfd_mach_tic3x         30
7893     #define bfd_mach_tic4x         40
7894       bfd_arch_tic54x,    /* Texas Instruments TMS320C54X.  */
7895       bfd_arch_tic6x,     /* Texas Instruments TMS320C6X.  */
7896       bfd_arch_tic80,     /* TI TMS320c80 (MVP).  */
7897       bfd_arch_v850,      /* NEC V850.  */
7898       bfd_arch_v850_rh850,/* NEC V850 (using RH850 ABI).  */
7899     #define bfd_mach_v850          1
7900     #define bfd_mach_v850e         'E'
7901     #define bfd_mach_v850e1        '1'
7902     #define bfd_mach_v850e2        0x4532
7903     #define bfd_mach_v850e2v3      0x45325633
7904     #define bfd_mach_v850e3v5      0x45335635 /* ('E'|'3'|'V'|'5').  */
7905       bfd_arch_arc,       /* ARC Cores.  */
7906     #define bfd_mach_arc_a4        0
7907     #define bfd_mach_arc_a5        1
7908     #define bfd_mach_arc_arc600    2
7909     #define bfd_mach_arc_arc601    4
7910     #define bfd_mach_arc_arc700    3
7911     #define bfd_mach_arc_arcv2     5
7912      bfd_arch_m32c,       /* Renesas M16C/M32C.  */
7913     #define bfd_mach_m16c          0x75
7914     #define bfd_mach_m32c          0x78
7915       bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D).  */
7916     #define bfd_mach_m32r          1 /* For backwards compatibility.  */
7917     #define bfd_mach_m32rx         'x'
7918     #define bfd_mach_m32r2         '2'
7919       bfd_arch_mn10200,   /* Matsushita MN10200.  */
7920       bfd_arch_mn10300,   /* Matsushita MN10300.  */
7921     #define bfd_mach_mn10300       300
7922     #define bfd_mach_am33          330
7923     #define bfd_mach_am33_2        332
7924       bfd_arch_fr30,
7925     #define bfd_mach_fr30          0x46523330
7926       bfd_arch_frv,
7927     #define bfd_mach_frv           1
7928     #define bfd_mach_frvsimple     2
7929     #define bfd_mach_fr300         300
7930     #define bfd_mach_fr400         400
7931     #define bfd_mach_fr450         450
7932     #define bfd_mach_frvtomcat     499     /* fr500 prototype.  */
7933     #define bfd_mach_fr500         500
7934     #define bfd_mach_fr550         550
7935       bfd_arch_moxie,     /* The moxie processor.  */
7936     #define bfd_mach_moxie         1
7937       bfd_arch_ft32,      /* The ft32 processor.  */
7938     #define bfd_mach_ft32          1
7939     #define bfd_mach_ft32b         2
7940       bfd_arch_mcore,
7941       bfd_arch_mep,
7942     #define bfd_mach_mep           1
7943     #define bfd_mach_mep_h1        0x6831
7944     #define bfd_mach_mep_c5        0x6335
7945       bfd_arch_metag,
7946     #define bfd_mach_metag         1
7947       bfd_arch_ia64,      /* HP/Intel ia64.  */
7948     #define bfd_mach_ia64_elf64    64
7949     #define bfd_mach_ia64_elf32    32
7950       bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
7951     #define bfd_mach_ip2022        1
7952     #define bfd_mach_ip2022ext     2
7953      bfd_arch_iq2000,     /* Vitesse IQ2000.  */
7954     #define bfd_mach_iq2000        1
7955     #define bfd_mach_iq10          2
7956       bfd_arch_epiphany,  /* Adapteva EPIPHANY.  */
7957     #define bfd_mach_epiphany16    1
7958     #define bfd_mach_epiphany32    2
7959       bfd_arch_mt,
7960     #define bfd_mach_ms1           1
7961     #define bfd_mach_mrisc2        2
7962     #define bfd_mach_ms2           3
7963       bfd_arch_pj,
7964       bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
7965     #define bfd_mach_avr1          1
7966     #define bfd_mach_avr2          2
7967     #define bfd_mach_avr25         25
7968     #define bfd_mach_avr3          3
7969     #define bfd_mach_avr31         31
7970     #define bfd_mach_avr35         35
7971     #define bfd_mach_avr4          4
7972     #define bfd_mach_avr5          5
7973     #define bfd_mach_avr51         51
7974     #define bfd_mach_avr6          6
7975     #define bfd_mach_avrtiny       100
7976     #define bfd_mach_avrxmega1     101
7977     #define bfd_mach_avrxmega2     102
7978     #define bfd_mach_avrxmega3     103
7979     #define bfd_mach_avrxmega4     104
7980     #define bfd_mach_avrxmega5     105
7981     #define bfd_mach_avrxmega6     106
7982     #define bfd_mach_avrxmega7     107
7983       bfd_arch_bfin,      /* ADI Blackfin.  */
7984     #define bfd_mach_bfin          1
7985       bfd_arch_cr16,      /* National Semiconductor CompactRISC (ie CR16).  */
7986     #define bfd_mach_cr16          1
7987       bfd_arch_cr16c,     /* National Semiconductor CompactRISC.  */
7988     #define bfd_mach_cr16c         1
7989       bfd_arch_crx,       /*  National Semiconductor CRX.  */
7990     #define bfd_mach_crx           1
7991       bfd_arch_cris,      /* Axis CRIS.  */
7992     #define bfd_mach_cris_v0_v10   255
7993     #define bfd_mach_cris_v32      32
7994     #define bfd_mach_cris_v10_v32  1032
7995       bfd_arch_riscv,
7996     #define bfd_mach_riscv32       132
7997     #define bfd_mach_riscv64       164
7998       bfd_arch_rl78,
7999     #define bfd_mach_rl78          0x75
8000       bfd_arch_rx,        /* Renesas RX.  */
8001     #define bfd_mach_rx            0x75
8002       bfd_arch_s390,      /* IBM s390.  */
8003     #define bfd_mach_s390_31       31
8004     #define bfd_mach_s390_64       64
8005       bfd_arch_score,     /* Sunplus score.  */
8006     #define bfd_mach_score3        3
8007     #define bfd_mach_score7        7
8008       bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
8009       bfd_arch_xstormy16,
8010     #define bfd_mach_xstormy16     1
8011       bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
8012     #define bfd_mach_msp11         11
8013     #define bfd_mach_msp110        110
8014     #define bfd_mach_msp12         12
8015     #define bfd_mach_msp13         13
8016     #define bfd_mach_msp14         14
8017     #define bfd_mach_msp15         15
8018     #define bfd_mach_msp16         16
8019     #define bfd_mach_msp20         20
8020     #define bfd_mach_msp21         21
8021     #define bfd_mach_msp22         22
8022     #define bfd_mach_msp23         23
8023     #define bfd_mach_msp24         24
8024     #define bfd_mach_msp26         26
8025     #define bfd_mach_msp31         31
8026     #define bfd_mach_msp32         32
8027     #define bfd_mach_msp33         33
8028     #define bfd_mach_msp41         41
8029     #define bfd_mach_msp42         42
8030     #define bfd_mach_msp43         43
8031     #define bfd_mach_msp44         44
8032     #define bfd_mach_msp430x       45
8033     #define bfd_mach_msp46         46
8034     #define bfd_mach_msp47         47
8035     #define bfd_mach_msp54         54
8036       bfd_arch_xc16x,     /* Infineon's XC16X Series.  */
8037     #define bfd_mach_xc16x         1
8038     #define bfd_mach_xc16xl        2
8039     #define bfd_mach_xc16xs        3
8040       bfd_arch_xgate,     /* Freescale XGATE.  */
8041     #define bfd_mach_xgate         1
8042       bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
8043     #define bfd_mach_xtensa        1
8044       bfd_arch_z80,
8045     #define bfd_mach_z80strict     1 /* No undocumented opcodes.  */
8046     #define bfd_mach_z80           3 /* With ixl, ixh, iyl, and iyh.  */
8047     #define bfd_mach_z80full       7 /* All undocumented instructions.  */
8048     #define bfd_mach_r800          11 /* R800: successor with multiplication.  */
8049       bfd_arch_lm32,      /* Lattice Mico32.  */
8050     #define bfd_mach_lm32          1
8051       bfd_arch_microblaze,/* Xilinx MicroBlaze.  */
8052       bfd_arch_tilepro,   /* Tilera TILEPro.  */
8053       bfd_arch_tilegx,    /* Tilera TILE-Gx.  */
8054     #define bfd_mach_tilepro       1
8055     #define bfd_mach_tilegx        1
8056     #define bfd_mach_tilegx32      2
8057       bfd_arch_aarch64,   /* AArch64.  */
8058     #define bfd_mach_aarch64 0
8059     #define bfd_mach_aarch64_ilp32 32
8060       bfd_arch_nios2,     /* Nios II.  */
8061     #define bfd_mach_nios2         0
8062     #define bfd_mach_nios2r1       1
8063     #define bfd_mach_nios2r2       2
8064       bfd_arch_visium,    /* Visium.  */
8065     #define bfd_mach_visium        1
8066       bfd_arch_wasm32,    /* WebAssembly.  */
8067     #define bfd_mach_wasm32        1
8068       bfd_arch_pru,       /* PRU.  */
8069     #define bfd_mach_pru           0
8070       bfd_arch_last
8071       };
8072
80732.13.2 bfd_arch_info
8074--------------------
8075
8076*Description*
8077This structure contains information on architectures for use within BFD.
8078
8079     typedef struct bfd_arch_info
8080     {
8081       int bits_per_word;
8082       int bits_per_address;
8083       int bits_per_byte;
8084       enum bfd_architecture arch;
8085       unsigned long mach;
8086       const char *arch_name;
8087       const char *printable_name;
8088       unsigned int section_align_power;
8089       /* TRUE if this is the default machine for the architecture.
8090          The default arch should be the first entry for an arch so that
8091          all the entries for that arch can be accessed via next.  */
8092       bfd_boolean the_default;
8093       const struct bfd_arch_info * (*compatible) (const struct bfd_arch_info *,
8094                                                   const struct bfd_arch_info *);
8095
8096       bfd_boolean (*scan) (const struct bfd_arch_info *, const char *);
8097
8098       /* Allocate via bfd_malloc and return a fill buffer of size COUNT.  If
8099          IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8100          TRUE, the buffer contains code.  */
8101       void *(*fill) (bfd_size_type count, bfd_boolean is_bigendian,
8102                      bfd_boolean code);
8103
8104       const struct bfd_arch_info *next;
8105     }
8106     bfd_arch_info_type;
8107
8108
81092.13.2.1 'bfd_printable_name'
8110.............................
8111
8112*Synopsis*
8113     const char *bfd_printable_name (bfd *abfd);
8114   *Description*
8115Return a printable string representing the architecture and machine from
8116the pointer to the architecture info structure.
8117
81182.13.2.2 'bfd_scan_arch'
8119........................
8120
8121*Synopsis*
8122     const bfd_arch_info_type *bfd_scan_arch (const char *string);
8123   *Description*
8124Figure out if BFD supports any cpu which could be described with the
8125name STRING.  Return a pointer to an 'arch_info' structure if a machine
8126is found, otherwise NULL.
8127
81282.13.2.3 'bfd_arch_list'
8129........................
8130
8131*Synopsis*
8132     const char **bfd_arch_list (void);
8133   *Description*
8134Return a freshly malloced NULL-terminated vector of the names of all the
8135valid BFD architectures.  Do not modify the names.
8136
81372.13.2.4 'bfd_arch_get_compatible'
8138..................................
8139
8140*Synopsis*
8141     const bfd_arch_info_type *bfd_arch_get_compatible
8142        (const bfd *abfd, const bfd *bbfd, bfd_boolean accept_unknowns);
8143   *Description*
8144Determine whether two BFDs' architectures and machine types are
8145compatible.  Calculates the lowest common denominator between the two
8146architectures and machine types implied by the BFDs and returns a
8147pointer to an 'arch_info' structure describing the compatible machine.
8148
81492.13.2.5 'bfd_default_arch_struct'
8150..................................
8151
8152*Description*
8153The 'bfd_default_arch_struct' is an item of 'bfd_arch_info_type' which
8154has been initialized to a fairly generic state.  A BFD starts life by
8155pointing to this structure, until the correct back end has determined
8156the real architecture of the file.
8157     extern const bfd_arch_info_type bfd_default_arch_struct;
8158
81592.13.2.6 'bfd_set_arch_info'
8160............................
8161
8162*Synopsis*
8163     void bfd_set_arch_info (bfd *abfd, const bfd_arch_info_type *arg);
8164   *Description*
8165Set the architecture info of ABFD to ARG.
8166
81672.13.2.7 'bfd_default_set_arch_mach'
8168....................................
8169
8170*Synopsis*
8171     bfd_boolean bfd_default_set_arch_mach
8172        (bfd *abfd, enum bfd_architecture arch, unsigned long mach);
8173   *Description*
8174Set the architecture and machine type in BFD ABFD to ARCH and MACH.
8175Find the correct pointer to a structure and insert it into the
8176'arch_info' pointer.
8177
81782.13.2.8 'bfd_get_arch'
8179.......................
8180
8181*Synopsis*
8182     enum bfd_architecture bfd_get_arch (bfd *abfd);
8183   *Description*
8184Return the enumerated type which describes the BFD ABFD's architecture.
8185
81862.13.2.9 'bfd_get_mach'
8187.......................
8188
8189*Synopsis*
8190     unsigned long bfd_get_mach (bfd *abfd);
8191   *Description*
8192Return the long type which describes the BFD ABFD's machine.
8193
81942.13.2.10 'bfd_arch_bits_per_byte'
8195..................................
8196
8197*Synopsis*
8198     unsigned int bfd_arch_bits_per_byte (bfd *abfd);
8199   *Description*
8200Return the number of bits in one of the BFD ABFD's architecture's bytes.
8201
82022.13.2.11 'bfd_arch_bits_per_address'
8203.....................................
8204
8205*Synopsis*
8206     unsigned int bfd_arch_bits_per_address (bfd *abfd);
8207   *Description*
8208Return the number of bits in one of the BFD ABFD's architecture's
8209addresses.
8210
82112.13.2.12 'bfd_default_compatible'
8212..................................
8213
8214*Synopsis*
8215     const bfd_arch_info_type *bfd_default_compatible
8216        (const bfd_arch_info_type *a, const bfd_arch_info_type *b);
8217   *Description*
8218The default function for testing for compatibility.
8219
82202.13.2.13 'bfd_default_scan'
8221............................
8222
8223*Synopsis*
8224     bfd_boolean bfd_default_scan
8225        (const struct bfd_arch_info *info, const char *string);
8226   *Description*
8227The default function for working out whether this is an architecture hit
8228and a machine hit.
8229
82302.13.2.14 'bfd_get_arch_info'
8231.............................
8232
8233*Synopsis*
8234     const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
8235   *Description*
8236Return the architecture info struct in ABFD.
8237
82382.13.2.15 'bfd_lookup_arch'
8239...........................
8240
8241*Synopsis*
8242     const bfd_arch_info_type *bfd_lookup_arch
8243        (enum bfd_architecture arch, unsigned long machine);
8244   *Description*
8245Look for the architecture info structure which matches the arguments
8246ARCH and MACHINE.  A machine of 0 matches the machine/architecture
8247structure which marks itself as the default.
8248
82492.13.2.16 'bfd_printable_arch_mach'
8250...................................
8251
8252*Synopsis*
8253     const char *bfd_printable_arch_mach
8254        (enum bfd_architecture arch, unsigned long machine);
8255   *Description*
8256Return a printable string representing the architecture and machine
8257type.
8258
8259   This routine is depreciated.
8260
82612.13.2.17 'bfd_octets_per_byte'
8262...............................
8263
8264*Synopsis*
8265     unsigned int bfd_octets_per_byte (bfd *abfd);
8266   *Description*
8267Return the number of octets (8-bit quantities) per target byte (minimum
8268addressable unit).  In most cases, this will be one, but some DSP
8269targets have 16, 32, or even 48 bits per byte.
8270
82712.13.2.18 'bfd_arch_mach_octets_per_byte'
8272.........................................
8273
8274*Synopsis*
8275     unsigned int bfd_arch_mach_octets_per_byte
8276        (enum bfd_architecture arch, unsigned long machine);
8277   *Description*
8278See bfd_octets_per_byte.
8279
8280   This routine is provided for those cases where a bfd * is not
8281available
8282
82832.13.2.19 'bfd_arch_default_fill'
8284.................................
8285
8286*Synopsis*
8287     void *bfd_arch_default_fill (bfd_size_type count,
8288         bfd_boolean is_bigendian,
8289         bfd_boolean code);
8290   *Description*
8291Allocate via bfd_malloc and return a fill buffer of size COUNT. If
8292IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8293TRUE, the buffer contains code.
8294
8295
8296File: bfd.info,  Node: Opening and Closing,  Next: Internal,  Prev: Architectures,  Up: BFD front end
8297
8298     /* Set to N to open the next N BFDs using an alternate id space.  */
8299     extern unsigned int bfd_use_reserved_id;
8300
83012.14 Opening and closing BFDs
8302=============================
8303
83042.14.1 Functions for opening and closing
8305----------------------------------------
8306
83072.14.1.1 'bfd_fopen'
8308....................
8309
8310*Synopsis*
8311     bfd *bfd_fopen (const char *filename, const char *target,
8312         const char *mode, int fd);
8313   *Description*
8314Open the file FILENAME with the target TARGET.  Return a pointer to the
8315created BFD. If FD is not -1, then 'fdopen' is used to open the file;
8316otherwise, 'fopen' is used.  MODE is passed directly to 'fopen' or
8317'fdopen'.
8318
8319   Calls 'bfd_find_target', so TARGET is interpreted as by that
8320function.
8321
8322   The new BFD is marked as cacheable iff FD is -1.
8323
8324   If 'NULL' is returned then an error has occured.  Possible errors are
8325'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8326error.
8327
8328   On error, FD is always closed.
8329
8330   A copy of the FILENAME argument is stored in the newly created BFD.
8331It can be accessed via the bfd_get_filename() macro.
8332
83332.14.1.2 'bfd_openr'
8334....................
8335
8336*Synopsis*
8337     bfd *bfd_openr (const char *filename, const char *target);
8338   *Description*
8339Open the file FILENAME (using 'fopen') with the target TARGET.  Return a
8340pointer to the created BFD.
8341
8342   Calls 'bfd_find_target', so TARGET is interpreted as by that
8343function.
8344
8345   If 'NULL' is returned then an error has occured.  Possible errors are
8346'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8347error.
8348
8349   A copy of the FILENAME argument is stored in the newly created BFD.
8350It can be accessed via the bfd_get_filename() macro.
8351
83522.14.1.3 'bfd_fdopenr'
8353......................
8354
8355*Synopsis*
8356     bfd *bfd_fdopenr (const char *filename, const char *target, int fd);
8357   *Description*
8358'bfd_fdopenr' is to 'bfd_fopenr' much like 'fdopen' is to 'fopen'.  It
8359opens a BFD on a file already described by the FD supplied.
8360
8361   When the file is later 'bfd_close'd, the file descriptor will be
8362closed.  If the caller desires that this file descriptor be cached by
8363BFD (opened as needed, closed as needed to free descriptors for other
8364opens), with the supplied FD used as an initial file descriptor (but
8365subject to closure at any time), call bfd_set_cacheable(bfd, 1) on the
8366returned BFD. The default is to assume no caching; the file descriptor
8367will remain open until 'bfd_close', and will not be affected by BFD
8368operations on other files.
8369
8370   Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8371and 'bfd_error_system_call'.
8372
8373   On error, FD is closed.
8374
8375   A copy of the FILENAME argument is stored in the newly created BFD.
8376It can be accessed via the bfd_get_filename() macro.
8377
83782.14.1.4 'bfd_openstreamr'
8379..........................
8380
8381*Synopsis*
8382     bfd *bfd_openstreamr (const char * filename, const char * target,
8383         void * stream);
8384   *Description*
8385Open a BFD for read access on an existing stdio stream.  When the BFD is
8386passed to 'bfd_close', the stream will be closed.
8387
8388   A copy of the FILENAME argument is stored in the newly created BFD.
8389It can be accessed via the bfd_get_filename() macro.
8390
83912.14.1.5 'bfd_openr_iovec'
8392..........................
8393
8394*Synopsis*
8395     bfd *bfd_openr_iovec (const char *filename, const char *target,
8396         void *(*open_func) (struct bfd *nbfd,
8397         void *open_closure),
8398         void *open_closure,
8399         file_ptr (*pread_func) (struct bfd *nbfd,
8400         void *stream,
8401         void *buf,
8402         file_ptr nbytes,
8403         file_ptr offset),
8404         int (*close_func) (struct bfd *nbfd,
8405         void *stream),
8406         int (*stat_func) (struct bfd *abfd,
8407         void *stream,
8408         struct stat *sb));
8409   *Description*
8410Create and return a BFD backed by a read-only STREAM.  The STREAM is
8411created using OPEN_FUNC, accessed using PREAD_FUNC and destroyed using
8412CLOSE_FUNC.
8413
8414   Calls 'bfd_find_target', so TARGET is interpreted as by that
8415function.
8416
8417   Calls OPEN_FUNC (which can call 'bfd_zalloc' and 'bfd_get_filename')
8418to obtain the read-only stream backing the BFD. OPEN_FUNC either
8419succeeds returning the non-'NULL' STREAM, or fails returning 'NULL'
8420(setting 'bfd_error').
8421
8422   Calls PREAD_FUNC to request NBYTES of data from STREAM starting at
8423OFFSET (e.g., via a call to 'bfd_read').  PREAD_FUNC either succeeds
8424returning the number of bytes read (which can be less than NBYTES when
8425end-of-file), or fails returning -1 (setting 'bfd_error').
8426
8427   Calls CLOSE_FUNC when the BFD is later closed using 'bfd_close'.
8428CLOSE_FUNC either succeeds returning 0, or fails returning -1 (setting
8429'bfd_error').
8430
8431   Calls STAT_FUNC to fill in a stat structure for bfd_stat,
8432bfd_get_size, and bfd_get_mtime calls.  STAT_FUNC returns 0 on success,
8433or returns -1 on failure (setting 'bfd_error').
8434
8435   If 'bfd_openr_iovec' returns 'NULL' then an error has occurred.
8436Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8437and 'bfd_error_system_call'.
8438
8439   A copy of the FILENAME argument is stored in the newly created BFD.
8440It can be accessed via the bfd_get_filename() macro.
8441
84422.14.1.6 'bfd_openw'
8443....................
8444
8445*Synopsis*
8446     bfd *bfd_openw (const char *filename, const char *target);
8447   *Description*
8448Create a BFD, associated with file FILENAME, using the file format
8449TARGET, and return a pointer to it.
8450
8451   Possible errors are 'bfd_error_system_call', 'bfd_error_no_memory',
8452'bfd_error_invalid_target'.
8453
8454   A copy of the FILENAME argument is stored in the newly created BFD.
8455It can be accessed via the bfd_get_filename() macro.
8456
84572.14.1.7 'bfd_close'
8458....................
8459
8460*Synopsis*
8461     bfd_boolean bfd_close (bfd *abfd);
8462   *Description*
8463Close a BFD. If the BFD was open for writing, then pending operations
8464are completed and the file written out and closed.  If the created file
8465is executable, then 'chmod' is called to mark it as such.
8466
8467   All memory attached to the BFD is released.
8468
8469   The file descriptor associated with the BFD is closed (even if it was
8470passed in to BFD by 'bfd_fdopenr').
8471
8472   *Returns*
8473'TRUE' is returned if all is ok, otherwise 'FALSE'.
8474
84752.14.1.8 'bfd_close_all_done'
8476.............................
8477
8478*Synopsis*
8479     bfd_boolean bfd_close_all_done (bfd *);
8480   *Description*
8481Close a BFD. Differs from 'bfd_close' since it does not complete any
8482pending operations.  This routine would be used if the application had
8483just used BFD for swapping and didn't want to use any of the writing
8484code.
8485
8486   If the created file is executable, then 'chmod' is called to mark it
8487as such.
8488
8489   All memory attached to the BFD is released.
8490
8491   *Returns*
8492'TRUE' is returned if all is ok, otherwise 'FALSE'.
8493
84942.14.1.9 'bfd_create'
8495.....................
8496
8497*Synopsis*
8498     bfd *bfd_create (const char *filename, bfd *templ);
8499   *Description*
8500Create a new BFD in the manner of 'bfd_openw', but without opening a
8501file.  The new BFD takes the target from the target used by TEMPL.  The
8502format is always set to 'bfd_object'.
8503
8504   A copy of the FILENAME argument is stored in the newly created BFD.
8505It can be accessed via the bfd_get_filename() macro.
8506
85072.14.1.10 'bfd_make_writable'
8508.............................
8509
8510*Synopsis*
8511     bfd_boolean bfd_make_writable (bfd *abfd);
8512   *Description*
8513Takes a BFD as created by 'bfd_create' and converts it into one like as
8514returned by 'bfd_openw'.  It does this by converting the BFD to
8515BFD_IN_MEMORY. It's assumed that you will call 'bfd_make_readable' on
8516this bfd later.
8517
8518   *Returns*
8519'TRUE' is returned if all is ok, otherwise 'FALSE'.
8520
85212.14.1.11 'bfd_make_readable'
8522.............................
8523
8524*Synopsis*
8525     bfd_boolean bfd_make_readable (bfd *abfd);
8526   *Description*
8527Takes a BFD as created by 'bfd_create' and 'bfd_make_writable' and
8528converts it into one like as returned by 'bfd_openr'.  It does this by
8529writing the contents out to the memory buffer, then reversing the
8530direction.
8531
8532   *Returns*
8533'TRUE' is returned if all is ok, otherwise 'FALSE'.
8534
85352.14.1.12 'bfd_alloc'
8536.....................
8537
8538*Synopsis*
8539     void *bfd_alloc (bfd *abfd, bfd_size_type wanted);
8540   *Description*
8541Allocate a block of WANTED bytes of memory attached to 'abfd' and return
8542a pointer to it.
8543
85442.14.1.13 'bfd_alloc2'
8545......................
8546
8547*Synopsis*
8548     void *bfd_alloc2 (bfd *abfd, bfd_size_type nmemb, bfd_size_type size);
8549   *Description*
8550Allocate a block of NMEMB elements of SIZE bytes each of memory attached
8551to 'abfd' and return a pointer to it.
8552
85532.14.1.14 'bfd_zalloc'
8554......................
8555
8556*Synopsis*
8557     void *bfd_zalloc (bfd *abfd, bfd_size_type wanted);
8558   *Description*
8559Allocate a block of WANTED bytes of zeroed memory attached to 'abfd' and
8560return a pointer to it.
8561
85622.14.1.15 'bfd_zalloc2'
8563.......................
8564
8565*Synopsis*
8566     void *bfd_zalloc2 (bfd *abfd, bfd_size_type nmemb, bfd_size_type size);
8567   *Description*
8568Allocate a block of NMEMB elements of SIZE bytes each of zeroed memory
8569attached to 'abfd' and return a pointer to it.
8570
85712.14.1.16 'bfd_calc_gnu_debuglink_crc32'
8572........................................
8573
8574*Synopsis*
8575     unsigned long bfd_calc_gnu_debuglink_crc32
8576        (unsigned long crc, const unsigned char *buf, bfd_size_type len);
8577   *Description*
8578Computes a CRC value as used in the .gnu_debuglink section.  Advances
8579the previously computed CRC value by computing and adding in the crc32
8580for LEN bytes of BUF.
8581
8582   *Returns*
8583Return the updated CRC32 value.
8584
85852.14.1.17 'bfd_get_debug_link_info_1'
8586.....................................
8587
8588*Synopsis*
8589     char *bfd_get_debug_link_info_1 (bfd *abfd, void *crc32_out);
8590   *Description*
8591Extracts the filename and CRC32 value for any separate debug information
8592file associated with ABFD.
8593
8594   The CRC32_OUT parameter is an untyped pointer because this routine is
8595used as a 'get_func_type' function, but it is expected to be an unsigned
8596long pointer.
8597
8598   *Returns*
8599The filename of the associated debug information file, or NULL if there
8600is no such file.  If the filename was found then the contents of
8601CRC32_OUT are updated to hold the corresponding CRC32 value for the
8602file.
8603
8604   The returned filename is allocated with 'malloc'; freeing it is the
8605responsibility of the caller.
8606
86072.14.1.18 'bfd_get_debug_link_info'
8608...................................
8609
8610*Synopsis*
8611     char *bfd_get_debug_link_info (bfd *abfd, unsigned long *crc32_out);
8612   *Description*
8613Extracts the filename and CRC32 value for any separate debug information
8614file associated with ABFD.
8615
8616   *Returns*
8617The filename of the associated debug information file, or NULL if there
8618is no such file.  If the filename was found then the contents of
8619CRC32_OUT are updated to hold the corresponding CRC32 value for the
8620file.
8621
8622   The returned filename is allocated with 'malloc'; freeing it is the
8623responsibility of the caller.
8624
86252.14.1.19 'bfd_get_alt_debug_link_info'
8626.......................................
8627
8628*Synopsis*
8629     char *bfd_get_alt_debug_link_info (bfd * abfd,
8630         bfd_size_type *buildid_len,
8631         bfd_byte **buildid_out);
8632   *Description*
8633Fetch the filename and BuildID value for any alternate debuginfo
8634associated with ABFD.  Return NULL if no such info found, otherwise
8635return filename and update BUILDID_LEN and BUILDID_OUT.  The returned
8636filename and build_id are allocated with 'malloc'; freeing them is the
8637responsibility of the caller.
8638
86392.14.1.20 'separate_debug_file_exists'
8640......................................
8641
8642*Synopsis*
8643     bfd_boolean separate_debug_file_exists
8644        (char *name, void *crc32_p);
8645   *Description*
8646Checks to see if NAME is a file and if its contents match CRC32, which
8647is a pointer to an 'unsigned long' containing a CRC32.
8648
8649   The CRC32_P parameter is an untyped pointer because this routine is
8650used as a 'check_func_type' function.
8651
86522.14.1.21 'separate_alt_debug_file_exists'
8653..........................................
8654
8655*Synopsis*
8656     bfd_boolean separate_alt_debug_file_exists
8657        (char *name, void *unused);
8658   *Description*
8659Checks to see if NAME is a file.
8660
86612.14.1.22 'find_separate_debug_file'
8662....................................
8663
8664*Synopsis*
8665     char *find_separate_debug_file
8666        (bfd *abfd, const char *dir, bfd_boolean include_dirs,
8667         get_func_type get, check_func_type check, void *data);
8668   *Description*
8669Searches for a debug information file corresponding to ABFD.
8670
8671   The name of the separate debug info file is returned by the GET
8672function.  This function scans various fixed locations in the
8673filesystem, including the file tree rooted at DIR.  If the INCLUDE_DIRS
8674parameter is true then the directory components of ABFD's filename will
8675be included in the searched locations.
8676
8677   DATA is passed unmodified to the GET and CHECK functions.  It is
8678generally used to implement build-id-like matching in the callback
8679functions.
8680
8681   *Returns*
8682Returns the filename of the first file to be found which receives a TRUE
8683result from the CHECK function.  Returns NULL if no valid file could be
8684found.
8685
86862.14.1.23 'bfd_follow_gnu_debuglink'
8687....................................
8688
8689*Synopsis*
8690     char *bfd_follow_gnu_debuglink (bfd *abfd, const char *dir);
8691   *Description*
8692Takes a BFD and searches it for a .gnu_debuglink section.  If this
8693section is found, it examines the section for the name and checksum of a
8694'.debug' file containing auxiliary debugging information.  It then
8695searches the filesystem for this .debug file in some standard locations,
8696including the directory tree rooted at DIR, and if found returns the
8697full filename.
8698
8699   If DIR is NULL, the search will take place starting at the current
8700directory.
8701
8702   *Returns*
8703'NULL' on any errors or failure to locate the .debug file, otherwise a
8704pointer to a heap-allocated string containing the filename.  The caller
8705is responsible for freeing this string.
8706
87072.14.1.24 'bfd_follow_gnu_debugaltlink'
8708.......................................
8709
8710*Synopsis*
8711     char *bfd_follow_gnu_debugaltlink (bfd *abfd, const char *dir);
8712   *Description*
8713Takes a BFD and searches it for a .gnu_debugaltlink section.  If this
8714section is found, it examines the section for the name of a file
8715containing auxiliary debugging information.  It then searches the
8716filesystem for this file in a set of standard locations, including the
8717directory tree rooted at DIR, and if found returns the full filename.
8718
8719   If DIR is NULL, the search will take place starting at the current
8720directory.
8721
8722   *Returns*
8723'NULL' on any errors or failure to locate the debug file, otherwise a
8724pointer to a heap-allocated string containing the filename.  The caller
8725is responsible for freeing this string.
8726
87272.14.1.25 'bfd_create_gnu_debuglink_section'
8728............................................
8729
8730*Synopsis*
8731     struct bfd_section *bfd_create_gnu_debuglink_section
8732        (bfd *abfd, const char *filename);
8733   *Description*
8734Takes a BFD and adds a .gnu_debuglink section to it.  The section is
8735sized to be big enough to contain a link to the specified FILENAME.
8736
8737   *Returns*
8738A pointer to the new section is returned if all is ok.  Otherwise 'NULL'
8739is returned and bfd_error is set.
8740
87412.14.1.26 'bfd_fill_in_gnu_debuglink_section'
8742.............................................
8743
8744*Synopsis*
8745     bfd_boolean bfd_fill_in_gnu_debuglink_section
8746        (bfd *abfd, struct bfd_section *sect, const char *filename);
8747   *Description*
8748Takes a BFD and containing a .gnu_debuglink section SECT and fills in
8749the contents of the section to contain a link to the specified FILENAME.
8750The filename should be relative to the current directory.
8751
8752   *Returns*
8753'TRUE' is returned if all is ok.  Otherwise 'FALSE' is returned and
8754bfd_error is set.
8755
87562.14.1.27 'get_build_id'
8757........................
8758
8759*Synopsis*
8760     struct bfd_build_id * get_build_id (bfd *abfd);
8761   *Description*
8762Finds the build-id associated with ABFD.  If the build-id is extracted
8763from the note section then a build-id structure is built for it, using
8764memory allocated to ABFD, and this is then attached to the ABFD.
8765
8766   *Returns*
8767Returns a pointer to the build-id structure if a build-id could be
8768found.  If no build-id is found NULL is returned and error code is set.
8769
87702.14.1.28 'get_build_id_name'
8771.............................
8772
8773*Synopsis*
8774     char * get_build_id_name (bfd *abfd, void *build_id_out_p)
8775   *Description*
8776Searches ABFD for a build-id, and then constructs a pathname from it.
8777The path is computed as .build-id/NN/NN+NN.debug where NNNN+NN is the
8778build-id value as a hexadecimal string.
8779
8780   *Returns*
8781Returns the constructed filename or NULL upon error.  It is the caller's
8782responsibility to free the memory used to hold the filename.  If a
8783filename is returned then the BUILD_ID_OUT_P parameter (which points to
8784a 'struct bfd_build_id' pointer) is set to a pointer to the build_id
8785structure.
8786
87872.14.1.29 'check_build_id_file'
8788...............................
8789
8790*Synopsis*
8791     bfd_boolean check_build_id_file (char *name, void *buildid_p);
8792   *Description*
8793Checks to see if NAME is a readable file and if its build-id matches
8794BUILDID.
8795
8796   *Returns*
8797Returns TRUE if the file exists, is readable, and contains a build-id
8798which matches the build-id pointed at by BUILD_ID_P (which is really a
8799'struct bfd_build_id **').
8800
88012.14.1.30 'bfd_follow_build_id_debuglink'
8802.........................................
8803
8804*Synopsis*
8805     char *bfd_follow_build_id_debuglink (bfd *abfd, const char *dir);
8806   *Description*
8807Takes ABFD and searches it for a .note.gnu.build-id section.  If this
8808section is found, it extracts the value of the NT_GNU_BUILD_ID note,
8809which should be a hexadecimal value NNNN+NN (for 32+ hex digits).  It
8810then searches the filesystem for a file named .BUILD-ID/NN/NN+NN.DEBUG
8811in a set of standard locations, including the directory tree rooted at
8812DIR.  The filename of the first matching file to be found is returned.
8813A matching file should contain a .note.gnu.build-id section with the
8814same NNNN+NN note as ABFD, although this check is currently not
8815implemented.
8816
8817   If DIR is NULL, the search will take place starting at the current
8818directory.
8819
8820   *Returns*
8821'NULL' on any errors or failure to locate the debug file, otherwise a
8822pointer to a heap-allocated string containing the filename.  The caller
8823is responsible for freeing this string.
8824
8825
8826File: bfd.info,  Node: Internal,  Next: File Caching,  Prev: Opening and Closing,  Up: BFD front end
8827
88282.15 Implementation details
8829===========================
8830
88312.15.1 Internal functions
8832-------------------------
8833
8834*Description*
8835These routines are used within BFD. They are not intended for export,
8836but are documented here for completeness.
8837
88382.15.1.1 'bfd_write_bigendian_4byte_int'
8839........................................
8840
8841*Synopsis*
8842     bfd_boolean bfd_write_bigendian_4byte_int (bfd *, unsigned int);
8843   *Description*
8844Write a 4 byte integer I to the output BFD ABFD, in big endian order
8845regardless of what else is going on.  This is useful in archives.
8846
88472.15.1.2 'bfd_put_size'
8848.......................
8849
88502.15.1.3 'bfd_get_size'
8851.......................
8852
8853*Description*
8854These macros as used for reading and writing raw data in sections; each
8855access (except for bytes) is vectored through the target format of the
8856BFD and mangled accordingly.  The mangling performs any necessary endian
8857translations and removes alignment restrictions.  Note that types
8858accepted and returned by these macros are identical so they can be
8859swapped around in macros--for example, 'libaout.h' defines 'GET_WORD' to
8860either 'bfd_get_32' or 'bfd_get_64'.
8861
8862   In the put routines, VAL must be a 'bfd_vma'.  If we are on a system
8863without prototypes, the caller is responsible for making sure that is
8864true, with a cast if necessary.  We don't cast them in the macro
8865definitions because that would prevent 'lint' or 'gcc -Wall' from
8866detecting sins such as passing a pointer.  To detect calling these with
8867less than a 'bfd_vma', use 'gcc -Wconversion' on a host with 64 bit
8868'bfd_vma''s.
8869
8870     /* Byte swapping macros for user section data.  */
8871
8872     #define bfd_put_8(abfd, val, ptr) \
8873       ((void) (*((unsigned char *) (ptr)) = (val) & 0xff))
8874     #define bfd_put_signed_8 \
8875       bfd_put_8
8876     #define bfd_get_8(abfd, ptr) \
8877       (*(const unsigned char *) (ptr) & 0xff)
8878     #define bfd_get_signed_8(abfd, ptr) \
8879       (((*(const unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
8880
8881     #define bfd_put_16(abfd, val, ptr) \
8882       BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
8883     #define bfd_put_signed_16 \
8884       bfd_put_16
8885     #define bfd_get_16(abfd, ptr) \
8886       BFD_SEND (abfd, bfd_getx16, (ptr))
8887     #define bfd_get_signed_16(abfd, ptr) \
8888       BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
8889
8890     #define bfd_put_32(abfd, val, ptr) \
8891       BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
8892     #define bfd_put_signed_32 \
8893       bfd_put_32
8894     #define bfd_get_32(abfd, ptr) \
8895       BFD_SEND (abfd, bfd_getx32, (ptr))
8896     #define bfd_get_signed_32(abfd, ptr) \
8897       BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
8898
8899     #define bfd_put_64(abfd, val, ptr) \
8900       BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
8901     #define bfd_put_signed_64 \
8902       bfd_put_64
8903     #define bfd_get_64(abfd, ptr) \
8904       BFD_SEND (abfd, bfd_getx64, (ptr))
8905     #define bfd_get_signed_64(abfd, ptr) \
8906       BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
8907
8908     #define bfd_get(bits, abfd, ptr)                       \
8909       ((bits) == 8 ? (bfd_vma) bfd_get_8 (abfd, ptr)       \
8910        : (bits) == 16 ? bfd_get_16 (abfd, ptr)             \
8911        : (bits) == 32 ? bfd_get_32 (abfd, ptr)             \
8912        : (bits) == 64 ? bfd_get_64 (abfd, ptr)             \
8913        : (abort (), (bfd_vma) - 1))
8914
8915     #define bfd_put(bits, abfd, val, ptr)                  \
8916       ((bits) == 8 ? bfd_put_8  (abfd, val, ptr)           \
8917        : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)        \
8918        : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)        \
8919        : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)        \
8920        : (abort (), (void) 0))
8921
8922
89232.15.1.4 'bfd_h_put_size'
8924.........................
8925
8926*Description*
8927These macros have the same function as their 'bfd_get_x' brethren,
8928except that they are used for removing information for the header
8929records of object files.  Believe it or not, some object files keep
8930their header records in big endian order and their data in little endian
8931order.
8932
8933     /* Byte swapping macros for file header data.  */
8934
8935     #define bfd_h_put_8(abfd, val, ptr) \
8936       bfd_put_8 (abfd, val, ptr)
8937     #define bfd_h_put_signed_8(abfd, val, ptr) \
8938       bfd_put_8 (abfd, val, ptr)
8939     #define bfd_h_get_8(abfd, ptr) \
8940       bfd_get_8 (abfd, ptr)
8941     #define bfd_h_get_signed_8(abfd, ptr) \
8942       bfd_get_signed_8 (abfd, ptr)
8943
8944     #define bfd_h_put_16(abfd, val, ptr) \
8945       BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
8946     #define bfd_h_put_signed_16 \
8947       bfd_h_put_16
8948     #define bfd_h_get_16(abfd, ptr) \
8949       BFD_SEND (abfd, bfd_h_getx16, (ptr))
8950     #define bfd_h_get_signed_16(abfd, ptr) \
8951       BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
8952
8953     #define bfd_h_put_32(abfd, val, ptr) \
8954       BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
8955     #define bfd_h_put_signed_32 \
8956       bfd_h_put_32
8957     #define bfd_h_get_32(abfd, ptr) \
8958       BFD_SEND (abfd, bfd_h_getx32, (ptr))
8959     #define bfd_h_get_signed_32(abfd, ptr) \
8960       BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
8961
8962     #define bfd_h_put_64(abfd, val, ptr) \
8963       BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
8964     #define bfd_h_put_signed_64 \
8965       bfd_h_put_64
8966     #define bfd_h_get_64(abfd, ptr) \
8967       BFD_SEND (abfd, bfd_h_getx64, (ptr))
8968     #define bfd_h_get_signed_64(abfd, ptr) \
8969       BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
8970
8971     /* Aliases for the above, which should eventually go away.  */
8972
8973     #define H_PUT_64  bfd_h_put_64
8974     #define H_PUT_32  bfd_h_put_32
8975     #define H_PUT_16  bfd_h_put_16
8976     #define H_PUT_8   bfd_h_put_8
8977     #define H_PUT_S64 bfd_h_put_signed_64
8978     #define H_PUT_S32 bfd_h_put_signed_32
8979     #define H_PUT_S16 bfd_h_put_signed_16
8980     #define H_PUT_S8  bfd_h_put_signed_8
8981     #define H_GET_64  bfd_h_get_64
8982     #define H_GET_32  bfd_h_get_32
8983     #define H_GET_16  bfd_h_get_16
8984     #define H_GET_8   bfd_h_get_8
8985     #define H_GET_S64 bfd_h_get_signed_64
8986     #define H_GET_S32 bfd_h_get_signed_32
8987     #define H_GET_S16 bfd_h_get_signed_16
8988     #define H_GET_S8  bfd_h_get_signed_8
8989
8990
8991
89922.15.1.5 'bfd_log2'
8993...................
8994
8995*Synopsis*
8996     unsigned int bfd_log2 (bfd_vma x);
8997   *Description*
8998Return the log base 2 of the value supplied, rounded up.  E.g., an X of
89991025 returns 11.  A X of 0 returns 0.
9000
9001
9002File: bfd.info,  Node: File Caching,  Next: Linker Functions,  Prev: Internal,  Up: BFD front end
9003
90042.16 File caching
9005=================
9006
9007The file caching mechanism is embedded within BFD and allows the
9008application to open as many BFDs as it wants without regard to the
9009underlying operating system's file descriptor limit (often as low as 20
9010open files).  The module in 'cache.c' maintains a least recently used
9011list of 'bfd_cache_max_open' files, and exports the name
9012'bfd_cache_lookup', which runs around and makes sure that the required
9013BFD is open.  If not, then it chooses a file to close, closes it and
9014opens the one wanted, returning its file handle.
9015
90162.16.1 Caching functions
9017------------------------
9018
90192.16.1.1 'bfd_cache_init'
9020.........................
9021
9022*Synopsis*
9023     bfd_boolean bfd_cache_init (bfd *abfd);
9024   *Description*
9025Add a newly opened BFD to the cache.
9026
90272.16.1.2 'bfd_cache_close'
9028..........................
9029
9030*Synopsis*
9031     bfd_boolean bfd_cache_close (bfd *abfd);
9032   *Description*
9033Remove the BFD ABFD from the cache.  If the attached file is open, then
9034close it too.
9035
9036   *Returns*
9037'FALSE' is returned if closing the file fails, 'TRUE' is returned if all
9038is well.
9039
90402.16.1.3 'bfd_cache_close_all'
9041..............................
9042
9043*Synopsis*
9044     bfd_boolean bfd_cache_close_all (void);
9045   *Description*
9046Remove all BFDs from the cache.  If the attached file is open, then
9047close it too.
9048
9049   *Returns*
9050'FALSE' is returned if closing one of the file fails, 'TRUE' is returned
9051if all is well.
9052
90532.16.1.4 'bfd_open_file'
9054........................
9055
9056*Synopsis*
9057     FILE* bfd_open_file (bfd *abfd);
9058   *Description*
9059Call the OS to open a file for ABFD.  Return the 'FILE *' (possibly
9060'NULL') that results from this operation.  Set up the BFD so that future
9061accesses know the file is open.  If the 'FILE *' returned is 'NULL',
9062then it won't have been put in the cache, so it won't have to be removed
9063from it.
9064
9065
9066File: bfd.info,  Node: Linker Functions,  Next: Hash Tables,  Prev: File Caching,  Up: BFD front end
9067
90682.17 Linker Functions
9069=====================
9070
9071The linker uses three special entry points in the BFD target vector.  It
9072is not necessary to write special routines for these entry points when
9073creating a new BFD back end, since generic versions are provided.
9074However, writing them can speed up linking and make it use significantly
9075less runtime memory.
9076
9077   The first routine creates a hash table used by the other routines.
9078The second routine adds the symbols from an object file to the hash
9079table.  The third routine takes all the object files and links them
9080together to create the output file.  These routines are designed so that
9081the linker proper does not need to know anything about the symbols in
9082the object files that it is linking.  The linker merely arranges the
9083sections as directed by the linker script and lets BFD handle the
9084details of symbols and relocs.
9085
9086   The second routine and third routines are passed a pointer to a
9087'struct bfd_link_info' structure (defined in 'bfdlink.h') which holds
9088information relevant to the link, including the linker hash table (which
9089was created by the first routine) and a set of callback functions to the
9090linker proper.
9091
9092   The generic linker routines are in 'linker.c', and use the header
9093file 'genlink.h'.  As of this writing, the only back ends which have
9094implemented versions of these routines are a.out (in 'aoutx.h') and
9095ECOFF (in 'ecoff.c').  The a.out routines are used as examples
9096throughout this section.
9097
9098* Menu:
9099
9100* Creating a Linker Hash Table::
9101* Adding Symbols to the Hash Table::
9102* Performing the Final Link::
9103
9104
9105File: bfd.info,  Node: Creating a Linker Hash Table,  Next: Adding Symbols to the Hash Table,  Prev: Linker Functions,  Up: Linker Functions
9106
91072.17.1 Creating a linker hash table
9108-----------------------------------
9109
9110The linker routines must create a hash table, which must be derived from
9111'struct bfd_link_hash_table' described in 'bfdlink.c'.  *Note Hash
9112Tables::, for information on how to create a derived hash table.  This
9113entry point is called using the target vector of the linker output file.
9114
9115   The '_bfd_link_hash_table_create' entry point must allocate and
9116initialize an instance of the desired hash table.  If the back end does
9117not require any additional information to be stored with the entries in
9118the hash table, the entry point may simply create a 'struct
9119bfd_link_hash_table'.  Most likely, however, some additional information
9120will be needed.
9121
9122   For example, with each entry in the hash table the a.out linker keeps
9123the index the symbol has in the final output file (this index number is
9124used so that when doing a relocatable link the symbol index used in the
9125output file can be quickly filled in when copying over a reloc).  The
9126a.out linker code defines the required structures and functions for a
9127hash table derived from 'struct bfd_link_hash_table'.  The a.out linker
9128hash table is created by the function
9129'NAME(aout,link_hash_table_create)'; it simply allocates space for the
9130hash table, initializes it, and returns a pointer to it.
9131
9132   When writing the linker routines for a new back end, you will
9133generally not know exactly which fields will be required until you have
9134finished.  You should simply create a new hash table which defines no
9135additional fields, and then simply add fields as they become necessary.
9136
9137
9138File: bfd.info,  Node: Adding Symbols to the Hash Table,  Next: Performing the Final Link,  Prev: Creating a Linker Hash Table,  Up: Linker Functions
9139
91402.17.2 Adding symbols to the hash table
9141---------------------------------------
9142
9143The linker proper will call the '_bfd_link_add_symbols' entry point for
9144each object file or archive which is to be linked (typically these are
9145the files named on the command line, but some may also come from the
9146linker script).  The entry point is responsible for examining the file.
9147For an object file, BFD must add any relevant symbol information to the
9148hash table.  For an archive, BFD must determine which elements of the
9149archive should be used and adding them to the link.
9150
9151   The a.out version of this entry point is
9152'NAME(aout,link_add_symbols)'.
9153
9154* Menu:
9155
9156* Differing file formats::
9157* Adding symbols from an object file::
9158* Adding symbols from an archive::
9159
9160
9161File: 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
9162
91632.17.2.1 Differing file formats
9164...............................
9165
9166Normally all the files involved in a link will be of the same format,
9167but it is also possible to link together different format object files,
9168and the back end must support that.  The '_bfd_link_add_symbols' entry
9169point is called via the target vector of the file to be added.  This has
9170an important consequence: the function may not assume that the hash
9171table is the type created by the corresponding
9172'_bfd_link_hash_table_create' vector.  All the '_bfd_link_add_symbols'
9173function can assume about the hash table is that it is derived from
9174'struct bfd_link_hash_table'.
9175
9176   Sometimes the '_bfd_link_add_symbols' function must store some
9177information in the hash table entry to be used by the '_bfd_final_link'
9178function.  In such a case the output bfd xvec must be checked to make
9179sure that the hash table was created by an object file of the same
9180format.
9181
9182   The '_bfd_final_link' routine must be prepared to handle a hash entry
9183without any extra information added by the '_bfd_link_add_symbols'
9184function.  A hash entry without extra information will also occur when
9185the linker script directs the linker to create a symbol.  Note that,
9186regardless of how a hash table entry is added, all the fields will be
9187initialized to some sort of null value by the hash table entry
9188initialization function.
9189
9190   See 'ecoff_link_add_externals' for an example of how to check the
9191output bfd before saving information (in this case, the ECOFF external
9192symbol debugging information) in a hash table entry.
9193
9194
9195File: 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
9196
91972.17.2.2 Adding symbols from an object file
9198...........................................
9199
9200When the '_bfd_link_add_symbols' routine is passed an object file, it
9201must add all externally visible symbols in that object file to the hash
9202table.  The actual work of adding the symbol to the hash table is
9203normally handled by the function '_bfd_generic_link_add_one_symbol'.
9204The '_bfd_link_add_symbols' routine is responsible for reading all the
9205symbols from the object file and passing the correct information to
9206'_bfd_generic_link_add_one_symbol'.
9207
9208   The '_bfd_link_add_symbols' routine should not use
9209'bfd_canonicalize_symtab' to read the symbols.  The point of providing
9210this routine is to avoid the overhead of converting the symbols into
9211generic 'asymbol' structures.
9212
9213   '_bfd_generic_link_add_one_symbol' handles the details of combining
9214common symbols, warning about multiple definitions, and so forth.  It
9215takes arguments which describe the symbol to add, notably symbol flags,
9216a section, and an offset.  The symbol flags include such things as
9217'BSF_WEAK' or 'BSF_INDIRECT'.  The section is a section in the object
9218file, or something like 'bfd_und_section_ptr' for an undefined symbol or
9219'bfd_com_section_ptr' for a common symbol.
9220
9221   If the '_bfd_final_link' routine is also going to need to read the
9222symbol information, the '_bfd_link_add_symbols' routine should save it
9223somewhere attached to the object file BFD. However, the information
9224should only be saved if the 'keep_memory' field of the 'info' argument
9225is TRUE, so that the '-no-keep-memory' linker switch is effective.
9226
9227   The a.out function which adds symbols from an object file is
9228'aout_link_add_object_symbols', and most of the interesting work is in
9229'aout_link_add_symbols'.  The latter saves pointers to the hash tables
9230entries created by '_bfd_generic_link_add_one_symbol' indexed by symbol
9231number, so that the '_bfd_final_link' routine does not have to call the
9232hash table lookup routine to locate the entry.
9233
9234
9235File: bfd.info,  Node: Adding symbols from an archive,  Prev: Adding symbols from an object file,  Up: Adding Symbols to the Hash Table
9236
92372.17.2.3 Adding symbols from an archive
9238.......................................
9239
9240When the '_bfd_link_add_symbols' routine is passed an archive, it must
9241look through the symbols defined by the archive and decide which
9242elements of the archive should be included in the link.  For each such
9243element it must call the 'add_archive_element' linker callback, and it
9244must add the symbols from the object file to the linker hash table.
9245(The callback may in fact indicate that a replacement BFD should be
9246used, in which case the symbols from that BFD should be added to the
9247linker hash table instead.)
9248
9249   In most cases the work of looking through the symbols in the archive
9250should be done by the '_bfd_generic_link_add_archive_symbols' function.
9251'_bfd_generic_link_add_archive_symbols' is passed a function to call to
9252make the final decision about adding an archive element to the link and
9253to do the actual work of adding the symbols to the linker hash table.
9254If the element is to be included, the 'add_archive_element' linker
9255callback routine must be called with the element as an argument, and the
9256element's symbols must be added to the linker hash table just as though
9257the element had itself been passed to the '_bfd_link_add_symbols'
9258function.
9259
9260   When the a.out '_bfd_link_add_symbols' function receives an archive,
9261it calls '_bfd_generic_link_add_archive_symbols' passing
9262'aout_link_check_archive_element' as the function argument.
9263'aout_link_check_archive_element' calls 'aout_link_check_ar_symbols'.
9264If the latter decides to add the element (an element is only added if it
9265provides a real, non-common, definition for a previously undefined or
9266common symbol) it calls the 'add_archive_element' callback and then
9267'aout_link_check_archive_element' calls 'aout_link_add_symbols' to
9268actually add the symbols to the linker hash table - possibly those of a
9269substitute BFD, if the 'add_archive_element' callback avails itself of
9270that option.
9271
9272   The ECOFF back end is unusual in that it does not normally call
9273'_bfd_generic_link_add_archive_symbols', because ECOFF archives already
9274contain a hash table of symbols.  The ECOFF back end searches the
9275archive itself to avoid the overhead of creating a new hash table.
9276
9277
9278File: bfd.info,  Node: Performing the Final Link,  Prev: Adding Symbols to the Hash Table,  Up: Linker Functions
9279
92802.17.3 Performing the final link
9281--------------------------------
9282
9283When all the input files have been processed, the linker calls the
9284'_bfd_final_link' entry point of the output BFD. This routine is
9285responsible for producing the final output file, which has several
9286aspects.  It must relocate the contents of the input sections and copy
9287the data into the output sections.  It must build an output symbol table
9288including any local symbols from the input files and the global symbols
9289from the hash table.  When producing relocatable output, it must modify
9290the input relocs and write them into the output file.  There may also be
9291object format dependent work to be done.
9292
9293   The linker will also call the 'write_object_contents' entry point
9294when the BFD is closed.  The two entry points must work together in
9295order to produce the correct output file.
9296
9297   The details of how this works are inevitably dependent upon the
9298specific object file format.  The a.out '_bfd_final_link' routine is
9299'NAME(aout,final_link)'.
9300
9301* Menu:
9302
9303* Information provided by the linker::
9304* Relocating the section contents::
9305* Writing the symbol table::
9306
9307
9308File: bfd.info,  Node: Information provided by the linker,  Next: Relocating the section contents,  Prev: Performing the Final Link,  Up: Performing the Final Link
9309
93102.17.3.1 Information provided by the linker
9311...........................................
9312
9313Before the linker calls the '_bfd_final_link' entry point, it sets up
9314some data structures for the function to use.
9315
9316   The 'input_bfds' field of the 'bfd_link_info' structure will point to
9317a list of all the input files included in the link.  These files are
9318linked through the 'link.next' field of the 'bfd' structure.
9319
9320   Each section in the output file will have a list of 'link_order'
9321structures attached to the 'map_head.link_order' field (the 'link_order'
9322structure is defined in 'bfdlink.h').  These structures describe how to
9323create the contents of the output section in terms of the contents of
9324various input sections, fill constants, and, eventually, other types of
9325information.  They also describe relocs that must be created by the BFD
9326backend, but do not correspond to any input file; this is used to
9327support -Ur, which builds constructors while generating a relocatable
9328object file.
9329
9330
9331File: bfd.info,  Node: Relocating the section contents,  Next: Writing the symbol table,  Prev: Information provided by the linker,  Up: Performing the Final Link
9332
93332.17.3.2 Relocating the section contents
9334........................................
9335
9336The '_bfd_final_link' function should look through the 'link_order'
9337structures attached to each section of the output file.  Each
9338'link_order' structure should either be handled specially, or it should
9339be passed to the function '_bfd_default_link_order' which will do the
9340right thing ('_bfd_default_link_order' is defined in 'linker.c').
9341
9342   For efficiency, a 'link_order' of type 'bfd_indirect_link_order'
9343whose associated section belongs to a BFD of the same format as the
9344output BFD must be handled specially.  This type of 'link_order'
9345describes part of an output section in terms of a section belonging to
9346one of the input files.  The '_bfd_final_link' function should read the
9347contents of the section and any associated relocs, apply the relocs to
9348the section contents, and write out the modified section contents.  If
9349performing a relocatable link, the relocs themselves must also be
9350modified and written out.
9351
9352   The functions '_bfd_relocate_contents' and '_bfd_final_link_relocate'
9353provide some general support for performing the actual relocations,
9354notably overflow checking.  Their arguments include information about
9355the symbol the relocation is against and a 'reloc_howto_type' argument
9356which describes the relocation to perform.  These functions are defined
9357in 'reloc.c'.
9358
9359   The a.out function which handles reading, relocating, and writing
9360section contents is 'aout_link_input_section'.  The actual relocation is
9361done in 'aout_link_input_section_std' and 'aout_link_input_section_ext'.
9362
9363
9364File: bfd.info,  Node: Writing the symbol table,  Prev: Relocating the section contents,  Up: Performing the Final Link
9365
93662.17.3.3 Writing the symbol table
9367.................................
9368
9369The '_bfd_final_link' function must gather all the symbols in the input
9370files and write them out.  It must also write out all the symbols in the
9371global hash table.  This must be controlled by the 'strip' and 'discard'
9372fields of the 'bfd_link_info' structure.
9373
9374   The local symbols of the input files will not have been entered into
9375the linker hash table.  The '_bfd_final_link' routine must consider each
9376input file and include the symbols in the output file.  It may be
9377convenient to do this when looking through the 'link_order' structures,
9378or it may be done by stepping through the 'input_bfds' list.
9379
9380   The '_bfd_final_link' routine must also traverse the global hash
9381table to gather all the externally visible symbols.  It is possible that
9382most of the externally visible symbols may be written out when
9383considering the symbols of each input file, but it is still necessary to
9384traverse the hash table since the linker script may have defined some
9385symbols that are not in any of the input files.
9386
9387   The 'strip' field of the 'bfd_link_info' structure controls which
9388symbols are written out.  The possible values are listed in 'bfdlink.h'.
9389If the value is 'strip_some', then the 'keep_hash' field of the
9390'bfd_link_info' structure is a hash table of symbols to keep; each
9391symbol should be looked up in this hash table, and only symbols which
9392are present should be included in the output file.
9393
9394   If the 'strip' field of the 'bfd_link_info' structure permits local
9395symbols to be written out, the 'discard' field is used to further
9396controls which local symbols are included in the output file.  If the
9397value is 'discard_l', then all local symbols which begin with a certain
9398prefix are discarded; this is controlled by the
9399'bfd_is_local_label_name' entry point.
9400
9401   The a.out backend handles symbols by calling
9402'aout_link_write_symbols' on each input BFD and then traversing the
9403global hash table with the function 'aout_link_write_other_symbol'.  It
9404builds a string table while writing out the symbols, which is written to
9405the output file at the end of 'NAME(aout,final_link)'.
9406
94072.17.3.4 'bfd_link_split_section'
9408.................................
9409
9410*Synopsis*
9411     bfd_boolean bfd_link_split_section (bfd *abfd, asection *sec);
9412   *Description*
9413Return nonzero if SEC should be split during a reloceatable or final
9414link.
9415     #define bfd_link_split_section(abfd, sec) \
9416            BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
9417
9418
94192.17.3.5 'bfd_section_already_linked'
9420.....................................
9421
9422*Synopsis*
9423     bfd_boolean bfd_section_already_linked (bfd *abfd,
9424         asection *sec,
9425         struct bfd_link_info *info);
9426   *Description*
9427Check if DATA has been already linked during a reloceatable or final
9428link.  Return TRUE if it has.
9429     #define bfd_section_already_linked(abfd, sec, info) \
9430            BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
9431
9432
94332.17.3.6 'bfd_generic_define_common_symbol'
9434...........................................
9435
9436*Synopsis*
9437     bfd_boolean bfd_generic_define_common_symbol
9438        (bfd *output_bfd, struct bfd_link_info *info,
9439         struct bfd_link_hash_entry *h);
9440   *Description*
9441Convert common symbol H into a defined symbol.  Return TRUE on success
9442and FALSE on failure.
9443     #define bfd_define_common_symbol(output_bfd, info, h) \
9444            BFD_SEND (output_bfd, _bfd_define_common_symbol, (output_bfd, info, h))
9445
9446
94472.17.3.7 'bfd_generic_define_start_stop'
9448........................................
9449
9450*Synopsis*
9451     struct bfd_link_hash_entry *bfd_generic_define_start_stop
9452        (struct bfd_link_info *info,
9453         const char *symbol, asection *sec);
9454   *Description*
9455Define a __start, __stop, .startof.  or .sizeof.  symbol.  Return the
9456symbol or NULL if no such undefined symbol exists.
9457     #define bfd_define_start_stop(output_bfd, info, symbol, sec) \
9458            BFD_SEND (output_bfd, _bfd_define_start_stop, (info, symbol, sec))
9459
9460
94612.17.3.8 'bfd_find_version_for_sym'
9462...................................
9463
9464*Synopsis*
9465     struct bfd_elf_version_tree * bfd_find_version_for_sym
9466        (struct bfd_elf_version_tree *verdefs,
9467         const char *sym_name, bfd_boolean *hide);
9468   *Description*
9469Search an elf version script tree for symbol versioning info and export
9470/ don't-export status for a given symbol.  Return non-NULL on success
9471and NULL on failure; also sets the output 'hide' boolean parameter.
9472
94732.17.3.9 'bfd_hide_sym_by_version'
9474..................................
9475
9476*Synopsis*
9477     bfd_boolean bfd_hide_sym_by_version
9478        (struct bfd_elf_version_tree *verdefs, const char *sym_name);
9479   *Description*
9480Search an elf version script tree for symbol versioning info for a given
9481symbol.  Return TRUE if the symbol is hidden.
9482
94832.17.3.10 'bfd_link_check_relocs'
9484.................................
9485
9486*Synopsis*
9487     bfd_boolean bfd_link_check_relocs
9488        (bfd *abfd, struct bfd_link_info *info);
9489   *Description*
9490Checks the relocs in ABFD for validity.  Does not execute the relocs.
9491Return TRUE if everything is OK, FALSE otherwise.  This is the external
9492entry point to this code.
9493
94942.17.3.11 '_bfd_generic_link_check_relocs'
9495..........................................
9496
9497*Synopsis*
9498     bfd_boolean _bfd_generic_link_check_relocs
9499        (bfd *abfd, struct bfd_link_info *info);
9500   *Description*
9501Stub function for targets that do not implement reloc checking.  Return
9502TRUE. This is an internal function.  It should not be called from
9503outside the BFD library.
9504
95052.17.3.12 'bfd_merge_private_bfd_data'
9506......................................
9507
9508*Synopsis*
9509     bfd_boolean bfd_merge_private_bfd_data
9510        (bfd *ibfd, struct bfd_link_info *info);
9511   *Description*
9512Merge private BFD information from the BFD IBFD to the the output file
9513BFD when linking.  Return 'TRUE' on success, 'FALSE' on error.  Possible
9514error returns are:
9515
9516   * 'bfd_error_no_memory' - Not enough memory exists to create private
9517     data for OBFD.
9518     #define bfd_merge_private_bfd_data(ibfd, info) \
9519            BFD_SEND ((info)->output_bfd, _bfd_merge_private_bfd_data, \
9520                      (ibfd, info))
9521
95222.17.3.13 '_bfd_generic_verify_endian_match'
9523............................................
9524
9525*Synopsis*
9526     bfd_boolean _bfd_generic_verify_endian_match
9527        (bfd *ibfd, struct bfd_link_info *info);
9528   *Description*
9529Can be used from / for bfd_merge_private_bfd_data to check that
9530endianness matches between input and output file.  Returns TRUE for a
9531match, otherwise returns FALSE and emits an error.
9532
9533
9534File: bfd.info,  Node: Hash Tables,  Prev: Linker Functions,  Up: BFD front end
9535
95362.18 Hash Tables
9537================
9538
9539BFD provides a simple set of hash table functions.  Routines are
9540provided to initialize a hash table, to free a hash table, to look up a
9541string in a hash table and optionally create an entry for it, and to
9542traverse a hash table.  There is currently no routine to delete an
9543string from a hash table.
9544
9545   The basic hash table does not permit any data to be stored with a
9546string.  However, a hash table is designed to present a base class from
9547which other types of hash tables may be derived.  These derived types
9548may store additional information with the string.  Hash tables were
9549implemented in this way, rather than simply providing a data pointer in
9550a hash table entry, because they were designed for use by the linker
9551back ends.  The linker may create thousands of hash table entries, and
9552the overhead of allocating private data and storing and following
9553pointers becomes noticeable.
9554
9555   The basic hash table code is in 'hash.c'.
9556
9557* Menu:
9558
9559* Creating and Freeing a Hash Table::
9560* Looking Up or Entering a String::
9561* Traversing a Hash Table::
9562* Deriving a New Hash Table Type::
9563
9564
9565File: bfd.info,  Node: Creating and Freeing a Hash Table,  Next: Looking Up or Entering a String,  Prev: Hash Tables,  Up: Hash Tables
9566
95672.18.1 Creating and freeing a hash table
9568----------------------------------------
9569
9570To create a hash table, create an instance of a 'struct bfd_hash_table'
9571(defined in 'bfd.h') and call 'bfd_hash_table_init' (if you know
9572approximately how many entries you will need, the function
9573'bfd_hash_table_init_n', which takes a SIZE argument, may be used).
9574'bfd_hash_table_init' returns 'FALSE' if some sort of error occurs.
9575
9576   The function 'bfd_hash_table_init' take as an argument a function to
9577use to create new entries.  For a basic hash table, use the function
9578'bfd_hash_newfunc'.  *Note Deriving a New Hash Table Type::, for why you
9579would want to use a different value for this argument.
9580
9581   'bfd_hash_table_init' will create an objalloc which will be used to
9582allocate new entries.  You may allocate memory on this objalloc using
9583'bfd_hash_allocate'.
9584
9585   Use 'bfd_hash_table_free' to free up all the memory that has been
9586allocated for a hash table.  This will not free up the 'struct
9587bfd_hash_table' itself, which you must provide.
9588
9589   Use 'bfd_hash_set_default_size' to set the default size of hash table
9590to use.
9591
9592
9593File: bfd.info,  Node: Looking Up or Entering a String,  Next: Traversing a Hash Table,  Prev: Creating and Freeing a Hash Table,  Up: Hash Tables
9594
95952.18.2 Looking up or entering a string
9596--------------------------------------
9597
9598The function 'bfd_hash_lookup' is used both to look up a string in the
9599hash table and to create a new entry.
9600
9601   If the CREATE argument is 'FALSE', 'bfd_hash_lookup' will look up a
9602string.  If the string is found, it will returns a pointer to a 'struct
9603bfd_hash_entry'.  If the string is not found in the table
9604'bfd_hash_lookup' will return 'NULL'.  You should not modify any of the
9605fields in the returns 'struct bfd_hash_entry'.
9606
9607   If the CREATE argument is 'TRUE', the string will be entered into the
9608hash table if it is not already there.  Either way a pointer to a
9609'struct bfd_hash_entry' will be returned, either to the existing
9610structure or to a newly created one.  In this case, a 'NULL' return
9611means that an error occurred.
9612
9613   If the CREATE argument is 'TRUE', and a new entry is created, the
9614COPY argument is used to decide whether to copy the string onto the hash
9615table objalloc or not.  If COPY is passed as 'FALSE', you must be
9616careful not to deallocate or modify the string as long as the hash table
9617exists.
9618
9619
9620File: bfd.info,  Node: Traversing a Hash Table,  Next: Deriving a New Hash Table Type,  Prev: Looking Up or Entering a String,  Up: Hash Tables
9621
96222.18.3 Traversing a hash table
9623------------------------------
9624
9625The function 'bfd_hash_traverse' may be used to traverse a hash table,
9626calling a function on each element.  The traversal is done in a random
9627order.
9628
9629   'bfd_hash_traverse' takes as arguments a function and a generic 'void
9630*' pointer.  The function is called with a hash table entry (a 'struct
9631bfd_hash_entry *') and the generic pointer passed to
9632'bfd_hash_traverse'.  The function must return a 'boolean' value, which
9633indicates whether to continue traversing the hash table.  If the
9634function returns 'FALSE', 'bfd_hash_traverse' will stop the traversal
9635and return immediately.
9636
9637
9638File: bfd.info,  Node: Deriving a New Hash Table Type,  Prev: Traversing a Hash Table,  Up: Hash Tables
9639
96402.18.4 Deriving a new hash table type
9641-------------------------------------
9642
9643Many uses of hash tables want to store additional information which each
9644entry in the hash table.  Some also find it convenient to store
9645additional information with the hash table itself.  This may be done
9646using a derived hash table.
9647
9648   Since C is not an object oriented language, creating a derived hash
9649table requires sticking together some boilerplate routines with a few
9650differences specific to the type of hash table you want to create.
9651
9652   An example of a derived hash table is the linker hash table.  The
9653structures for this are defined in 'bfdlink.h'.  The functions are in
9654'linker.c'.
9655
9656   You may also derive a hash table from an already derived hash table.
9657For example, the a.out linker backend code uses a hash table derived
9658from the linker hash table.
9659
9660* Menu:
9661
9662* Define the Derived Structures::
9663* Write the Derived Creation Routine::
9664* Write Other Derived Routines::
9665
9666
9667File: 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
9668
96692.18.4.1 Define the derived structures
9670......................................
9671
9672You must define a structure for an entry in the hash table, and a
9673structure for the hash table itself.
9674
9675   The first field in the structure for an entry in the hash table must
9676be of the type used for an entry in the hash table you are deriving
9677from.  If you are deriving from a basic hash table this is 'struct
9678bfd_hash_entry', which is defined in 'bfd.h'.  The first field in the
9679structure for the hash table itself must be of the type of the hash
9680table you are deriving from itself.  If you are deriving from a basic
9681hash table, this is 'struct bfd_hash_table'.
9682
9683   For example, the linker hash table defines 'struct
9684bfd_link_hash_entry' (in 'bfdlink.h').  The first field, 'root', is of
9685type 'struct bfd_hash_entry'.  Similarly, the first field in 'struct
9686bfd_link_hash_table', 'table', is of type 'struct bfd_hash_table'.
9687
9688
9689File: 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
9690
96912.18.4.2 Write the derived creation routine
9692...........................................
9693
9694You must write a routine which will create and initialize an entry in
9695the hash table.  This routine is passed as the function argument to
9696'bfd_hash_table_init'.
9697
9698   In order to permit other hash tables to be derived from the hash
9699table you are creating, this routine must be written in a standard way.
9700
9701   The first argument to the creation routine is a pointer to a hash
9702table entry.  This may be 'NULL', in which case the routine should
9703allocate the right amount of space.  Otherwise the space has already
9704been allocated by a hash table type derived from this one.
9705
9706   After allocating space, the creation routine must call the creation
9707routine of the hash table type it is derived from, passing in a pointer
9708to the space it just allocated.  This will initialize any fields used by
9709the base hash table.
9710
9711   Finally the creation routine must initialize any local fields for the
9712new hash table type.
9713
9714   Here is a boilerplate example of a creation routine.  FUNCTION_NAME
9715is the name of the routine.  ENTRY_TYPE is the type of an entry in the
9716hash table you are creating.  BASE_NEWFUNC is the name of the creation
9717routine of the hash table type your hash table is derived from.
9718
9719     struct bfd_hash_entry *
9720     FUNCTION_NAME (struct bfd_hash_entry *entry,
9721                          struct bfd_hash_table *table,
9722                          const char *string)
9723     {
9724       struct ENTRY_TYPE *ret = (ENTRY_TYPE *) entry;
9725
9726      /* Allocate the structure if it has not already been allocated by a
9727         derived class.  */
9728       if (ret == NULL)
9729         {
9730           ret = bfd_hash_allocate (table, sizeof (* ret));
9731           if (ret == NULL)
9732             return NULL;
9733         }
9734
9735      /* Call the allocation method of the base class.  */
9736       ret = ((ENTRY_TYPE *)
9737              BASE_NEWFUNC ((struct bfd_hash_entry *) ret, table, string));
9738
9739      /* Initialize the local fields here.  */
9740
9741       return (struct bfd_hash_entry *) ret;
9742     }
9743   *Description*
9744The creation routine for the linker hash table, which is in 'linker.c',
9745looks just like this example.  FUNCTION_NAME is
9746'_bfd_link_hash_newfunc'.  ENTRY_TYPE is 'struct bfd_link_hash_entry'.
9747BASE_NEWFUNC is 'bfd_hash_newfunc', the creation routine for a basic
9748hash table.
9749
9750   '_bfd_link_hash_newfunc' also initializes the local fields in a
9751linker hash table entry: 'type', 'written' and 'next'.
9752
9753
9754File: bfd.info,  Node: Write Other Derived Routines,  Prev: Write the Derived Creation Routine,  Up: Deriving a New Hash Table Type
9755
97562.18.4.3 Write other derived routines
9757.....................................
9758
9759You will want to write other routines for your new hash table, as well.
9760
9761   You will want an initialization routine which calls the
9762initialization routine of the hash table you are deriving from and
9763initializes any other local fields.  For the linker hash table, this is
9764'_bfd_link_hash_table_init' in 'linker.c'.
9765
9766   You will want a lookup routine which calls the lookup routine of the
9767hash table you are deriving from and casts the result.  The linker hash
9768table uses 'bfd_link_hash_lookup' in 'linker.c' (this actually takes an
9769additional argument which it uses to decide how to return the looked up
9770value).
9771
9772   You may want a traversal routine.  This should just call the
9773traversal routine of the hash table you are deriving from with
9774appropriate casts.  The linker hash table uses 'bfd_link_hash_traverse'
9775in 'linker.c'.
9776
9777   These routines may simply be defined as macros.  For example, the
9778a.out backend linker hash table, which is derived from the linker hash
9779table, uses macros for the lookup and traversal routines.  These are
9780'aout_link_hash_lookup' and 'aout_link_hash_traverse' in aoutx.h.
9781
9782
9783File: bfd.info,  Node: BFD back ends,  Next: GNU Free Documentation License,  Prev: BFD front end,  Up: Top
9784
97853 BFD back ends
9786***************
9787
9788* Menu:
9789
9790* What to Put Where::
9791* aout ::	a.out backends
9792* coff ::	coff backends
9793* elf  ::	elf backends
9794* mmo  ::	mmo backend
9795
9796
9797File: bfd.info,  Node: What to Put Where,  Next: aout,  Prev: BFD back ends,  Up: BFD back ends
9798
97993.1 What to Put Where
9800=====================
9801
9802All of BFD lives in one directory.
9803
9804
9805File: bfd.info,  Node: aout,  Next: coff,  Prev: What to Put Where,  Up: BFD back ends
9806
98073.2 a.out backends
9808==================
9809
9810*Description*
9811BFD supports a number of different flavours of a.out format, though the
9812major differences are only the sizes of the structures on disk, and the
9813shape of the relocation information.
9814
9815   The support is split into a basic support file 'aoutx.h' and other
9816files which derive functions from the base.  One derivation file is
9817'aoutf1.h' (for a.out flavour 1), and adds to the basic a.out functions
9818support for sun3, sun4, 386 and 29k a.out files, to create a target jump
9819vector for a specific target.
9820
9821   This information is further split out into more specific files for
9822each machine, including 'sunos.c' for sun3 and sun4, 'newsos3.c' for the
9823Sony NEWS, and 'demo64.c' for a demonstration of a 64 bit a.out format.
9824
9825   The base file 'aoutx.h' defines general mechanisms for reading and
9826writing records to and from disk and various other methods which BFD
9827requires.  It is included by 'aout32.c' and 'aout64.c' to form the names
9828'aout_32_swap_exec_header_in', 'aout_64_swap_exec_header_in', etc.
9829
9830   As an example, this is what goes on to make the back end for a sun4,
9831from 'aout32.c':
9832
9833            #define ARCH_SIZE 32
9834            #include "aoutx.h"
9835
9836   Which exports names:
9837
9838            ...
9839            aout_32_canonicalize_reloc
9840            aout_32_find_nearest_line
9841            aout_32_get_lineno
9842            aout_32_get_reloc_upper_bound
9843            ...
9844
9845   from 'sunos.c':
9846
9847            #define TARGET_NAME "a.out-sunos-big"
9848            #define VECNAME    sparc_aout_sunos_be_vec
9849            #include "aoutf1.h"
9850
9851   requires all the names from 'aout32.c', and produces the jump vector
9852
9853            sparc_aout_sunos_be_vec
9854
9855   The file 'host-aout.c' is a special case.  It is for a large set of
9856hosts that use "more or less standard" a.out files, and for which
9857cross-debugging is not interesting.  It uses the standard 32-bit a.out
9858support routines, but determines the file offsets and addresses of the
9859text, data, and BSS sections, the machine architecture and machine type,
9860and the entry point address, in a host-dependent manner.  Once these
9861values have been determined, generic code is used to handle the object
9862file.
9863
9864   When porting it to run on a new system, you must supply:
9865
9866             HOST_PAGE_SIZE
9867             HOST_SEGMENT_SIZE
9868             HOST_MACHINE_ARCH       (optional)
9869             HOST_MACHINE_MACHINE    (optional)
9870             HOST_TEXT_START_ADDR
9871             HOST_STACK_END_ADDR
9872
9873   in the file '../include/sys/h-XXX.h' (for your host).  These values,
9874plus the structures and macros defined in 'a.out.h' on your host system,
9875will produce a BFD target that will access ordinary a.out files on your
9876host.  To configure a new machine to use 'host-aout.c', specify:
9877
9878            TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
9879            TDEPFILES= host-aout.o trad-core.o
9880
9881   in the 'config/XXX.mt' file, and modify 'configure.ac' to use the
9882'XXX.mt' file (by setting "'bfd_target=XXX'") when your configuration is
9883selected.
9884
98853.2.1 Relocations
9886-----------------
9887
9888*Description*
9889The file 'aoutx.h' provides for both the _standard_ and _extended_ forms
9890of a.out relocation records.
9891
9892   The standard records contain only an address, a symbol index, and a
9893type field.  The extended records (used on 29ks and sparcs) also have a
9894full integer for an addend.
9895
98963.2.2 Internal entry points
9897---------------------------
9898
9899*Description*
9900'aoutx.h' exports several routines for accessing the contents of an
9901a.out file, which are gathered and exported in turn by various format
9902specific files (eg sunos.c).
9903
99043.2.2.1 'aout_SIZE_swap_exec_header_in'
9905.......................................
9906
9907*Synopsis*
9908     void aout_SIZE_swap_exec_header_in,
9909        (bfd *abfd,
9910         struct external_exec *bytes,
9911         struct internal_exec *execp);
9912   *Description*
9913Swap the information in an executable header RAW_BYTES taken from a raw
9914byte stream memory image into the internal exec header structure EXECP.
9915
99163.2.2.2 'aout_SIZE_swap_exec_header_out'
9917........................................
9918
9919*Synopsis*
9920     void aout_SIZE_swap_exec_header_out
9921        (bfd *abfd,
9922         struct internal_exec *execp,
9923         struct external_exec *raw_bytes);
9924   *Description*
9925Swap the information in an internal exec header structure EXECP into the
9926buffer RAW_BYTES ready for writing to disk.
9927
99283.2.2.3 'aout_SIZE_some_aout_object_p'
9929......................................
9930
9931*Synopsis*
9932     const bfd_target *aout_SIZE_some_aout_object_p
9933        (bfd *abfd,
9934         struct internal_exec *execp,
9935         const bfd_target *(*callback_to_real_object_p) (bfd *));
9936   *Description*
9937Some a.out variant thinks that the file open in ABFD checking is an
9938a.out file.  Do some more checking, and set up for access if it really
9939is.  Call back to the calling environment's "finish up" function just
9940before returning, to handle any last-minute setup.
9941
99423.2.2.4 'aout_SIZE_mkobject'
9943............................
9944
9945*Synopsis*
9946     bfd_boolean aout_SIZE_mkobject, (bfd *abfd);
9947   *Description*
9948Initialize BFD ABFD for use with a.out files.
9949
99503.2.2.5 'aout_SIZE_machine_type'
9951................................
9952
9953*Synopsis*
9954     enum machine_type  aout_SIZE_machine_type
9955        (enum bfd_architecture arch,
9956         unsigned long machine,
9957         bfd_boolean *unknown);
9958   *Description*
9959Keep track of machine architecture and machine type for a.out's.  Return
9960the 'machine_type' for a particular architecture and machine, or
9961'M_UNKNOWN' if that exact architecture and machine can't be represented
9962in a.out format.
9963
9964   If the architecture is understood, machine type 0 (default) is always
9965understood.
9966
99673.2.2.6 'aout_SIZE_set_arch_mach'
9968.................................
9969
9970*Synopsis*
9971     bfd_boolean aout_SIZE_set_arch_mach,
9972        (bfd *,
9973         enum bfd_architecture arch,
9974         unsigned long machine);
9975   *Description*
9976Set the architecture and the machine of the BFD ABFD to the values ARCH
9977and MACHINE.  Verify that ABFD's format can support the architecture
9978required.
9979
99803.2.2.7 'aout_SIZE_new_section_hook'
9981....................................
9982
9983*Synopsis*
9984     bfd_boolean aout_SIZE_new_section_hook,
9985        (bfd *abfd,
9986         asection *newsect);
9987   *Description*
9988Called by the BFD in response to a 'bfd_make_section' request.
9989
9990
9991File: bfd.info,  Node: coff,  Next: elf,  Prev: aout,  Up: BFD back ends
9992
99933.3 coff backends
9994=================
9995
9996BFD supports a number of different flavours of coff format.  The major
9997differences between formats are the sizes and alignments of fields in
9998structures on disk, and the occasional extra field.
9999
10000   Coff in all its varieties is implemented with a few common files and
10001a number of implementation specific files.  For example, The 88k bcs
10002coff format is implemented in the file 'coff-m88k.c'.  This file
10003'#include's 'coff/m88k.h' which defines the external structure of the
10004coff format for the 88k, and 'coff/internal.h' which defines the
10005internal structure.  'coff-m88k.c' also defines the relocations used by
10006the 88k format *Note Relocations::.
10007
10008   The Intel i960 processor version of coff is implemented in
10009'coff-i960.c'.  This file has the same structure as 'coff-m88k.c',
10010except that it includes 'coff/i960.h' rather than 'coff-m88k.h'.
10011
100123.3.1 Porting to a new version of coff
10013--------------------------------------
10014
10015The recommended method is to select from the existing implementations
10016the version of coff which is most like the one you want to use.  For
10017example, we'll say that i386 coff is the one you select, and that your
10018coff flavour is called foo.  Copy 'i386coff.c' to 'foocoff.c', copy
10019'../include/coff/i386.h' to '../include/coff/foo.h', and add the lines
10020to 'targets.c' and 'Makefile.in' so that your new back end is used.
10021Alter the shapes of the structures in '../include/coff/foo.h' so that
10022they match what you need.  You will probably also have to add '#ifdef's
10023to the code in 'coff/internal.h' and 'coffcode.h' if your version of
10024coff is too wild.
10025
10026   You can verify that your new BFD backend works quite simply by
10027building 'objdump' from the 'binutils' directory, and making sure that
10028its version of what's going on and your host system's idea (assuming it
10029has the pretty standard coff dump utility, usually called 'att-dump' or
10030just 'dump') are the same.  Then clean up your code, and send what
10031you've done to Cygnus.  Then your stuff will be in the next release, and
10032you won't have to keep integrating it.
10033
100343.3.2 How the coff backend works
10035--------------------------------
10036
100373.3.2.1 File layout
10038...................
10039
10040The Coff backend is split into generic routines that are applicable to
10041any Coff target and routines that are specific to a particular target.
10042The target-specific routines are further split into ones which are
10043basically the same for all Coff targets except that they use the
10044external symbol format or use different values for certain constants.
10045
10046   The generic routines are in 'coffgen.c'.  These routines work for any
10047Coff target.  They use some hooks into the target specific code; the
10048hooks are in a 'bfd_coff_backend_data' structure, one of which exists
10049for each target.
10050
10051   The essentially similar target-specific routines are in 'coffcode.h'.
10052This header file includes executable C code.  The various Coff targets
10053first include the appropriate Coff header file, make any special defines
10054that are needed, and then include 'coffcode.h'.
10055
10056   Some of the Coff targets then also have additional routines in the
10057target source file itself.
10058
10059   For example, 'coff-i960.c' includes 'coff/internal.h' and
10060'coff/i960.h'.  It then defines a few constants, such as 'I960', and
10061includes 'coffcode.h'.  Since the i960 has complex relocation types,
10062'coff-i960.c' also includes some code to manipulate the i960 relocs.
10063This code is not in 'coffcode.h' because it would not be used by any
10064other target.
10065
100663.3.2.2 Coff long section names
10067...............................
10068
10069In the standard Coff object format, section names are limited to the
10070eight bytes available in the 's_name' field of the 'SCNHDR' section
10071header structure.  The format requires the field to be NUL-padded, but
10072not necessarily NUL-terminated, so the longest section names permitted
10073are a full eight characters.
10074
10075   The Microsoft PE variants of the Coff object file format add an
10076extension to support the use of long section names.  This extension is
10077defined in section 4 of the Microsoft PE/COFF specification (rev 8.1).
10078If a section name is too long to fit into the section header's 's_name'
10079field, it is instead placed into the string table, and the 's_name'
10080field is filled with a slash ("/") followed by the ASCII decimal
10081representation of the offset of the full name relative to the string
10082table base.
10083
10084   Note that this implies that the extension can only be used in object
10085files, as executables do not contain a string table.  The standard
10086specifies that long section names from objects emitted into executable
10087images are to be truncated.
10088
10089   However, as a GNU extension, BFD can generate executable images that
10090contain a string table and long section names.  This would appear to be
10091technically valid, as the standard only says that Coff debugging
10092information is deprecated, not forbidden, and in practice it works,
10093although some tools that parse PE files expecting the MS standard format
10094may become confused; 'PEview' is one known example.
10095
10096   The functionality is supported in BFD by code implemented under the
10097control of the macro 'COFF_LONG_SECTION_NAMES'.  If not defined, the
10098format does not support long section names in any way.  If defined, it
10099is used to initialise a flag, '_bfd_coff_long_section_names', and a hook
10100function pointer, '_bfd_coff_set_long_section_names', in the Coff
10101backend data structure.  The flag controls the generation of long
10102section names in output BFDs at runtime; if it is false, as it will be
10103by default when generating an executable image, long section names are
10104truncated; if true, the long section names extension is employed.  The
10105hook points to a function that allows the value of the flag to be
10106altered at runtime, on formats that support long section names at all;
10107on other formats it points to a stub that returns an error indication.
10108
10109   With input BFDs, the flag is set according to whether any long
10110section names are detected while reading the section headers.  For a
10111completely new BFD, the flag is set to the default for the target
10112format.  This information can be used by a client of the BFD library
10113when deciding what output format to generate, and means that a BFD that
10114is opened for read and subsequently converted to a writeable BFD and
10115modified in-place will retain whatever format it had on input.
10116
10117   If 'COFF_LONG_SECTION_NAMES' is simply defined (blank), or is defined
10118to the value "1", then long section names are enabled by default; if it
10119is defined to the value zero, they are disabled by default (but still
10120accepted in input BFDs).  The header 'coffcode.h' defines a macro,
10121'COFF_DEFAULT_LONG_SECTION_NAMES', which is used in the backends to
10122initialise the backend data structure fields appropriately; see the
10123comments for further detail.
10124
101253.3.2.3 Bit twiddling
10126.....................
10127
10128Each flavour of coff supported in BFD has its own header file describing
10129the external layout of the structures.  There is also an internal
10130description of the coff layout, in 'coff/internal.h'.  A major function
10131of the coff backend is swapping the bytes and twiddling the bits to
10132translate the external form of the structures into the normal internal
10133form.  This is all performed in the 'bfd_swap'_thing_direction routines.
10134Some elements are different sizes between different versions of coff; it
10135is the duty of the coff version specific include file to override the
10136definitions of various packing routines in 'coffcode.h'.  E.g., the size
10137of line number entry in coff is sometimes 16 bits, and sometimes 32
10138bits.  '#define'ing 'PUT_LNSZ_LNNO' and 'GET_LNSZ_LNNO' will select the
10139correct one.  No doubt, some day someone will find a version of coff
10140which has a varying field size not catered to at the moment.  To port
10141BFD, that person will have to add more '#defines'.  Three of the bit
10142twiddling routines are exported to 'gdb'; 'coff_swap_aux_in',
10143'coff_swap_sym_in' and 'coff_swap_lineno_in'.  'GDB' reads the symbol
10144table on its own, but uses BFD to fix things up.  More of the bit
10145twiddlers are exported for 'gas'; 'coff_swap_aux_out',
10146'coff_swap_sym_out', 'coff_swap_lineno_out', 'coff_swap_reloc_out',
10147'coff_swap_filehdr_out', 'coff_swap_aouthdr_out',
10148'coff_swap_scnhdr_out'.  'Gas' currently keeps track of all the symbol
10149table and reloc drudgery itself, thereby saving the internal BFD
10150overhead, but uses BFD to swap things on the way out, making cross ports
10151much safer.  Doing so also allows BFD (and thus the linker) to use the
10152same header files as 'gas', which makes one avenue to disaster
10153disappear.
10154
101553.3.2.4 Symbol reading
10156......................
10157
10158The simple canonical form for symbols used by BFD is not rich enough to
10159keep all the information available in a coff symbol table.  The back end
10160gets around this problem by keeping the original symbol table around,
10161"behind the scenes".
10162
10163   When a symbol table is requested (through a call to
10164'bfd_canonicalize_symtab'), a request gets through to
10165'coff_get_normalized_symtab'.  This reads the symbol table from the coff
10166file and swaps all the structures inside into the internal form.  It
10167also fixes up all the pointers in the table (represented in the file by
10168offsets from the first symbol in the table) into physical pointers to
10169elements in the new internal table.  This involves some work since the
10170meanings of fields change depending upon context: a field that is a
10171pointer to another structure in the symbol table at one moment may be
10172the size in bytes of a structure at the next.  Another pass is made over
10173the table.  All symbols which mark file names ('C_FILE' symbols) are
10174modified so that the internal string points to the value in the auxent
10175(the real filename) rather than the normal text associated with the
10176symbol ('".file"').
10177
10178   At this time the symbol names are moved around.  Coff stores all
10179symbols less than nine characters long physically within the symbol
10180table; longer strings are kept at the end of the file in the string
10181table.  This pass moves all strings into memory and replaces them with
10182pointers to the strings.
10183
10184   The symbol table is massaged once again, this time to create the
10185canonical table used by the BFD application.  Each symbol is inspected
10186in turn, and a decision made (using the 'sclass' field) about the
10187various flags to set in the 'asymbol'.  *Note Symbols::.  The generated
10188canonical table shares strings with the hidden internal symbol table.
10189
10190   Any linenumbers are read from the coff file too, and attached to the
10191symbols which own the functions the linenumbers belong to.
10192
101933.3.2.5 Symbol writing
10194......................
10195
10196Writing a symbol to a coff file which didn't come from a coff file will
10197lose any debugging information.  The 'asymbol' structure remembers the
10198BFD from which the symbol was taken, and on output the back end makes
10199sure that the same destination target as source target is present.
10200
10201   When the symbols have come from a coff file then all the debugging
10202information is preserved.
10203
10204   Symbol tables are provided for writing to the back end in a vector of
10205pointers to pointers.  This allows applications like the linker to
10206accumulate and output large symbol tables without having to do too much
10207byte copying.
10208
10209   This function runs through the provided symbol table and patches each
10210symbol marked as a file place holder ('C_FILE') to point to the next
10211file place holder in the list.  It also marks each 'offset' field in the
10212list with the offset from the first symbol of the current symbol.
10213
10214   Another function of this procedure is to turn the canonical value
10215form of BFD into the form used by coff.  Internally, BFD expects symbol
10216values to be offsets from a section base; so a symbol physically at
102170x120, but in a section starting at 0x100, would have the value 0x20.
10218Coff expects symbols to contain their final value, so symbols have their
10219values changed at this point to reflect their sum with their owning
10220section.  This transformation uses the 'output_section' field of the
10221'asymbol''s 'asection' *Note Sections::.
10222
10223   * 'coff_mangle_symbols'
10224   This routine runs though the provided symbol table and uses the
10225offsets generated by the previous pass and the pointers generated when
10226the symbol table was read in to create the structured hierarchy required
10227by coff.  It changes each pointer to a symbol into the index into the
10228symbol table of the asymbol.
10229
10230   * 'coff_write_symbols'
10231   This routine runs through the symbol table and patches up the symbols
10232from their internal form into the coff way, calls the bit twiddlers, and
10233writes out the table to the file.
10234
102353.3.2.6 'coff_symbol_type'
10236..........................
10237
10238*Description*
10239The hidden information for an 'asymbol' is described in a
10240'combined_entry_type':
10241
10242
10243     typedef struct coff_ptr_struct
10244     {
10245       /* Remembers the offset from the first symbol in the file for
10246          this symbol. Generated by coff_renumber_symbols.  */
10247       unsigned int offset;
10248
10249       /* Should the value of this symbol be renumbered.  Used for
10250          XCOFF C_BSTAT symbols.  Set by coff_slurp_symbol_table.  */
10251       unsigned int fix_value : 1;
10252
10253       /* Should the tag field of this symbol be renumbered.
10254          Created by coff_pointerize_aux.  */
10255       unsigned int fix_tag : 1;
10256
10257       /* Should the endidx field of this symbol be renumbered.
10258          Created by coff_pointerize_aux.  */
10259       unsigned int fix_end : 1;
10260
10261       /* Should the x_csect.x_scnlen field be renumbered.
10262          Created by coff_pointerize_aux.  */
10263       unsigned int fix_scnlen : 1;
10264
10265       /* Fix up an XCOFF C_BINCL/C_EINCL symbol.  The value is the
10266          index into the line number entries.  Set by coff_slurp_symbol_table.  */
10267       unsigned int fix_line : 1;
10268
10269       /* The container for the symbol structure as read and translated
10270          from the file.  */
10271       union
10272       {
10273         union internal_auxent auxent;
10274         struct internal_syment syment;
10275       } u;
10276
10277      /* Selector for the union above.  */
10278      bfd_boolean is_sym;
10279     } combined_entry_type;
10280
10281
10282     /* Each canonical asymbol really looks like this: */
10283
10284     typedef struct coff_symbol_struct
10285     {
10286       /* The actual symbol which the rest of BFD works with */
10287       asymbol symbol;
10288
10289       /* A pointer to the hidden information for this symbol */
10290       combined_entry_type *native;
10291
10292       /* A pointer to the linenumber information for this symbol */
10293       struct lineno_cache_entry *lineno;
10294
10295       /* Have the line numbers been relocated yet ? */
10296       bfd_boolean done_lineno;
10297     } coff_symbol_type;
10298
102993.3.2.7 'bfd_coff_backend_data'
10300...............................
10301
10302     /* COFF symbol classifications.  */
10303
10304     enum coff_symbol_classification
10305     {
10306       /* Global symbol.  */
10307       COFF_SYMBOL_GLOBAL,
10308       /* Common symbol.  */
10309       COFF_SYMBOL_COMMON,
10310       /* Undefined symbol.  */
10311       COFF_SYMBOL_UNDEFINED,
10312       /* Local symbol.  */
10313       COFF_SYMBOL_LOCAL,
10314       /* PE section symbol.  */
10315       COFF_SYMBOL_PE_SECTION
10316     };
10317
10318     typedef asection * (*coff_gc_mark_hook_fn)
10319       (asection *, struct bfd_link_info *, struct internal_reloc *,
10320        struct coff_link_hash_entry *, struct internal_syment *);
10321
10322   Special entry points for gdb to swap in coff symbol table parts:
10323     typedef struct
10324     {
10325       void (*_bfd_coff_swap_aux_in)
10326         (bfd *, void *, int, int, int, int, void *);
10327
10328       void (*_bfd_coff_swap_sym_in)
10329         (bfd *, void *, void *);
10330
10331       void (*_bfd_coff_swap_lineno_in)
10332         (bfd *, void *, void *);
10333
10334       unsigned int (*_bfd_coff_swap_aux_out)
10335         (bfd *, void *, int, int, int, int, void *);
10336
10337       unsigned int (*_bfd_coff_swap_sym_out)
10338         (bfd *, void *, void *);
10339
10340       unsigned int (*_bfd_coff_swap_lineno_out)
10341         (bfd *, void *, void *);
10342
10343       unsigned int (*_bfd_coff_swap_reloc_out)
10344         (bfd *, void *, void *);
10345
10346       unsigned int (*_bfd_coff_swap_filehdr_out)
10347         (bfd *, void *, void *);
10348
10349       unsigned int (*_bfd_coff_swap_aouthdr_out)
10350         (bfd *, void *, void *);
10351
10352       unsigned int (*_bfd_coff_swap_scnhdr_out)
10353         (bfd *, void *, void *);
10354
10355       unsigned int _bfd_filhsz;
10356       unsigned int _bfd_aoutsz;
10357       unsigned int _bfd_scnhsz;
10358       unsigned int _bfd_symesz;
10359       unsigned int _bfd_auxesz;
10360       unsigned int _bfd_relsz;
10361       unsigned int _bfd_linesz;
10362       unsigned int _bfd_filnmlen;
10363       bfd_boolean _bfd_coff_long_filenames;
10364
10365       bfd_boolean _bfd_coff_long_section_names;
10366       bfd_boolean (*_bfd_coff_set_long_section_names)
10367         (bfd *, int);
10368
10369       unsigned int _bfd_coff_default_section_alignment_power;
10370       bfd_boolean _bfd_coff_force_symnames_in_strings;
10371       unsigned int _bfd_coff_debug_string_prefix_length;
10372       unsigned int _bfd_coff_max_nscns;
10373
10374       void (*_bfd_coff_swap_filehdr_in)
10375         (bfd *, void *, void *);
10376
10377       void (*_bfd_coff_swap_aouthdr_in)
10378         (bfd *, void *, void *);
10379
10380       void (*_bfd_coff_swap_scnhdr_in)
10381         (bfd *, void *, void *);
10382
10383       void (*_bfd_coff_swap_reloc_in)
10384         (bfd *abfd, void *, void *);
10385
10386       bfd_boolean (*_bfd_coff_bad_format_hook)
10387         (bfd *, void *);
10388
10389       bfd_boolean (*_bfd_coff_set_arch_mach_hook)
10390         (bfd *, void *);
10391
10392       void * (*_bfd_coff_mkobject_hook)
10393         (bfd *, void *, void *);
10394
10395       bfd_boolean (*_bfd_styp_to_sec_flags_hook)
10396         (bfd *, void *, const char *, asection *, flagword *);
10397
10398       void (*_bfd_set_alignment_hook)
10399         (bfd *, asection *, void *);
10400
10401       bfd_boolean (*_bfd_coff_slurp_symbol_table)
10402         (bfd *);
10403
10404       bfd_boolean (*_bfd_coff_symname_in_debug)
10405         (bfd *, struct internal_syment *);
10406
10407       bfd_boolean (*_bfd_coff_pointerize_aux_hook)
10408         (bfd *, combined_entry_type *, combined_entry_type *,
10409          unsigned int, combined_entry_type *);
10410
10411       bfd_boolean (*_bfd_coff_print_aux)
10412         (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
10413          combined_entry_type *, unsigned int);
10414
10415       void (*_bfd_coff_reloc16_extra_cases)
10416         (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
10417          bfd_byte *, unsigned int *, unsigned int *);
10418
10419       int (*_bfd_coff_reloc16_estimate)
10420         (bfd *, asection *, arelent *, unsigned int,
10421          struct bfd_link_info *);
10422
10423       enum coff_symbol_classification (*_bfd_coff_classify_symbol)
10424         (bfd *, struct internal_syment *);
10425
10426       bfd_boolean (*_bfd_coff_compute_section_file_positions)
10427         (bfd *);
10428
10429       bfd_boolean (*_bfd_coff_start_final_link)
10430         (bfd *, struct bfd_link_info *);
10431
10432       bfd_boolean (*_bfd_coff_relocate_section)
10433         (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
10434          struct internal_reloc *, struct internal_syment *, asection **);
10435
10436       reloc_howto_type *(*_bfd_coff_rtype_to_howto)
10437         (bfd *, asection *, struct internal_reloc *,
10438          struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *);
10439
10440       bfd_boolean (*_bfd_coff_adjust_symndx)
10441         (bfd *, struct bfd_link_info *, bfd *, asection *,
10442          struct internal_reloc *, bfd_boolean *);
10443
10444       bfd_boolean (*_bfd_coff_link_add_one_symbol)
10445         (struct bfd_link_info *, bfd *, const char *, flagword,
10446          asection *, bfd_vma, const char *, bfd_boolean, bfd_boolean,
10447          struct bfd_link_hash_entry **);
10448
10449       bfd_boolean (*_bfd_coff_link_output_has_begun)
10450         (bfd *, struct coff_final_link_info *);
10451
10452       bfd_boolean (*_bfd_coff_final_link_postscript)
10453         (bfd *, struct coff_final_link_info *);
10454
10455       bfd_boolean (*_bfd_coff_print_pdata)
10456         (bfd *, void *);
10457
10458     } bfd_coff_backend_data;
10459
10460     #define coff_backend_info(abfd) \
10461       ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
10462
10463     #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
10464       ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
10465
10466     #define bfd_coff_swap_sym_in(a,e,i) \
10467       ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
10468
10469     #define bfd_coff_swap_lineno_in(a,e,i) \
10470       ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
10471
10472     #define bfd_coff_swap_reloc_out(abfd, i, o) \
10473       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
10474
10475     #define bfd_coff_swap_lineno_out(abfd, i, o) \
10476       ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
10477
10478     #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
10479       ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
10480
10481     #define bfd_coff_swap_sym_out(abfd, i,o) \
10482       ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
10483
10484     #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
10485       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
10486
10487     #define bfd_coff_swap_filehdr_out(abfd, i,o) \
10488       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
10489
10490     #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
10491       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
10492
10493     #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
10494     #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
10495     #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
10496     #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
10497     #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
10498     #define bfd_coff_relsz(abfd)  (coff_backend_info (abfd)->_bfd_relsz)
10499     #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
10500     #define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
10501     #define bfd_coff_long_filenames(abfd) \
10502       (coff_backend_info (abfd)->_bfd_coff_long_filenames)
10503     #define bfd_coff_long_section_names(abfd) \
10504       (coff_backend_info (abfd)->_bfd_coff_long_section_names)
10505     #define bfd_coff_set_long_section_names(abfd, enable) \
10506       ((coff_backend_info (abfd)->_bfd_coff_set_long_section_names) (abfd, enable))
10507     #define bfd_coff_default_section_alignment_power(abfd) \
10508       (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
10509     #define bfd_coff_max_nscns(abfd) \
10510       (coff_backend_info (abfd)->_bfd_coff_max_nscns)
10511
10512     #define bfd_coff_swap_filehdr_in(abfd, i,o) \
10513       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
10514
10515     #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
10516       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
10517
10518     #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
10519       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
10520
10521     #define bfd_coff_swap_reloc_in(abfd, i, o) \
10522       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
10523
10524     #define bfd_coff_bad_format_hook(abfd, filehdr) \
10525       ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
10526
10527     #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
10528       ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
10529     #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
10530       ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook)\
10531        (abfd, filehdr, aouthdr))
10532
10533     #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section, flags_ptr)\
10534       ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
10535        (abfd, scnhdr, name, section, flags_ptr))
10536
10537     #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
10538       ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
10539
10540     #define bfd_coff_slurp_symbol_table(abfd)\
10541       ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
10542
10543     #define bfd_coff_symname_in_debug(abfd, sym)\
10544       ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
10545
10546     #define bfd_coff_force_symnames_in_strings(abfd)\
10547       (coff_backend_info (abfd)->_bfd_coff_force_symnames_in_strings)
10548
10549     #define bfd_coff_debug_string_prefix_length(abfd)\
10550       (coff_backend_info (abfd)->_bfd_coff_debug_string_prefix_length)
10551
10552     #define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
10553       ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
10554        (abfd, file, base, symbol, aux, indaux))
10555
10556     #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order,\
10557                                          reloc, data, src_ptr, dst_ptr)\
10558       ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
10559        (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
10560
10561     #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
10562       ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
10563        (abfd, section, reloc, shrink, link_info))
10564
10565     #define bfd_coff_classify_symbol(abfd, sym)\
10566       ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
10567        (abfd, sym))
10568
10569     #define bfd_coff_compute_section_file_positions(abfd)\
10570       ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
10571        (abfd))
10572
10573     #define bfd_coff_start_final_link(obfd, info)\
10574       ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
10575        (obfd, info))
10576     #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
10577       ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
10578        (obfd, info, ibfd, o, con, rel, isyms, secs))
10579     #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
10580       ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
10581        (abfd, sec, rel, h, sym, addendp))
10582     #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
10583       ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
10584        (obfd, info, ibfd, sec, rel, adjustedp))
10585     #define bfd_coff_link_add_one_symbol(info, abfd, name, flags, section,\
10586                                          value, string, cp, coll, hashp)\
10587       ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
10588        (info, abfd, name, flags, section, value, string, cp, coll, hashp))
10589
10590     #define bfd_coff_link_output_has_begun(a,p) \
10591       ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a, p))
10592     #define bfd_coff_final_link_postscript(a,p) \
10593       ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a, p))
10594
10595     #define bfd_coff_have_print_pdata(a) \
10596       (coff_backend_info (a)->_bfd_coff_print_pdata)
10597     #define bfd_coff_print_pdata(a,p) \
10598       ((coff_backend_info (a)->_bfd_coff_print_pdata) (a, p))
10599
10600     /* Macro: Returns true if the bfd is a PE executable as opposed to a
10601        PE object file.  */
10602     #define bfd_pei_p(abfd) \
10603       (CONST_STRNEQ ((abfd)->xvec->name, "pei-"))
10604
106053.3.2.8 Writing relocations
10606...........................
10607
10608To write relocations, the back end steps though the canonical relocation
10609table and create an 'internal_reloc'.  The symbol index to use is
10610removed from the 'offset' field in the symbol table supplied.  The
10611address comes directly from the sum of the section base address and the
10612relocation offset; the type is dug directly from the howto field.  Then
10613the 'internal_reloc' is swapped into the shape of an 'external_reloc'
10614and written out to disk.
10615
106163.3.2.9 Reading linenumbers
10617...........................
10618
10619Creating the linenumber table is done by reading in the entire coff
10620linenumber table, and creating another table for internal use.
10621
10622   A coff linenumber table is structured so that each function is marked
10623as having a line number of 0.  Each line within the function is an
10624offset from the first line in the function.  The base of the line number
10625information for the table is stored in the symbol associated with the
10626function.
10627
10628   Note: The PE format uses line number 0 for a flag indicating a new
10629source file.
10630
10631   The information is copied from the external to the internal table,
10632and each symbol which marks a function is marked by pointing its...
10633
10634   How does this work ?
10635
106363.3.2.10 Reading relocations
10637............................
10638
10639Coff relocations are easily transformed into the internal BFD form
10640('arelent').
10641
10642   Reading a coff relocation table is done in the following stages:
10643
10644   * Read the entire coff relocation table into memory.
10645
10646   * Process each relocation in turn; first swap it from the external to
10647     the internal form.
10648
10649   * Turn the symbol referenced in the relocation's symbol index into a
10650     pointer into the canonical symbol table.  This table is the same as
10651     the one returned by a call to 'bfd_canonicalize_symtab'.  The back
10652     end will call that routine and save the result if a
10653     canonicalization hasn't been done.
10654
10655   * The reloc index is turned into a pointer to a howto structure, in a
10656     back end specific way.  For instance, the 386 and 960 use the
10657     'r_type' to directly produce an index into a howto table vector;
10658     the 88k subtracts a number from the 'r_type' field and creates an
10659     addend field.
10660
10661
10662File: bfd.info,  Node: elf,  Next: mmo,  Prev: coff,  Up: BFD back ends
10663
106643.4 ELF backends
10665================
10666
10667BFD support for ELF formats is being worked on.  Currently, the best
10668supported back ends are for sparc and i386 (running svr4 or Solaris 2).
10669
10670   Documentation of the internals of the support code still needs to be
10671written.  The code is changing quickly enough that we haven't bothered
10672yet.
10673
10674
10675File: bfd.info,  Node: mmo,  Prev: elf,  Up: BFD back ends
10676
106773.5 mmo backend
10678===============
10679
10680The mmo object format is used exclusively together with Professor Donald
10681E. Knuth's educational 64-bit processor MMIX. The simulator 'mmix' which
10682is available at <http://mmix.cs.hm.edu/src/index.html> understands this
10683format.  That package also includes a combined assembler and linker
10684called 'mmixal'.  The mmo format has no advantages feature-wise compared
10685to e.g.  ELF. It is a simple non-relocatable object format with no
10686support for archives or debugging information, except for symbol value
10687information and line numbers (which is not yet implemented in BFD). See
10688<http://mmix.cs.hm.edu/> for more information about MMIX. The ELF format
10689is used for intermediate object files in the BFD implementation.
10690
10691* Menu:
10692
10693* File layout::
10694* Symbol-table::
10695* mmo section mapping::
10696
10697
10698File: bfd.info,  Node: File layout,  Next: Symbol-table,  Prev: mmo,  Up: mmo
10699
107003.5.1 File layout
10701-----------------
10702
10703The mmo file contents is not partitioned into named sections as with
10704e.g. ELF. Memory areas is formed by specifying the location of the data
10705that follows.  Only the memory area '0x0000...00' to '0x01ff...ff' is
10706executable, so it is used for code (and constants) and the area
10707'0x2000...00' to '0x20ff...ff' is used for writable data.  *Note mmo
10708section mapping::.
10709
10710   There is provision for specifying "special data" of 65536 different
10711types.  We use type 80 (decimal), arbitrarily chosen the same as the ELF
10712'e_machine' number for MMIX, filling it with section information
10713normally found in ELF objects.  *Note mmo section mapping::.
10714
10715   Contents is entered as 32-bit words, xor:ed over previous contents,
10716always zero-initialized.  A word that starts with the byte '0x98' forms
10717a command called a 'lopcode', where the next byte distinguished between
10718the thirteen lopcodes.  The two remaining bytes, called the 'Y' and 'Z'
10719fields, or the 'YZ' field (a 16-bit big-endian number), are used for
10720various purposes different for each lopcode.  As documented in
10721<http://mmix.cs.hm.edu/doc/mmixal.pdf>, the lopcodes are:
10722
10723'lop_quote'
10724     0x98000001.  The next word is contents, regardless of whether it
10725     starts with 0x98 or not.
10726
10727'lop_loc'
10728     0x9801YYZZ, where 'Z' is 1 or 2.  This is a location directive,
10729     setting the location for the next data to the next 32-bit word (for
10730     Z = 1) or 64-bit word (for Z = 2), plus Y * 2^56.  Normally 'Y' is
10731     0 for the text segment and 2 for the data segment.  Beware that the
10732     low bits of non- tetrabyte-aligned values are silently discarded
10733     when being automatically incremented and when storing contents (in
10734     contrast to e.g.  its use as current location when followed by
10735     lop_fixo et al before the next possibly-quoted tetrabyte contents).
10736
10737'lop_skip'
10738     0x9802YYZZ. Increase the current location by 'YZ' bytes.
10739
10740'lop_fixo'
10741     0x9803YYZZ, where 'Z' is 1 or 2.  Store the current location as 64
10742     bits into the location pointed to by the next 32-bit (Z = 1) or
10743     64-bit (Z = 2) word, plus Y * 2^56.
10744
10745'lop_fixr'
10746     0x9804YYZZ. 'YZ' is stored into the current location plus 2 - 4 *
10747     YZ.
10748
10749'lop_fixrx'
10750     0x980500ZZ. 'Z' is 16 or 24.  A value 'L' derived from the
10751     following 32-bit word are used in a manner similar to 'YZ' in
10752     lop_fixr: it is xor:ed into the current location minus 4 * L. The
10753     first byte of the word is 0 or 1.  If it is 1, then L = (LOWEST 24
10754     BITS OF WORD) - 2^Z, if 0, then L = (LOWEST 24 BITS OF WORD).
10755
10756'lop_file'
10757     0x9806YYZZ. 'Y' is the file number, 'Z' is count of 32-bit words.
10758     Set the file number to 'Y' and the line counter to 0.  The next Z *
10759     4 bytes contain the file name, padded with zeros if the count is
10760     not a multiple of four.  The same 'Y' may occur multiple times, but
10761     'Z' must be 0 for all but the first occurrence.
10762
10763'lop_line'
10764     0x9807YYZZ. 'YZ' is the line number.  Together with lop_file, it
10765     forms the source location for the next 32-bit word.  Note that for
10766     each non-lopcode 32-bit word, line numbers are assumed incremented
10767     by one.
10768
10769'lop_spec'
10770     0x9808YYZZ. 'YZ' is the type number.  Data until the next lopcode
10771     other than lop_quote forms special data of type 'YZ'.  *Note mmo
10772     section mapping::.
10773
10774     Other types than 80, (or type 80 with a content that does not
10775     parse) is stored in sections named '.MMIX.spec_data.N' where N is
10776     the 'YZ'-type.  The flags for such a sections say not to allocate
10777     or load the data.  The vma is 0.  Contents of multiple occurrences
10778     of special data N is concatenated to the data of the previous
10779     lop_spec Ns.  The location in data or code at which the lop_spec
10780     occurred is lost.
10781
10782'lop_pre'
10783     0x980901ZZ. The first lopcode in a file.  The 'Z' field forms the
10784     length of header information in 32-bit words, where the first word
10785     tells the time in seconds since '00:00:00 GMT Jan 1 1970'.
10786
10787'lop_post'
10788     0x980a00ZZ. Z > 32.  This lopcode follows after all
10789     content-generating lopcodes in a program.  The 'Z' field denotes
10790     the value of 'rG' at the beginning of the program.  The following
10791     256 - Z big-endian 64-bit words are loaded into global registers
10792     '$G' ... '$255'.
10793
10794'lop_stab'
10795     0x980b0000.  The next-to-last lopcode in a program.  Must follow
10796     immediately after the lop_post lopcode and its data.  After this
10797     lopcode follows all symbols in a compressed format (*note
10798     Symbol-table::).
10799
10800'lop_end'
10801     0x980cYYZZ. The last lopcode in a program.  It must follow the
10802     lop_stab lopcode and its data.  The 'YZ' field contains the number
10803     of 32-bit words of symbol table information after the preceding
10804     lop_stab lopcode.
10805
10806   Note that the lopcode "fixups"; 'lop_fixr', 'lop_fixrx' and
10807'lop_fixo' are not generated by BFD, but are handled.  They are
10808generated by 'mmixal'.
10809
10810   This trivial one-label, one-instruction file:
10811
10812      :Main TRAP 1,2,3
10813
10814   can be represented this way in mmo:
10815
10816      0x98090101 - lop_pre, one 32-bit word with timestamp.
10817      <timestamp>
10818      0x98010002 - lop_loc, text segment, using a 64-bit address.
10819                   Note that mmixal does not emit this for the file above.
10820      0x00000000 - Address, high 32 bits.
10821      0x00000000 - Address, low 32 bits.
10822      0x98060002 - lop_file, 2 32-bit words for file-name.
10823      0x74657374 - "test"
10824      0x2e730000 - ".s\0\0"
10825      0x98070001 - lop_line, line 1.
10826      0x00010203 - TRAP 1,2,3
10827      0x980a00ff - lop_post, setting $255 to 0.
10828      0x00000000
10829      0x00000000
10830      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10831      0x203a4040   *Note Symbol-table::.
10832      0x10404020
10833      0x4d206120
10834      0x69016e00
10835      0x81000000
10836      0x980c0005 - lop_end; symbol table contained five 32-bit words.
10837
10838
10839File: bfd.info,  Node: Symbol-table,  Next: mmo section mapping,  Prev: File layout,  Up: mmo
10840
108413.5.2 Symbol table format
10842-------------------------
10843
10844From mmixal.w (or really, the generated mmixal.tex) in the MMIXware
10845package which also contains the 'mmix' simulator: "Symbols are stored
10846and retrieved by means of a 'ternary search trie', following ideas of
10847Bentley and Sedgewick.  (See ACM-SIAM Symp. on Discrete Algorithms '8'
10848(1997), 360-369; R.Sedgewick, 'Algorithms in C' (Reading, Mass.
10849Addison-Wesley, 1998), '15.4'.)  Each trie node stores a character, and
10850there are branches to subtries for the cases where a given character is
10851less than, equal to, or greater than the character in the trie.  There
10852also is a pointer to a symbol table entry if a symbol ends at the
10853current node."
10854
10855   So it's a tree encoded as a stream of bytes.  The stream of bytes
10856acts on a single virtual global symbol, adding and removing characters
10857and signalling complete symbol points.  Here, we read the stream and
10858create symbols at the completion points.
10859
10860   First, there's a control byte 'm'.  If any of the listed bits in 'm'
10861is nonzero, we execute what stands at the right, in the listed order:
10862
10863      (MMO3_LEFT)
10864      0x40 - Traverse left trie.
10865             (Read a new command byte and recurse.)
10866
10867      (MMO3_SYMBITS)
10868      0x2f - Read the next byte as a character and store it in the
10869             current character position; increment character position.
10870             Test the bits of m:
10871
10872             (MMO3_WCHAR)
10873             0x80 - The character is 16-bit (so read another byte,
10874                    merge into current character.
10875
10876             (MMO3_TYPEBITS)
10877             0xf  - We have a complete symbol; parse the type, value
10878                    and serial number and do what should be done
10879                    with a symbol.  The type and length information
10880                    is in j = (m & 0xf).
10881
10882                    (MMO3_REGQUAL_BITS)
10883                    j == 0xf: A register variable.  The following
10884                              byte tells which register.
10885                    j <= 8:   An absolute symbol.  Read j bytes as the
10886                              big-endian number the symbol equals.
10887                              A j = 2 with two zero bytes denotes an
10888                              unknown symbol.
10889                    j > 8:    As with j <= 8, but add (0x20 << 56)
10890                              to the value in the following j - 8
10891                              bytes.
10892
10893                    Then comes the serial number, as a variant of
10894                    uleb128, but better named ubeb128:
10895                    Read bytes and shift the previous value left 7
10896                    (multiply by 128).  Add in the new byte, repeat
10897                    until a byte has bit 7 set.  The serial number
10898                    is the computed value minus 128.
10899
10900             (MMO3_MIDDLE)
10901             0x20 - Traverse middle trie.  (Read a new command byte
10902                    and recurse.)  Decrement character position.
10903
10904      (MMO3_RIGHT)
10905      0x10 - Traverse right trie.  (Read a new command byte and
10906             recurse.)
10907
10908   Let's look again at the 'lop_stab' for the trivial file (*note File
10909layout::).
10910
10911      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10912      0x203a4040
10913      0x10404020
10914      0x4d206120
10915      0x69016e00
10916      0x81000000
10917
10918   This forms the trivial trie (note that the path between ":" and "M"
10919is redundant):
10920
10921      203a     ":"
10922      40       /
10923      40      /
10924      10      \
10925      40      /
10926      40     /
10927      204d  "M"
10928      2061  "a"
10929      2069  "i"
10930      016e  "n" is the last character in a full symbol, and
10931            with a value represented in one byte.
10932      00    The value is 0.
10933      81    The serial number is 1.
10934
10935
10936File: bfd.info,  Node: mmo section mapping,  Prev: Symbol-table,  Up: mmo
10937
109383.5.3 mmo section mapping
10939-------------------------
10940
10941The implementation in BFD uses special data type 80 (decimal) to
10942encapsulate and describe named sections, containing e.g. debug
10943information.  If needed, any datum in the encapsulation will be quoted
10944using lop_quote.  First comes a 32-bit word holding the number of 32-bit
10945words containing the zero-terminated zero-padded segment name.  After
10946the name there's a 32-bit word holding flags describing the section
10947type.  Then comes a 64-bit big-endian word with the section length (in
10948bytes), then another with the section start address.  Depending on the
10949type of section, the contents might follow, zero-padded to 32-bit
10950boundary.  For a loadable section (such as data or code), the contents
10951might follow at some later point, not necessarily immediately, as a
10952lop_loc with the same start address as in the section description,
10953followed by the contents.  This in effect forms a descriptor that must
10954be emitted before the actual contents.  Sections described this way must
10955not overlap.
10956
10957   For areas that don't have such descriptors, synthetic sections are
10958formed by BFD. Consecutive contents in the two memory areas
10959'0x0000...00' to '0x01ff...ff' and '0x2000...00' to '0x20ff...ff' are
10960entered in sections named '.text' and '.data' respectively.  If an area
10961is not otherwise described, but would together with a neighboring lower
10962area be less than '0x40000000' bytes long, it is joined with the lower
10963area and the gap is zero-filled.  For other cases, a new section is
10964formed, named '.MMIX.sec.N'.  Here, N is a number, a running count
10965through the mmo file, starting at 0.
10966
10967   A loadable section specified as:
10968
10969      .section secname,"ax"
10970      TETRA 1,2,3,4,-1,-2009
10971      BYTE 80
10972
10973   and linked to address '0x4', is represented by the sequence:
10974
10975      0x98080050 - lop_spec 80
10976      0x00000002 - two 32-bit words for the section name
10977      0x7365636e - "secn"
10978      0x616d6500 - "ame\0"
10979      0x00000033 - flags CODE, READONLY, LOAD, ALLOC
10980      0x00000000 - high 32 bits of section length
10981      0x0000001c - section length is 28 bytes; 6 * 4 + 1 + alignment to 32 bits
10982      0x00000000 - high 32 bits of section address
10983      0x00000004 - section address is 4
10984      0x98010002 - 64 bits with address of following data
10985      0x00000000 - high 32 bits of address
10986      0x00000004 - low 32 bits: data starts at address 4
10987      0x00000001 - 1
10988      0x00000002 - 2
10989      0x00000003 - 3
10990      0x00000004 - 4
10991      0xffffffff - -1
10992      0xfffff827 - -2009
10993      0x50000000 - 80 as a byte, padded with zeros.
10994
10995   Note that the lop_spec wrapping does not include the section
10996contents.  Compare this to a non-loaded section specified as:
10997
10998      .section thirdsec
10999      TETRA 200001,100002
11000      BYTE 38,40
11001
11002   This, when linked to address '0x200000000000001c', is represented by:
11003
11004      0x98080050 - lop_spec 80
11005      0x00000002 - two 32-bit words for the section name
11006      0x7365636e - "thir"
11007      0x616d6500 - "dsec"
11008      0x00000010 - flag READONLY
11009      0x00000000 - high 32 bits of section length
11010      0x0000000c - section length is 12 bytes; 2 * 4 + 2 + alignment to 32 bits
11011      0x20000000 - high 32 bits of address
11012      0x0000001c - low 32 bits of address 0x200000000000001c
11013      0x00030d41 - 200001
11014      0x000186a2 - 100002
11015      0x26280000 - 38, 40 as bytes, padded with zeros
11016
11017   For the latter example, the section contents must not be loaded in
11018memory, and is therefore specified as part of the special data.  The
11019address is usually unimportant but might provide information for e.g.
11020the DWARF 2 debugging format.
11021
11022
11023File: bfd.info,  Node: GNU Free Documentation License,  Next: BFD Index,  Prev: BFD back ends,  Up: Top
11024
11025                     Version 1.3, 3 November 2008
11026
11027     Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
11028     <http://fsf.org/>
11029
11030     Everyone is permitted to copy and distribute verbatim copies
11031     of this license document, but changing it is not allowed.
11032
11033  0. PREAMBLE
11034
11035     The purpose of this License is to make a manual, textbook, or other
11036     functional and useful document "free" in the sense of freedom: to
11037     assure everyone the effective freedom to copy and redistribute it,
11038     with or without modifying it, either commercially or
11039     noncommercially.  Secondarily, this License preserves for the
11040     author and publisher a way to get credit for their work, while not
11041     being considered responsible for modifications made by others.
11042
11043     This License is a kind of "copyleft", which means that derivative
11044     works of the document must themselves be free in the same sense.
11045     It complements the GNU General Public License, which is a copyleft
11046     license designed for free software.
11047
11048     We have designed this License in order to use it for manuals for
11049     free software, because free software needs free documentation: a
11050     free program should come with manuals providing the same freedoms
11051     that the software does.  But this License is not limited to
11052     software manuals; it can be used for any textual work, regardless
11053     of subject matter or whether it is published as a printed book.  We
11054     recommend this License principally for works whose purpose is
11055     instruction or reference.
11056
11057  1. APPLICABILITY AND DEFINITIONS
11058
11059     This License applies to any manual or other work, in any medium,
11060     that contains a notice placed by the copyright holder saying it can
11061     be distributed under the terms of this License.  Such a notice
11062     grants a world-wide, royalty-free license, unlimited in duration,
11063     to use that work under the conditions stated herein.  The
11064     "Document", below, refers to any such manual or work.  Any member
11065     of the public is a licensee, and is addressed as "you".  You accept
11066     the license if you copy, modify or distribute the work in a way
11067     requiring permission under copyright law.
11068
11069     A "Modified Version" of the Document means any work containing the
11070     Document or a portion of it, either copied verbatim, or with
11071     modifications and/or translated into another language.
11072
11073     A "Secondary Section" is a named appendix or a front-matter section
11074     of the Document that deals exclusively with the relationship of the
11075     publishers or authors of the Document to the Document's overall
11076     subject (or to related matters) and contains nothing that could
11077     fall directly within that overall subject.  (Thus, if the Document
11078     is in part a textbook of mathematics, a Secondary Section may not
11079     explain any mathematics.)  The relationship could be a matter of
11080     historical connection with the subject or with related matters, or
11081     of legal, commercial, philosophical, ethical or political position
11082     regarding them.
11083
11084     The "Invariant Sections" are certain Secondary Sections whose
11085     titles are designated, as being those of Invariant Sections, in the
11086     notice that says that the Document is released under this License.
11087     If a section does not fit the above definition of Secondary then it
11088     is not allowed to be designated as Invariant.  The Document may
11089     contain zero Invariant Sections.  If the Document does not identify
11090     any Invariant Sections then there are none.
11091
11092     The "Cover Texts" are certain short passages of text that are
11093     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
11094     that says that the Document is released under this License.  A
11095     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
11096     be at most 25 words.
11097
11098     A "Transparent" copy of the Document means a machine-readable copy,
11099     represented in a format whose specification is available to the
11100     general public, that is suitable for revising the document
11101     straightforwardly with generic text editors or (for images composed
11102     of pixels) generic paint programs or (for drawings) some widely
11103     available drawing editor, and that is suitable for input to text
11104     formatters or for automatic translation to a variety of formats
11105     suitable for input to text formatters.  A copy made in an otherwise
11106     Transparent file format whose markup, or absence of markup, has
11107     been arranged to thwart or discourage subsequent modification by
11108     readers is not Transparent.  An image format is not Transparent if
11109     used for any substantial amount of text.  A copy that is not
11110     "Transparent" is called "Opaque".
11111
11112     Examples of suitable formats for Transparent copies include plain
11113     ASCII without markup, Texinfo input format, LaTeX input format,
11114     SGML or XML using a publicly available DTD, and standard-conforming
11115     simple HTML, PostScript or PDF designed for human modification.
11116     Examples of transparent image formats include PNG, XCF and JPG.
11117     Opaque formats include proprietary formats that can be read and
11118     edited only by proprietary word processors, SGML or XML for which
11119     the DTD and/or processing tools are not generally available, and
11120     the machine-generated HTML, PostScript or PDF produced by some word
11121     processors for output purposes only.
11122
11123     The "Title Page" means, for a printed book, the title page itself,
11124     plus such following pages as are needed to hold, legibly, the
11125     material this License requires to appear in the title page.  For
11126     works in formats which do not have any title page as such, "Title
11127     Page" means the text near the most prominent appearance of the
11128     work's title, preceding the beginning of the body of the text.
11129
11130     The "publisher" means any person or entity that distributes copies
11131     of the Document to the public.
11132
11133     A section "Entitled XYZ" means a named subunit of the Document
11134     whose title either is precisely XYZ or contains XYZ in parentheses
11135     following text that translates XYZ in another language.  (Here XYZ
11136     stands for a specific section name mentioned below, such as
11137     "Acknowledgements", "Dedications", "Endorsements", or "History".)
11138     To "Preserve the Title" of such a section when you modify the
11139     Document means that it remains a section "Entitled XYZ" according
11140     to this definition.
11141
11142     The Document may include Warranty Disclaimers next to the notice
11143     which states that this License applies to the Document.  These
11144     Warranty Disclaimers are considered to be included by reference in
11145     this License, but only as regards disclaiming warranties: any other
11146     implication that these Warranty Disclaimers may have is void and
11147     has no effect on the meaning of this License.
11148
11149  2. VERBATIM COPYING
11150
11151     You may copy and distribute the Document in any medium, either
11152     commercially or noncommercially, provided that this License, the
11153     copyright notices, and the license notice saying this License
11154     applies to the Document are reproduced in all copies, and that you
11155     add no other conditions whatsoever to those of this License.  You
11156     may not use technical measures to obstruct or control the reading
11157     or further copying of the copies you make or distribute.  However,
11158     you may accept compensation in exchange for copies.  If you
11159     distribute a large enough number of copies you must also follow the
11160     conditions in section 3.
11161
11162     You may also lend copies, under the same conditions stated above,
11163     and you may publicly display copies.
11164
11165  3. COPYING IN QUANTITY
11166
11167     If you publish printed copies (or copies in media that commonly
11168     have printed covers) of the Document, numbering more than 100, and
11169     the Document's license notice requires Cover Texts, you must
11170     enclose the copies in covers that carry, clearly and legibly, all
11171     these Cover Texts: Front-Cover Texts on the front cover, and
11172     Back-Cover Texts on the back cover.  Both covers must also clearly
11173     and legibly identify you as the publisher of these copies.  The
11174     front cover must present the full title with all words of the title
11175     equally prominent and visible.  You may add other material on the
11176     covers in addition.  Copying with changes limited to the covers, as
11177     long as they preserve the title of the Document and satisfy these
11178     conditions, can be treated as verbatim copying in other respects.
11179
11180     If the required texts for either cover are too voluminous to fit
11181     legibly, you should put the first ones listed (as many as fit
11182     reasonably) on the actual cover, and continue the rest onto
11183     adjacent pages.
11184
11185     If you publish or distribute Opaque copies of the Document
11186     numbering more than 100, you must either include a machine-readable
11187     Transparent copy along with each Opaque copy, or state in or with
11188     each Opaque copy a computer-network location from which the general
11189     network-using public has access to download using public-standard
11190     network protocols a complete Transparent copy of the Document, free
11191     of added material.  If you use the latter option, you must take
11192     reasonably prudent steps, when you begin distribution of Opaque
11193     copies in quantity, to ensure that this Transparent copy will
11194     remain thus accessible at the stated location until at least one
11195     year after the last time you distribute an Opaque copy (directly or
11196     through your agents or retailers) of that edition to the public.
11197
11198     It is requested, but not required, that you contact the authors of
11199     the Document well before redistributing any large number of copies,
11200     to give them a chance to provide you with an updated version of the
11201     Document.
11202
11203  4. MODIFICATIONS
11204
11205     You may copy and distribute a Modified Version of the Document
11206     under the conditions of sections 2 and 3 above, provided that you
11207     release the Modified Version under precisely this License, with the
11208     Modified Version filling the role of the Document, thus licensing
11209     distribution and modification of the Modified Version to whoever
11210     possesses a copy of it.  In addition, you must do these things in
11211     the Modified Version:
11212
11213       A. Use in the Title Page (and on the covers, if any) a title
11214          distinct from that of the Document, and from those of previous
11215          versions (which should, if there were any, be listed in the
11216          History section of the Document).  You may use the same title
11217          as a previous version if the original publisher of that
11218          version gives permission.
11219
11220       B. List on the Title Page, as authors, one or more persons or
11221          entities responsible for authorship of the modifications in
11222          the Modified Version, together with at least five of the
11223          principal authors of the Document (all of its principal
11224          authors, if it has fewer than five), unless they release you
11225          from this requirement.
11226
11227       C. State on the Title page the name of the publisher of the
11228          Modified Version, as the publisher.
11229
11230       D. Preserve all the copyright notices of the Document.
11231
11232       E. Add an appropriate copyright notice for your modifications
11233          adjacent to the other copyright notices.
11234
11235       F. Include, immediately after the copyright notices, a license
11236          notice giving the public permission to use the Modified
11237          Version under the terms of this License, in the form shown in
11238          the Addendum below.
11239
11240       G. Preserve in that license notice the full lists of Invariant
11241          Sections and required Cover Texts given in the Document's
11242          license notice.
11243
11244       H. Include an unaltered copy of this License.
11245
11246       I. Preserve the section Entitled "History", Preserve its Title,
11247          and add to it an item stating at least the title, year, new
11248          authors, and publisher of the Modified Version as given on the
11249          Title Page.  If there is no section Entitled "History" in the
11250          Document, create one stating the title, year, authors, and
11251          publisher of the Document as given on its Title Page, then add
11252          an item describing the Modified Version as stated in the
11253          previous sentence.
11254
11255       J. Preserve the network location, if any, given in the Document
11256          for public access to a Transparent copy of the Document, and
11257          likewise the network locations given in the Document for
11258          previous versions it was based on.  These may be placed in the
11259          "History" section.  You may omit a network location for a work
11260          that was published at least four years before the Document
11261          itself, or if the original publisher of the version it refers
11262          to gives permission.
11263
11264       K. For any section Entitled "Acknowledgements" or "Dedications",
11265          Preserve the Title of the section, and preserve in the section
11266          all the substance and tone of each of the contributor
11267          acknowledgements and/or dedications given therein.
11268
11269       L. Preserve all the Invariant Sections of the Document, unaltered
11270          in their text and in their titles.  Section numbers or the
11271          equivalent are not considered part of the section titles.
11272
11273       M. Delete any section Entitled "Endorsements".  Such a section
11274          may not be included in the Modified Version.
11275
11276       N. Do not retitle any existing section to be Entitled
11277          "Endorsements" or to conflict in title with any Invariant
11278          Section.
11279
11280       O. Preserve any Warranty Disclaimers.
11281
11282     If the Modified Version includes new front-matter sections or
11283     appendices that qualify as Secondary Sections and contain no
11284     material copied from the Document, you may at your option designate
11285     some or all of these sections as invariant.  To do this, add their
11286     titles to the list of Invariant Sections in the Modified Version's
11287     license notice.  These titles must be distinct from any other
11288     section titles.
11289
11290     You may add a section Entitled "Endorsements", provided it contains
11291     nothing but endorsements of your Modified Version by various
11292     parties--for example, statements of peer review or that the text
11293     has been approved by an organization as the authoritative
11294     definition of a standard.
11295
11296     You may add a passage of up to five words as a Front-Cover Text,
11297     and a passage of up to 25 words as a Back-Cover Text, to the end of
11298     the list of Cover Texts in the Modified Version.  Only one passage
11299     of Front-Cover Text and one of Back-Cover Text may be added by (or
11300     through arrangements made by) any one entity.  If the Document
11301     already includes a cover text for the same cover, previously added
11302     by you or by arrangement made by the same entity you are acting on
11303     behalf of, you may not add another; but you may replace the old
11304     one, on explicit permission from the previous publisher that added
11305     the old one.
11306
11307     The author(s) and publisher(s) of the Document do not by this
11308     License give permission to use their names for publicity for or to
11309     assert or imply endorsement of any Modified Version.
11310
11311  5. COMBINING DOCUMENTS
11312
11313     You may combine the Document with other documents released under
11314     this License, under the terms defined in section 4 above for
11315     modified versions, provided that you include in the combination all
11316     of the Invariant Sections of all of the original documents,
11317     unmodified, and list them all as Invariant Sections of your
11318     combined work in its license notice, and that you preserve all
11319     their Warranty Disclaimers.
11320
11321     The combined work need only contain one copy of this License, and
11322     multiple identical Invariant Sections may be replaced with a single
11323     copy.  If there are multiple Invariant Sections with the same name
11324     but different contents, make the title of each such section unique
11325     by adding at the end of it, in parentheses, the name of the
11326     original author or publisher of that section if known, or else a
11327     unique number.  Make the same adjustment to the section titles in
11328     the list of Invariant Sections in the license notice of the
11329     combined work.
11330
11331     In the combination, you must combine any sections Entitled
11332     "History" in the various original documents, forming one section
11333     Entitled "History"; likewise combine any sections Entitled
11334     "Acknowledgements", and any sections Entitled "Dedications".  You
11335     must delete all sections Entitled "Endorsements."
11336
11337  6. COLLECTIONS OF DOCUMENTS
11338
11339     You may make a collection consisting of the Document and other
11340     documents released under this License, and replace the individual
11341     copies of this License in the various documents with a single copy
11342     that is included in the collection, provided that you follow the
11343     rules of this License for verbatim copying of each of the documents
11344     in all other respects.
11345
11346     You may extract a single document from such a collection, and
11347     distribute it individually under this License, provided you insert
11348     a copy of this License into the extracted document, and follow this
11349     License in all other respects regarding verbatim copying of that
11350     document.
11351
11352  7. AGGREGATION WITH INDEPENDENT WORKS
11353
11354     A compilation of the Document or its derivatives with other
11355     separate and independent documents or works, in or on a volume of a
11356     storage or distribution medium, is called an "aggregate" if the
11357     copyright resulting from the compilation is not used to limit the
11358     legal rights of the compilation's users beyond what the individual
11359     works permit.  When the Document is included in an aggregate, this
11360     License does not apply to the other works in the aggregate which
11361     are not themselves derivative works of the Document.
11362
11363     If the Cover Text requirement of section 3 is applicable to these
11364     copies of the Document, then if the Document is less than one half
11365     of the entire aggregate, the Document's Cover Texts may be placed
11366     on covers that bracket the Document within the aggregate, or the
11367     electronic equivalent of covers if the Document is in electronic
11368     form.  Otherwise they must appear on printed covers that bracket
11369     the whole aggregate.
11370
11371  8. TRANSLATION
11372
11373     Translation is considered a kind of modification, so you may
11374     distribute translations of the Document under the terms of section
11375     4.  Replacing Invariant Sections with translations requires special
11376     permission from their copyright holders, but you may include
11377     translations of some or all Invariant Sections in addition to the
11378     original versions of these Invariant Sections.  You may include a
11379     translation of this License, and all the license notices in the
11380     Document, and any Warranty Disclaimers, provided that you also
11381     include the original English version of this License and the
11382     original versions of those notices and disclaimers.  In case of a
11383     disagreement between the translation and the original version of
11384     this License or a notice or disclaimer, the original version will
11385     prevail.
11386
11387     If a section in the Document is Entitled "Acknowledgements",
11388     "Dedications", or "History", the requirement (section 4) to
11389     Preserve its Title (section 1) will typically require changing the
11390     actual title.
11391
11392  9. TERMINATION
11393
11394     You may not copy, modify, sublicense, or distribute the Document
11395     except as expressly provided under this License.  Any attempt
11396     otherwise to copy, modify, sublicense, or distribute it is void,
11397     and will automatically terminate your rights under this License.
11398
11399     However, if you cease all violation of this License, then your
11400     license from a particular copyright holder is reinstated (a)
11401     provisionally, unless and until the copyright holder explicitly and
11402     finally terminates your license, and (b) permanently, if the
11403     copyright holder fails to notify you of the violation by some
11404     reasonable means prior to 60 days after the cessation.
11405
11406     Moreover, your license from a particular copyright holder is
11407     reinstated permanently if the copyright holder notifies you of the
11408     violation by some reasonable means, this is the first time you have
11409     received notice of violation of this License (for any work) from
11410     that copyright holder, and you cure the violation prior to 30 days
11411     after your receipt of the notice.
11412
11413     Termination of your rights under this section does not terminate
11414     the licenses of parties who have received copies or rights from you
11415     under this License.  If your rights have been terminated and not
11416     permanently reinstated, receipt of a copy of some or all of the
11417     same material does not give you any rights to use it.
11418
11419  10. FUTURE REVISIONS OF THIS LICENSE
11420
11421     The Free Software Foundation may publish new, revised versions of
11422     the GNU Free Documentation License from time to time.  Such new
11423     versions will be similar in spirit to the present version, but may
11424     differ in detail to address new problems or concerns.  See
11425     <http://www.gnu.org/copyleft/>.
11426
11427     Each version of the License is given a distinguishing version
11428     number.  If the Document specifies that a particular numbered
11429     version of this License "or any later version" applies to it, you
11430     have the option of following the terms and conditions either of
11431     that specified version or of any later version that has been
11432     published (not as a draft) by the Free Software Foundation.  If the
11433     Document does not specify a version number of this License, you may
11434     choose any version ever published (not as a draft) by the Free
11435     Software Foundation.  If the Document specifies that a proxy can
11436     decide which future versions of this License can be used, that
11437     proxy's public statement of acceptance of a version permanently
11438     authorizes you to choose that version for the Document.
11439
11440  11. RELICENSING
11441
11442     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
11443     World Wide Web server that publishes copyrightable works and also
11444     provides prominent facilities for anybody to edit those works.  A
11445     public wiki that anybody can edit is an example of such a server.
11446     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
11447     site means any set of copyrightable works thus published on the MMC
11448     site.
11449
11450     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
11451     license published by Creative Commons Corporation, a not-for-profit
11452     corporation with a principal place of business in San Francisco,
11453     California, as well as future copyleft versions of that license
11454     published by that same organization.
11455
11456     "Incorporate" means to publish or republish a Document, in whole or
11457     in part, as part of another Document.
11458
11459     An MMC is "eligible for relicensing" if it is licensed under this
11460     License, and if all works that were first published under this
11461     License somewhere other than this MMC, and subsequently
11462     incorporated in whole or in part into the MMC, (1) had no cover
11463     texts or invariant sections, and (2) were thus incorporated prior
11464     to November 1, 2008.
11465
11466     The operator of an MMC Site may republish an MMC contained in the
11467     site under CC-BY-SA on the same site at any time before August 1,
11468     2009, provided the MMC is eligible for relicensing.
11469
11470ADDENDUM: How to use this License for your documents
11471====================================================
11472
11473To use this License in a document you have written, include a copy of
11474the License in the document and put the following copyright and license
11475notices just after the title page:
11476
11477       Copyright (C)  YEAR  YOUR NAME.
11478       Permission is granted to copy, distribute and/or modify this document
11479       under the terms of the GNU Free Documentation License, Version 1.3
11480       or any later version published by the Free Software Foundation;
11481       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
11482       Texts.  A copy of the license is included in the section entitled ``GNU
11483       Free Documentation License''.
11484
11485   If you have Invariant Sections, Front-Cover Texts and Back-Cover
11486Texts, replace the "with...Texts."  line with this:
11487
11488         with the Invariant Sections being LIST THEIR TITLES, with
11489         the Front-Cover Texts being LIST, and with the Back-Cover Texts
11490         being LIST.
11491
11492   If you have Invariant Sections without Cover Texts, or some other
11493combination of the three, merge those two alternatives to suit the
11494situation.
11495
11496   If your document contains nontrivial examples of program code, we
11497recommend releasing these examples in parallel under your choice of free
11498software license, such as the GNU General Public License, to permit
11499their use in free software.
11500
11501
11502File: bfd.info,  Node: BFD Index,  Prev: GNU Free Documentation License,  Up: Top
11503
11504BFD Index
11505*********
11506
11507[index]
11508* Menu:
11509
11510* _bfd_final_link_relocate:              Relocating the section contents.
11511                                                             (line   22)
11512* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
11513                                                             (line   15)
11514* _bfd_generic_link_add_one_symbol:      Adding symbols from an object file.
11515                                                             (line   19)
11516* _bfd_generic_link_check_relocs:        Writing the symbol table.
11517                                                             (line  130)
11518* _bfd_generic_make_empty_symbol:        symbol handling functions.
11519                                                             (line   96)
11520* _bfd_generic_set_reloc:                howto manager.      (line 3348)
11521* _bfd_generic_verify_endian_match:      Writing the symbol table.
11522                                                             (line  158)
11523* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
11524                                                             (line    6)
11525* _bfd_link_final_link in target vector: Performing the Final Link.
11526                                                             (line    6)
11527* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
11528                                                             (line    6)
11529* _bfd_relocate_contents:                Relocating the section contents.
11530                                                             (line   22)
11531* _bfd_unrecognized_reloc:               howto manager.      (line 3360)
11532* aout_SIZE_machine_type:                aout.               (line  145)
11533* aout_SIZE_mkobject:                    aout.               (line  137)
11534* aout_SIZE_new_section_hook:            aout.               (line  175)
11535* aout_SIZE_set_arch_mach:               aout.               (line  162)
11536* aout_SIZE_some_aout_object_p:          aout.               (line  123)
11537* aout_SIZE_swap_exec_header_in:         aout.               (line   99)
11538* aout_SIZE_swap_exec_header_out:        aout.               (line  111)
11539* arelent_chain:                         typedef arelent.    (line  341)
11540* BFD:                                   Overview.           (line    6)
11541* BFD canonical format:                  Canonical format.   (line   11)
11542* bfd_alloc:                             Opening and Closing.
11543                                                             (line  239)
11544* bfd_alloc2:                            Opening and Closing.
11545                                                             (line  248)
11546* bfd_alt_mach_code:                     Miscellaneous.      (line  288)
11547* bfd_arch_bits_per_address:             Architectures.      (line  639)
11548* bfd_arch_bits_per_byte:                Architectures.      (line  631)
11549* bfd_arch_default_fill:                 Architectures.      (line  720)
11550* bfd_arch_get_compatible:               Architectures.      (line  574)
11551* bfd_arch_list:                         Architectures.      (line  565)
11552* bfd_arch_mach_octets_per_byte:         Architectures.      (line  708)
11553* BFD_ARELOC_BFIN_ADD:                   howto manager.      (line 1096)
11554* BFD_ARELOC_BFIN_ADDR:                  howto manager.      (line 1130)
11555* BFD_ARELOC_BFIN_AND:                   howto manager.      (line 1110)
11556* BFD_ARELOC_BFIN_COMP:                  howto manager.      (line 1124)
11557* BFD_ARELOC_BFIN_CONST:                 howto manager.      (line 1094)
11558* BFD_ARELOC_BFIN_DIV:                   howto manager.      (line 1102)
11559* BFD_ARELOC_BFIN_HWPAGE:                howto manager.      (line 1128)
11560* BFD_ARELOC_BFIN_LAND:                  howto manager.      (line 1116)
11561* BFD_ARELOC_BFIN_LEN:                   howto manager.      (line 1120)
11562* BFD_ARELOC_BFIN_LOR:                   howto manager.      (line 1118)
11563* BFD_ARELOC_BFIN_LSHIFT:                howto manager.      (line 1106)
11564* BFD_ARELOC_BFIN_MOD:                   howto manager.      (line 1104)
11565* BFD_ARELOC_BFIN_MULT:                  howto manager.      (line 1100)
11566* BFD_ARELOC_BFIN_NEG:                   howto manager.      (line 1122)
11567* BFD_ARELOC_BFIN_OR:                    howto manager.      (line 1112)
11568* BFD_ARELOC_BFIN_PAGE:                  howto manager.      (line 1126)
11569* BFD_ARELOC_BFIN_PUSH:                  howto manager.      (line 1092)
11570* BFD_ARELOC_BFIN_RSHIFT:                howto manager.      (line 1108)
11571* BFD_ARELOC_BFIN_SUB:                   howto manager.      (line 1098)
11572* BFD_ARELOC_BFIN_XOR:                   howto manager.      (line 1114)
11573* bfd_cache_close:                       File Caching.       (line   25)
11574* bfd_cache_close_all:                   File Caching.       (line   38)
11575* bfd_cache_init:                        File Caching.       (line   17)
11576* bfd_calc_gnu_debuglink_crc32:          Opening and Closing.
11577                                                             (line  275)
11578* bfd_canonicalize_reloc:                Miscellaneous.      (line   18)
11579* bfd_canonicalize_symtab:               symbol handling functions.
11580                                                             (line   52)
11581* bfd_check_compression_header:          Miscellaneous.      (line  360)
11582* bfd_check_format:                      Formats.            (line   20)
11583* bfd_check_format_matches:              Formats.            (line   51)
11584* bfd_check_overflow:                    typedef arelent.    (line  354)
11585* bfd_close:                             Opening and Closing.
11586                                                             (line  161)
11587* bfd_close_all_done:                    Opening and Closing.
11588                                                             (line  179)
11589* bfd_coff_backend_data:                 coff.               (line  307)
11590* bfd_convert_section_contents:          Miscellaneous.      (line  396)
11591* bfd_convert_section_size:              Miscellaneous.      (line  386)
11592* bfd_copy_private_bfd_data:             Miscellaneous.      (line  159)
11593* bfd_copy_private_header_data:          Miscellaneous.      (line  142)
11594* bfd_copy_private_section_data:         section prototypes. (line  287)
11595* bfd_copy_private_symbol_data:          symbol handling functions.
11596                                                             (line  145)
11597* bfd_core_file_failing_command:         Core Files.         (line   11)
11598* bfd_core_file_failing_signal:          Core Files.         (line   20)
11599* bfd_core_file_pid:                     Core Files.         (line   29)
11600* bfd_create:                            Opening and Closing.
11601                                                             (line  198)
11602* bfd_create_gnu_debuglink_section:      Opening and Closing.
11603                                                             (line  431)
11604* bfd_decode_symclass:                   symbol handling functions.
11605                                                             (line  116)
11606* bfd_default_arch_struct:               Architectures.      (line  586)
11607* bfd_default_compatible:                Architectures.      (line  648)
11608* bfd_default_reloc_type_lookup:         howto manager.      (line 3272)
11609* bfd_default_scan:                      Architectures.      (line  657)
11610* bfd_default_set_arch_mach:             Architectures.      (line  604)
11611* bfd_demangle:                          Miscellaneous.      (line  339)
11612* bfd_emul_get_commonpagesize:           Miscellaneous.      (line  319)
11613* bfd_emul_get_maxpagesize:              Miscellaneous.      (line  299)
11614* bfd_emul_set_commonpagesize:           Miscellaneous.      (line  330)
11615* bfd_emul_set_maxpagesize:              Miscellaneous.      (line  310)
11616* bfd_errmsg:                            Error reporting.    (line   78)
11617* bfd_fdopenr:                           Opening and Closing.
11618                                                             (line   56)
11619* bfd_fill_in_gnu_debuglink_section:     Opening and Closing.
11620                                                             (line  445)
11621* bfd_find_target:                       bfd_target.         (line  493)
11622* bfd_find_version_for_sym:              Writing the symbol table.
11623                                                             (line   97)
11624* bfd_flavour_name:                      bfd_target.         (line  556)
11625* bfd_follow_build_id_debuglink:         Opening and Closing.
11626                                                             (line  505)
11627* bfd_follow_gnu_debugaltlink:           Opening and Closing.
11628                                                             (line  411)
11629* bfd_follow_gnu_debuglink:              Opening and Closing.
11630                                                             (line  390)
11631* bfd_fopen:                             Opening and Closing.
11632                                                             (line   11)
11633* bfd_format_string:                     Formats.            (line   78)
11634* bfd_generic_define_common_symbol:      Writing the symbol table.
11635                                                             (line   69)
11636* bfd_generic_define_start_stop:         Writing the symbol table.
11637                                                             (line   83)
11638* bfd_generic_discard_group:             section prototypes. (line  312)
11639* bfd_generic_gc_sections:               howto manager.      (line 3303)
11640* bfd_generic_get_relocated_section_contents: howto manager. (line 3333)
11641* bfd_generic_is_group_section:          section prototypes. (line  304)
11642* bfd_generic_lookup_section_flags:      howto manager.      (line 3313)
11643* bfd_generic_merge_sections:            howto manager.      (line 3323)
11644* bfd_generic_relax_section:             howto manager.      (line 3290)
11645* bfd_get_alt_debug_link_info:           Opening and Closing.
11646                                                             (line  329)
11647* bfd_get_arch:                          Architectures.      (line  615)
11648* bfd_get_arch_info:                     Architectures.      (line  667)
11649* bfd_get_arch_size:                     Miscellaneous.      (line   63)
11650* bfd_get_compression_header_size:       Miscellaneous.      (line  375)
11651* bfd_get_debug_link_info:               Opening and Closing.
11652                                                             (line  311)
11653* bfd_get_debug_link_info_1:             Opening and Closing.
11654                                                             (line  289)
11655* bfd_get_error:                         Error reporting.    (line   48)
11656* bfd_get_file_size:                     Miscellaneous.      (line  485)
11657* bfd_get_gp_size:                       Miscellaneous.      (line  106)
11658* bfd_get_linker_section:                section prototypes. (line   37)
11659* bfd_get_mach:                          Architectures.      (line  623)
11660* bfd_get_mtime:                         Miscellaneous.      (line  448)
11661* bfd_get_next_mapent:                   Archives.           (line   57)
11662* bfd_get_next_section_by_name:          section prototypes. (line   25)
11663* bfd_get_next_section_id:               section prototypes. (line  154)
11664* bfd_get_reloc_code_name:               howto manager.      (line 3281)
11665* bfd_get_reloc_size:                    typedef arelent.    (line  332)
11666* bfd_get_reloc_upper_bound:             Miscellaneous.      (line    8)
11667* bfd_get_section_by_name:               section prototypes. (line   16)
11668* bfd_get_section_by_name_if:            section prototypes. (line   46)
11669* bfd_get_section_contents:              section prototypes. (line  260)
11670* bfd_get_sign_extend_vma:               Miscellaneous.      (line   78)
11671* bfd_get_size:                          Miscellaneous.      (line  457)
11672* bfd_get_size <1>:                      Internal.           (line   24)
11673* bfd_get_symtab_upper_bound:            symbol handling functions.
11674                                                             (line    5)
11675* bfd_get_target_info:                   bfd_target.         (line  509)
11676* bfd_get_unique_section_name:           section prototypes. (line   65)
11677* bfd_hash_allocate:                     Creating and Freeing a Hash Table.
11678                                                             (line   17)
11679* bfd_hash_lookup:                       Looking Up or Entering a String.
11680                                                             (line    6)
11681* bfd_hash_newfunc:                      Creating and Freeing a Hash Table.
11682                                                             (line   12)
11683* bfd_hash_set_default_size:             Creating and Freeing a Hash Table.
11684                                                             (line   25)
11685* bfd_hash_table_free:                   Creating and Freeing a Hash Table.
11686                                                             (line   21)
11687* bfd_hash_table_init:                   Creating and Freeing a Hash Table.
11688                                                             (line    6)
11689* bfd_hash_table_init_n:                 Creating and Freeing a Hash Table.
11690                                                             (line    6)
11691* bfd_hash_traverse:                     Traversing a Hash Table.
11692                                                             (line    6)
11693* bfd_hide_sym_by_version:               Writing the symbol table.
11694                                                             (line  109)
11695* bfd_h_put_size:                        Internal.           (line   97)
11696* bfd_init:                              Initialization.     (line   10)
11697* bfd_install_relocation:                typedef arelent.    (line  408)
11698* bfd_is_local_label:                    symbol handling functions.
11699                                                             (line   17)
11700* bfd_is_local_label_name:               symbol handling functions.
11701                                                             (line   26)
11702* bfd_is_target_special_symbol:          symbol handling functions.
11703                                                             (line   39)
11704* bfd_is_undefined_symclass:             symbol handling functions.
11705                                                             (line  125)
11706* bfd_iterate_over_targets:              bfd_target.         (line  544)
11707* bfd_link_check_relocs:                 Writing the symbol table.
11708                                                             (line  119)
11709* bfd_link_split_section:                Writing the symbol table.
11710                                                             (line   43)
11711* bfd_log2:                              Internal.           (line  166)
11712* bfd_lookup_arch:                       Architectures.      (line  675)
11713* bfd_make_debug_symbol:                 symbol handling functions.
11714                                                             (line  106)
11715* bfd_make_empty_symbol:                 symbol handling functions.
11716                                                             (line   81)
11717* bfd_make_readable:                     Opening and Closing.
11718                                                             (line  225)
11719* bfd_make_section:                      section prototypes. (line  143)
11720* bfd_make_section_anyway:               section prototypes. (line  115)
11721* bfd_make_section_anyway_with_flags:    section prototypes. (line   97)
11722* bfd_make_section_old_way:              section prototypes. (line   77)
11723* bfd_make_section_with_flags:           section prototypes. (line  131)
11724* bfd_make_writable:                     Opening and Closing.
11725                                                             (line  211)
11726* bfd_malloc_and_get_section:            section prototypes. (line  277)
11727* bfd_map_over_sections:                 section prototypes. (line  186)
11728* bfd_merge_private_bfd_data:            Writing the symbol table.
11729                                                             (line  141)
11730* bfd_mmap:                              Miscellaneous.      (line  494)
11731* bfd_octets_per_byte:                   Architectures.      (line  698)
11732* bfd_openr:                             Opening and Closing.
11733                                                             (line   37)
11734* bfd_openr_iovec:                       Opening and Closing.
11735                                                             (line   95)
11736* bfd_openr_next_archived_file:          Archives.           (line   83)
11737* bfd_openstreamr:                       Opening and Closing.
11738                                                             (line   82)
11739* bfd_openw:                             Opening and Closing.
11740                                                             (line  146)
11741* bfd_open_file:                         File Caching.       (line   51)
11742* bfd_perform_relocation:                typedef arelent.    (line  383)
11743* bfd_perror:                            Error reporting.    (line   87)
11744* bfd_printable_arch_mach:               Architectures.      (line  686)
11745* bfd_printable_name:                    Architectures.      (line  546)
11746* bfd_print_symbol_vandf:                symbol handling functions.
11747                                                             (line   73)
11748* bfd_put_size:                          Internal.           (line   21)
11749* BFD_RELOC_12_PCREL:                    howto manager.      (line   37)
11750* BFD_RELOC_14:                          howto manager.      (line   30)
11751* BFD_RELOC_16:                          howto manager.      (line   29)
11752* BFD_RELOC_16C_ABS20:                   howto manager.      (line 2221)
11753* BFD_RELOC_16C_ABS20_C:                 howto manager.      (line 2222)
11754* BFD_RELOC_16C_ABS24:                   howto manager.      (line 2223)
11755* BFD_RELOC_16C_ABS24_C:                 howto manager.      (line 2224)
11756* BFD_RELOC_16C_DISP04:                  howto manager.      (line 2201)
11757* BFD_RELOC_16C_DISP04_C:                howto manager.      (line 2202)
11758* BFD_RELOC_16C_DISP08:                  howto manager.      (line 2203)
11759* BFD_RELOC_16C_DISP08_C:                howto manager.      (line 2204)
11760* BFD_RELOC_16C_DISP16:                  howto manager.      (line 2205)
11761* BFD_RELOC_16C_DISP16_C:                howto manager.      (line 2206)
11762* BFD_RELOC_16C_DISP24:                  howto manager.      (line 2207)
11763* BFD_RELOC_16C_DISP24a:                 howto manager.      (line 2209)
11764* BFD_RELOC_16C_DISP24a_C:               howto manager.      (line 2210)
11765* BFD_RELOC_16C_DISP24_C:                howto manager.      (line 2208)
11766* BFD_RELOC_16C_IMM04:                   howto manager.      (line 2225)
11767* BFD_RELOC_16C_IMM04_C:                 howto manager.      (line 2226)
11768* BFD_RELOC_16C_IMM16:                   howto manager.      (line 2227)
11769* BFD_RELOC_16C_IMM16_C:                 howto manager.      (line 2228)
11770* BFD_RELOC_16C_IMM20:                   howto manager.      (line 2229)
11771* BFD_RELOC_16C_IMM20_C:                 howto manager.      (line 2230)
11772* BFD_RELOC_16C_IMM24:                   howto manager.      (line 2231)
11773* BFD_RELOC_16C_IMM24_C:                 howto manager.      (line 2232)
11774* BFD_RELOC_16C_IMM32:                   howto manager.      (line 2233)
11775* BFD_RELOC_16C_IMM32_C:                 howto manager.      (line 2234)
11776* BFD_RELOC_16C_NUM08:                   howto manager.      (line 2195)
11777* BFD_RELOC_16C_NUM08_C:                 howto manager.      (line 2196)
11778* BFD_RELOC_16C_NUM16:                   howto manager.      (line 2197)
11779* BFD_RELOC_16C_NUM16_C:                 howto manager.      (line 2198)
11780* BFD_RELOC_16C_NUM32:                   howto manager.      (line 2199)
11781* BFD_RELOC_16C_NUM32_C:                 howto manager.      (line 2200)
11782* BFD_RELOC_16C_REG04:                   howto manager.      (line 2211)
11783* BFD_RELOC_16C_REG04a:                  howto manager.      (line 2213)
11784* BFD_RELOC_16C_REG04a_C:                howto manager.      (line 2214)
11785* BFD_RELOC_16C_REG04_C:                 howto manager.      (line 2212)
11786* BFD_RELOC_16C_REG14:                   howto manager.      (line 2215)
11787* BFD_RELOC_16C_REG14_C:                 howto manager.      (line 2216)
11788* BFD_RELOC_16C_REG16:                   howto manager.      (line 2217)
11789* BFD_RELOC_16C_REG16_C:                 howto manager.      (line 2218)
11790* BFD_RELOC_16C_REG20:                   howto manager.      (line 2219)
11791* BFD_RELOC_16C_REG20_C:                 howto manager.      (line 2220)
11792* BFD_RELOC_16_BASEREL:                  howto manager.      (line   92)
11793* BFD_RELOC_16_GOTOFF:                   howto manager.      (line   51)
11794* BFD_RELOC_16_GOT_PCREL:                howto manager.      (line   48)
11795* BFD_RELOC_16_PCREL:                    howto manager.      (line   36)
11796* BFD_RELOC_16_PCREL_S2:                 howto manager.      (line  102)
11797* BFD_RELOC_16_PLTOFF:                   howto manager.      (line   63)
11798* BFD_RELOC_16_PLT_PCREL:                howto manager.      (line   59)
11799* BFD_RELOC_23_PCREL_S2:                 howto manager.      (line  103)
11800* BFD_RELOC_24:                          howto manager.      (line   28)
11801* BFD_RELOC_24_PCREL:                    howto manager.      (line   35)
11802* BFD_RELOC_24_PLT_PCREL:                howto manager.      (line   58)
11803* BFD_RELOC_26:                          howto manager.      (line   27)
11804* BFD_RELOC_32:                          howto manager.      (line   26)
11805* BFD_RELOC_32_BASEREL:                  howto manager.      (line   91)
11806* BFD_RELOC_32_GOTOFF:                   howto manager.      (line   50)
11807* BFD_RELOC_32_GOT_PCREL:                howto manager.      (line   47)
11808* BFD_RELOC_32_PCREL:                    howto manager.      (line   34)
11809* BFD_RELOC_32_PCREL_S2:                 howto manager.      (line  101)
11810* BFD_RELOC_32_PLTOFF:                   howto manager.      (line   62)
11811* BFD_RELOC_32_PLT_PCREL:                howto manager.      (line   57)
11812* BFD_RELOC_32_SECREL:                   howto manager.      (line   45)
11813* BFD_RELOC_386_COPY:                    howto manager.      (line  527)
11814* BFD_RELOC_386_GLOB_DAT:                howto manager.      (line  528)
11815* BFD_RELOC_386_GOT32:                   howto manager.      (line  525)
11816* BFD_RELOC_386_GOT32X:                  howto manager.      (line  549)
11817* BFD_RELOC_386_GOTOFF:                  howto manager.      (line  531)
11818* BFD_RELOC_386_GOTPC:                   howto manager.      (line  532)
11819* BFD_RELOC_386_IRELATIVE:               howto manager.      (line  548)
11820* BFD_RELOC_386_JUMP_SLOT:               howto manager.      (line  529)
11821* BFD_RELOC_386_PLT32:                   howto manager.      (line  526)
11822* BFD_RELOC_386_RELATIVE:                howto manager.      (line  530)
11823* BFD_RELOC_386_TLS_DESC:                howto manager.      (line  547)
11824* BFD_RELOC_386_TLS_DESC_CALL:           howto manager.      (line  546)
11825* BFD_RELOC_386_TLS_DTPMOD32:            howto manager.      (line  542)
11826* BFD_RELOC_386_TLS_DTPOFF32:            howto manager.      (line  543)
11827* BFD_RELOC_386_TLS_GD:                  howto manager.      (line  537)
11828* BFD_RELOC_386_TLS_GOTDESC:             howto manager.      (line  545)
11829* BFD_RELOC_386_TLS_GOTIE:               howto manager.      (line  535)
11830* BFD_RELOC_386_TLS_IE:                  howto manager.      (line  534)
11831* BFD_RELOC_386_TLS_IE_32:               howto manager.      (line  540)
11832* BFD_RELOC_386_TLS_LDM:                 howto manager.      (line  538)
11833* BFD_RELOC_386_TLS_LDO_32:              howto manager.      (line  539)
11834* BFD_RELOC_386_TLS_LE:                  howto manager.      (line  536)
11835* BFD_RELOC_386_TLS_LE_32:               howto manager.      (line  541)
11836* BFD_RELOC_386_TLS_TPOFF:               howto manager.      (line  533)
11837* BFD_RELOC_386_TLS_TPOFF32:             howto manager.      (line  544)
11838* BFD_RELOC_390_12:                      howto manager.      (line 1885)
11839* BFD_RELOC_390_20:                      howto manager.      (line 1966)
11840* BFD_RELOC_390_COPY:                    howto manager.      (line 1891)
11841* BFD_RELOC_390_GLOB_DAT:                howto manager.      (line 1893)
11842* BFD_RELOC_390_GOT12:                   howto manager.      (line 1887)
11843* BFD_RELOC_390_GOT16:                   howto manager.      (line 1901)
11844* BFD_RELOC_390_GOT20:                   howto manager.      (line 1967)
11845* BFD_RELOC_390_GOT64:                   howto manager.      (line 1921)
11846* BFD_RELOC_390_GOTENT:                  howto manager.      (line 1925)
11847* BFD_RELOC_390_GOTOFF64:                howto manager.      (line 1927)
11848* BFD_RELOC_390_GOTPC:                   howto manager.      (line 1899)
11849* BFD_RELOC_390_GOTPCDBL:                howto manager.      (line 1919)
11850* BFD_RELOC_390_GOTPLT12:                howto manager.      (line 1929)
11851* BFD_RELOC_390_GOTPLT16:                howto manager.      (line 1931)
11852* BFD_RELOC_390_GOTPLT20:                howto manager.      (line 1968)
11853* BFD_RELOC_390_GOTPLT32:                howto manager.      (line 1933)
11854* BFD_RELOC_390_GOTPLT64:                howto manager.      (line 1935)
11855* BFD_RELOC_390_GOTPLTENT:               howto manager.      (line 1937)
11856* BFD_RELOC_390_IRELATIVE:               howto manager.      (line 1971)
11857* BFD_RELOC_390_JMP_SLOT:                howto manager.      (line 1895)
11858* BFD_RELOC_390_PC12DBL:                 howto manager.      (line 1903)
11859* BFD_RELOC_390_PC16DBL:                 howto manager.      (line 1907)
11860* BFD_RELOC_390_PC24DBL:                 howto manager.      (line 1911)
11861* BFD_RELOC_390_PC32DBL:                 howto manager.      (line 1915)
11862* BFD_RELOC_390_PLT12DBL:                howto manager.      (line 1905)
11863* BFD_RELOC_390_PLT16DBL:                howto manager.      (line 1909)
11864* BFD_RELOC_390_PLT24DBL:                howto manager.      (line 1913)
11865* BFD_RELOC_390_PLT32:                   howto manager.      (line 1889)
11866* BFD_RELOC_390_PLT32DBL:                howto manager.      (line 1917)
11867* BFD_RELOC_390_PLT64:                   howto manager.      (line 1923)
11868* BFD_RELOC_390_PLTOFF16:                howto manager.      (line 1939)
11869* BFD_RELOC_390_PLTOFF32:                howto manager.      (line 1941)
11870* BFD_RELOC_390_PLTOFF64:                howto manager.      (line 1943)
11871* BFD_RELOC_390_RELATIVE:                howto manager.      (line 1897)
11872* BFD_RELOC_390_TLS_DTPMOD:              howto manager.      (line 1962)
11873* BFD_RELOC_390_TLS_DTPOFF:              howto manager.      (line 1963)
11874* BFD_RELOC_390_TLS_GD32:                howto manager.      (line 1948)
11875* BFD_RELOC_390_TLS_GD64:                howto manager.      (line 1949)
11876* BFD_RELOC_390_TLS_GDCALL:              howto manager.      (line 1946)
11877* BFD_RELOC_390_TLS_GOTIE12:             howto manager.      (line 1950)
11878* BFD_RELOC_390_TLS_GOTIE20:             howto manager.      (line 1969)
11879* BFD_RELOC_390_TLS_GOTIE32:             howto manager.      (line 1951)
11880* BFD_RELOC_390_TLS_GOTIE64:             howto manager.      (line 1952)
11881* BFD_RELOC_390_TLS_IE32:                howto manager.      (line 1955)
11882* BFD_RELOC_390_TLS_IE64:                howto manager.      (line 1956)
11883* BFD_RELOC_390_TLS_IEENT:               howto manager.      (line 1957)
11884* BFD_RELOC_390_TLS_LDCALL:              howto manager.      (line 1947)
11885* BFD_RELOC_390_TLS_LDM32:               howto manager.      (line 1953)
11886* BFD_RELOC_390_TLS_LDM64:               howto manager.      (line 1954)
11887* BFD_RELOC_390_TLS_LDO32:               howto manager.      (line 1960)
11888* BFD_RELOC_390_TLS_LDO64:               howto manager.      (line 1961)
11889* BFD_RELOC_390_TLS_LE32:                howto manager.      (line 1958)
11890* BFD_RELOC_390_TLS_LE64:                howto manager.      (line 1959)
11891* BFD_RELOC_390_TLS_LOAD:                howto manager.      (line 1945)
11892* BFD_RELOC_390_TLS_TPOFF:               howto manager.      (line 1964)
11893* BFD_RELOC_64:                          howto manager.      (line   25)
11894* BFD_RELOC_64_PCREL:                    howto manager.      (line   33)
11895* BFD_RELOC_64_PLTOFF:                   howto manager.      (line   61)
11896* BFD_RELOC_64_PLT_PCREL:                howto manager.      (line   56)
11897* BFD_RELOC_68K_GLOB_DAT:                howto manager.      (line   72)
11898* BFD_RELOC_68K_JMP_SLOT:                howto manager.      (line   73)
11899* BFD_RELOC_68K_RELATIVE:                howto manager.      (line   74)
11900* BFD_RELOC_68K_TLS_GD16:                howto manager.      (line   76)
11901* BFD_RELOC_68K_TLS_GD32:                howto manager.      (line   75)
11902* BFD_RELOC_68K_TLS_GD8:                 howto manager.      (line   77)
11903* BFD_RELOC_68K_TLS_IE16:                howto manager.      (line   85)
11904* BFD_RELOC_68K_TLS_IE32:                howto manager.      (line   84)
11905* BFD_RELOC_68K_TLS_IE8:                 howto manager.      (line   86)
11906* BFD_RELOC_68K_TLS_LDM16:               howto manager.      (line   79)
11907* BFD_RELOC_68K_TLS_LDM32:               howto manager.      (line   78)
11908* BFD_RELOC_68K_TLS_LDM8:                howto manager.      (line   80)
11909* BFD_RELOC_68K_TLS_LDO16:               howto manager.      (line   82)
11910* BFD_RELOC_68K_TLS_LDO32:               howto manager.      (line   81)
11911* BFD_RELOC_68K_TLS_LDO8:                howto manager.      (line   83)
11912* BFD_RELOC_68K_TLS_LE16:                howto manager.      (line   88)
11913* BFD_RELOC_68K_TLS_LE32:                howto manager.      (line   87)
11914* BFD_RELOC_68K_TLS_LE8:                 howto manager.      (line   89)
11915* BFD_RELOC_8:                           howto manager.      (line   31)
11916* BFD_RELOC_860_COPY:                    howto manager.      (line 2336)
11917* BFD_RELOC_860_GLOB_DAT:                howto manager.      (line 2337)
11918* BFD_RELOC_860_HAGOT:                   howto manager.      (line 2362)
11919* BFD_RELOC_860_HAGOTOFF:                howto manager.      (line 2363)
11920* BFD_RELOC_860_HAPC:                    howto manager.      (line 2364)
11921* BFD_RELOC_860_HIGH:                    howto manager.      (line 2365)
11922* BFD_RELOC_860_HIGHADJ:                 howto manager.      (line 2361)
11923* BFD_RELOC_860_HIGOT:                   howto manager.      (line 2366)
11924* BFD_RELOC_860_HIGOTOFF:                howto manager.      (line 2367)
11925* BFD_RELOC_860_JUMP_SLOT:               howto manager.      (line 2338)
11926* BFD_RELOC_860_LOGOT0:                  howto manager.      (line 2350)
11927* BFD_RELOC_860_LOGOT1:                  howto manager.      (line 2352)
11928* BFD_RELOC_860_LOGOTOFF0:               howto manager.      (line 2354)
11929* BFD_RELOC_860_LOGOTOFF1:               howto manager.      (line 2356)
11930* BFD_RELOC_860_LOGOTOFF2:               howto manager.      (line 2358)
11931* BFD_RELOC_860_LOGOTOFF3:               howto manager.      (line 2359)
11932* BFD_RELOC_860_LOPC:                    howto manager.      (line 2360)
11933* BFD_RELOC_860_LOW0:                    howto manager.      (line 2343)
11934* BFD_RELOC_860_LOW1:                    howto manager.      (line 2345)
11935* BFD_RELOC_860_LOW2:                    howto manager.      (line 2347)
11936* BFD_RELOC_860_LOW3:                    howto manager.      (line 2349)
11937* BFD_RELOC_860_PC16:                    howto manager.      (line 2342)
11938* BFD_RELOC_860_PC26:                    howto manager.      (line 2340)
11939* BFD_RELOC_860_PLT26:                   howto manager.      (line 2341)
11940* BFD_RELOC_860_RELATIVE:                howto manager.      (line 2339)
11941* BFD_RELOC_860_SPGOT0:                  howto manager.      (line 2351)
11942* BFD_RELOC_860_SPGOT1:                  howto manager.      (line 2353)
11943* BFD_RELOC_860_SPGOTOFF0:               howto manager.      (line 2355)
11944* BFD_RELOC_860_SPGOTOFF1:               howto manager.      (line 2357)
11945* BFD_RELOC_860_SPLIT0:                  howto manager.      (line 2344)
11946* BFD_RELOC_860_SPLIT1:                  howto manager.      (line 2346)
11947* BFD_RELOC_860_SPLIT2:                  howto manager.      (line 2348)
11948* BFD_RELOC_8_BASEREL:                   howto manager.      (line   96)
11949* BFD_RELOC_8_FFnn:                      howto manager.      (line   99)
11950* BFD_RELOC_8_GOTOFF:                    howto manager.      (line   55)
11951* BFD_RELOC_8_GOT_PCREL:                 howto manager.      (line   49)
11952* BFD_RELOC_8_PCREL:                     howto manager.      (line   38)
11953* BFD_RELOC_8_PLTOFF:                    howto manager.      (line   67)
11954* BFD_RELOC_8_PLT_PCREL:                 howto manager.      (line   60)
11955* BFD_RELOC_AARCH64_16:                  howto manager.      (line 2741)
11956* BFD_RELOC_AARCH64_16_PCREL:            howto manager.      (line 2747)
11957* BFD_RELOC_AARCH64_32:                  howto manager.      (line 2740)
11958* BFD_RELOC_AARCH64_32_PCREL:            howto manager.      (line 2746)
11959* BFD_RELOC_AARCH64_64:                  howto manager.      (line 2739)
11960* BFD_RELOC_AARCH64_64_PCREL:            howto manager.      (line 2745)
11961* BFD_RELOC_AARCH64_ADD_LO12:            howto manager.      (line 2797)
11962* BFD_RELOC_AARCH64_ADR_GOT_PAGE:        howto manager.      (line 2843)
11963* BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL:   howto manager.      (line 2793)
11964* BFD_RELOC_AARCH64_ADR_HI21_PCREL:      howto manager.      (line 2790)
11965* BFD_RELOC_AARCH64_ADR_LO21_PCREL:      howto manager.      (line 2787)
11966* BFD_RELOC_AARCH64_BRANCH19:            howto manager.      (line 2809)
11967* BFD_RELOC_AARCH64_CALL26:              howto manager.      (line 2817)
11968* BFD_RELOC_AARCH64_COPY:                howto manager.      (line 2986)
11969* BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP:  howto manager.      (line 3010)
11970* BFD_RELOC_AARCH64_GLOB_DAT:            howto manager.      (line 2988)
11971* BFD_RELOC_AARCH64_GOT_LD_PREL19:       howto manager.      (line 2837)
11972* BFD_RELOC_AARCH64_IRELATIVE:           howto manager.      (line 3002)
11973* BFD_RELOC_AARCH64_JUMP26:              howto manager.      (line 2813)
11974* BFD_RELOC_AARCH64_JUMP_SLOT:           howto manager.      (line 2990)
11975* BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14:   howto manager.      (line 2864)
11976* BFD_RELOC_AARCH64_LD32_GOT_LO12_NC:    howto manager.      (line 2851)
11977* BFD_RELOC_AARCH64_LD64_GOTOFF_LO15:    howto manager.      (line 2861)
11978* BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15:   howto manager.      (line 2867)
11979* BFD_RELOC_AARCH64_LD64_GOT_LO12_NC:    howto manager.      (line 2847)
11980* BFD_RELOC_AARCH64_LDST128_LO12:        howto manager.      (line 2833)
11981* BFD_RELOC_AARCH64_LDST16_LO12:         howto manager.      (line 2821)
11982* BFD_RELOC_AARCH64_LDST32_LO12:         howto manager.      (line 2825)
11983* BFD_RELOC_AARCH64_LDST64_LO12:         howto manager.      (line 2829)
11984* BFD_RELOC_AARCH64_LDST8_LO12:          howto manager.      (line 2801)
11985* BFD_RELOC_AARCH64_LDST_LO12:           howto manager.      (line 3013)
11986* BFD_RELOC_AARCH64_LD_GOT_LO12_NC:      howto manager.      (line 3024)
11987* BFD_RELOC_AARCH64_LD_LO19_PCREL:       howto manager.      (line 2783)
11988* BFD_RELOC_AARCH64_MOVW_G0:             howto manager.      (line 2750)
11989* BFD_RELOC_AARCH64_MOVW_G0_NC:          howto manager.      (line 2753)
11990* BFD_RELOC_AARCH64_MOVW_G0_S:           howto manager.      (line 2771)
11991* BFD_RELOC_AARCH64_MOVW_G1:             howto manager.      (line 2756)
11992* BFD_RELOC_AARCH64_MOVW_G1_NC:          howto manager.      (line 2759)
11993* BFD_RELOC_AARCH64_MOVW_G1_S:           howto manager.      (line 2775)
11994* BFD_RELOC_AARCH64_MOVW_G2:             howto manager.      (line 2762)
11995* BFD_RELOC_AARCH64_MOVW_G2_NC:          howto manager.      (line 2765)
11996* BFD_RELOC_AARCH64_MOVW_G2_S:           howto manager.      (line 2779)
11997* BFD_RELOC_AARCH64_MOVW_G3:             howto manager.      (line 2768)
11998* BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC:   howto manager.      (line 2855)
11999* BFD_RELOC_AARCH64_MOVW_GOTOFF_G1:      howto manager.      (line 2858)
12000* BFD_RELOC_AARCH64_NONE:                howto manager.      (line 2737)
12001* BFD_RELOC_AARCH64_NULL:                howto manager.      (line 2735)
12002* BFD_RELOC_AARCH64_RELATIVE:            howto manager.      (line 2992)
12003* BFD_RELOC_AARCH64_RELOC_END:           howto manager.      (line 3004)
12004* BFD_RELOC_AARCH64_RELOC_START:         howto manager.      (line 2730)
12005* BFD_RELOC_AARCH64_TLSDESC:             howto manager.      (line 3000)
12006* BFD_RELOC_AARCH64_TLSDESC_ADD:         howto manager.      (line 2982)
12007* BFD_RELOC_AARCH64_TLSDESC_ADD_LO12:    howto manager.      (line 2974)
12008* BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21:  howto manager.      (line 2968)
12009* BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21:  howto manager.      (line 2966)
12010* BFD_RELOC_AARCH64_TLSDESC_CALL:        howto manager.      (line 2984)
12011* BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC: howto manager.     (line 2972)
12012* BFD_RELOC_AARCH64_TLSDESC_LD64_LO12:   howto manager.      (line 2970)
12013* BFD_RELOC_AARCH64_TLSDESC_LDR:         howto manager.      (line 2980)
12014* BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC:  howto manager.      (line 3030)
12015* BFD_RELOC_AARCH64_TLSDESC_LD_PREL19:   howto manager.      (line 2964)
12016* BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC:   howto manager.      (line 2978)
12017* BFD_RELOC_AARCH64_TLSDESC_OFF_G1:      howto manager.      (line 2976)
12018* BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC:   howto manager.      (line 2877)
12019* BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21:    howto manager.      (line 2870)
12020* BFD_RELOC_AARCH64_TLSGD_ADR_PREL21:    howto manager.      (line 2875)
12021* BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC:    howto manager.      (line 2881)
12022* BFD_RELOC_AARCH64_TLSGD_MOVW_G1:       howto manager.      (line 2883)
12023* BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21: howto manager.
12024                                                             (line 2885)
12025* BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC: howto manager.
12026                                                             (line 2889)
12027* BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC: howto manager.
12028                                                             (line 2887)
12029* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC: howto manager.
12030                                                             (line 3027)
12031* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19: howto manager. (line 2891)
12032* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC: howto manager.
12033                                                             (line 2893)
12034* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1: howto manager.   (line 2895)
12035* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12: howto manager.    (line 2897)
12036* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12: howto manager.    (line 2899)
12037* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC: howto manager. (line 2901)
12038* BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC:   howto manager.      (line 2904)
12039* BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21:    howto manager.      (line 2908)
12040* BFD_RELOC_AARCH64_TLSLD_ADR_PREL21:    howto manager.      (line 2911)
12041* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12: howto manager. (line 2914)
12042* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC: howto manager.
12043                                                             (line 2917)
12044* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12: howto manager. (line 2920)
12045* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC: howto manager.
12046                                                             (line 2923)
12047* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12: howto manager. (line 2926)
12048* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC: howto manager.
12049                                                             (line 2929)
12050* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12: howto manager.  (line 2932)
12051* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC: howto manager.
12052                                                             (line 2935)
12053* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12: howto manager.   (line 3017)
12054* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC: howto manager.
12055                                                             (line 3021)
12056* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0: howto manager.     (line 2938)
12057* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC: howto manager.  (line 2940)
12058* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1: howto manager.     (line 2942)
12059* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC: howto manager.  (line 2944)
12060* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2: howto manager.     (line 2946)
12061* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12: howto manager.     (line 2958)
12062* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12: howto manager.     (line 2960)
12063* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC: howto manager.  (line 2962)
12064* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0: howto manager.      (line 2954)
12065* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC: howto manager.   (line 2956)
12066* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1: howto manager.      (line 2950)
12067* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC: howto manager.   (line 2952)
12068* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2: howto manager.      (line 2948)
12069* BFD_RELOC_AARCH64_TLS_DTPMOD:          howto manager.      (line 2994)
12070* BFD_RELOC_AARCH64_TLS_DTPREL:          howto manager.      (line 2996)
12071* BFD_RELOC_AARCH64_TLS_TPREL:           howto manager.      (line 2998)
12072* BFD_RELOC_AARCH64_TSTBR14:             howto manager.      (line 2805)
12073* BFD_RELOC_AC_SECTOFF_S9:               howto manager.      (line 1014)
12074* BFD_RELOC_AC_SECTOFF_S9_1:             howto manager.      (line 1015)
12075* BFD_RELOC_AC_SECTOFF_S9_2:             howto manager.      (line 1016)
12076* BFD_RELOC_AC_SECTOFF_U8:               howto manager.      (line 1011)
12077* BFD_RELOC_AC_SECTOFF_U8_1:             howto manager.      (line 1012)
12078* BFD_RELOC_AC_SECTOFF_U8_2:             howto manager.      (line 1013)
12079* BFD_RELOC_ALPHA_BOH:                   howto manager.      (line  292)
12080* BFD_RELOC_ALPHA_BRSGP:                 howto manager.      (line  279)
12081* BFD_RELOC_ALPHA_BSR:                   howto manager.      (line  286)
12082* BFD_RELOC_ALPHA_CODEADDR:              howto manager.      (line  272)
12083* BFD_RELOC_ALPHA_DTPMOD64:              howto manager.      (line  297)
12084* BFD_RELOC_ALPHA_DTPREL16:              howto manager.      (line  302)
12085* BFD_RELOC_ALPHA_DTPREL64:              howto manager.      (line  299)
12086* BFD_RELOC_ALPHA_DTPREL_HI16:           howto manager.      (line  300)
12087* BFD_RELOC_ALPHA_DTPREL_LO16:           howto manager.      (line  301)
12088* BFD_RELOC_ALPHA_ELF_LITERAL:           howto manager.      (line  240)
12089* BFD_RELOC_ALPHA_GOTDTPREL16:           howto manager.      (line  298)
12090* BFD_RELOC_ALPHA_GOTTPREL16:            howto manager.      (line  303)
12091* BFD_RELOC_ALPHA_GPDISP:                howto manager.      (line  235)
12092* BFD_RELOC_ALPHA_GPDISP_HI16:           howto manager.      (line  223)
12093* BFD_RELOC_ALPHA_GPDISP_LO16:           howto manager.      (line  230)
12094* BFD_RELOC_ALPHA_GPREL_HI16:            howto manager.      (line  275)
12095* BFD_RELOC_ALPHA_GPREL_LO16:            howto manager.      (line  276)
12096* BFD_RELOC_ALPHA_HINT:                  howto manager.      (line  265)
12097* BFD_RELOC_ALPHA_LDA:                   howto manager.      (line  289)
12098* BFD_RELOC_ALPHA_LINKAGE:               howto manager.      (line  269)
12099* BFD_RELOC_ALPHA_LITERAL:               howto manager.      (line  239)
12100* BFD_RELOC_ALPHA_LITUSE:                howto manager.      (line  241)
12101* BFD_RELOC_ALPHA_NOP:                   howto manager.      (line  283)
12102* BFD_RELOC_ALPHA_TLSGD:                 howto manager.      (line  295)
12103* BFD_RELOC_ALPHA_TLSLDM:                howto manager.      (line  296)
12104* BFD_RELOC_ALPHA_TPREL16:               howto manager.      (line  307)
12105* BFD_RELOC_ALPHA_TPREL64:               howto manager.      (line  304)
12106* BFD_RELOC_ALPHA_TPREL_HI16:            howto manager.      (line  305)
12107* BFD_RELOC_ALPHA_TPREL_LO16:            howto manager.      (line  306)
12108* BFD_RELOC_ARC_16:                      howto manager.      (line  983)
12109* BFD_RELOC_ARC_24:                      howto manager.      (line  984)
12110* BFD_RELOC_ARC_32:                      howto manager.      (line  985)
12111* BFD_RELOC_ARC_32_ME:                   howto manager.      (line 1005)
12112* BFD_RELOC_ARC_32_ME_S:                 howto manager.      (line 1006)
12113* BFD_RELOC_ARC_32_PCREL:                howto manager.      (line 1023)
12114* BFD_RELOC_ARC_8:                       howto manager.      (line  982)
12115* BFD_RELOC_ARC_COPY:                    howto manager.      (line 1028)
12116* BFD_RELOC_ARC_GLOB_DAT:                howto manager.      (line 1029)
12117* BFD_RELOC_ARC_GOT32:                   howto manager.      (line 1025)
12118* BFD_RELOC_ARC_GOTOFF:                  howto manager.      (line 1032)
12119* BFD_RELOC_ARC_GOTPC:                   howto manager.      (line 1033)
12120* BFD_RELOC_ARC_GOTPC32:                 howto manager.      (line 1026)
12121* BFD_RELOC_ARC_JLI_SECTOFF:             howto manager.      (line 1049)
12122* BFD_RELOC_ARC_JMP_SLOT:                howto manager.      (line 1030)
12123* BFD_RELOC_ARC_N16:                     howto manager.      (line  987)
12124* BFD_RELOC_ARC_N24:                     howto manager.      (line  988)
12125* BFD_RELOC_ARC_N32:                     howto manager.      (line  989)
12126* BFD_RELOC_ARC_N32_ME:                  howto manager.      (line 1007)
12127* BFD_RELOC_ARC_N8:                      howto manager.      (line  986)
12128* BFD_RELOC_ARC_NONE:                    howto manager.      (line  981)
12129* BFD_RELOC_ARC_NPS_CMEM16:              howto manager.      (line 1048)
12130* BFD_RELOC_ARC_PC32:                    howto manager.      (line 1024)
12131* BFD_RELOC_ARC_PLT32:                   howto manager.      (line 1027)
12132* BFD_RELOC_ARC_RELATIVE:                howto manager.      (line 1031)
12133* BFD_RELOC_ARC_S13_PCREL:               howto manager.      (line 1003)
12134* BFD_RELOC_ARC_S21H_PCREL:              howto manager.      (line  992)
12135* BFD_RELOC_ARC_S21H_PCREL_PLT:          howto manager.      (line 1047)
12136* BFD_RELOC_ARC_S21W_PCREL:              howto manager.      (line  993)
12137* BFD_RELOC_ARC_S21W_PCREL_PLT:          howto manager.      (line 1034)
12138* BFD_RELOC_ARC_S25H_PCREL:              howto manager.      (line  994)
12139* BFD_RELOC_ARC_S25H_PCREL_PLT:          howto manager.      (line 1035)
12140* BFD_RELOC_ARC_S25W_PCREL:              howto manager.      (line  995)
12141* BFD_RELOC_ARC_S25W_PCREL_PLT:          howto manager.      (line 1046)
12142* BFD_RELOC_ARC_SDA:                     howto manager.      (line  990)
12143* BFD_RELOC_ARC_SDA16_LD:                howto manager.      (line 1000)
12144* BFD_RELOC_ARC_SDA16_LD1:               howto manager.      (line 1001)
12145* BFD_RELOC_ARC_SDA16_LD2:               howto manager.      (line 1002)
12146* BFD_RELOC_ARC_SDA16_ST2:               howto manager.      (line 1022)
12147* BFD_RELOC_ARC_SDA32:                   howto manager.      (line  996)
12148* BFD_RELOC_ARC_SDA32_ME:                howto manager.      (line 1009)
12149* BFD_RELOC_ARC_SDA_12:                  howto manager.      (line 1021)
12150* BFD_RELOC_ARC_SDA_LDST:                howto manager.      (line  997)
12151* BFD_RELOC_ARC_SDA_LDST1:               howto manager.      (line  998)
12152* BFD_RELOC_ARC_SDA_LDST2:               howto manager.      (line  999)
12153* BFD_RELOC_ARC_SECTOFF:                 howto manager.      (line  991)
12154* BFD_RELOC_ARC_SECTOFF_1:               howto manager.      (line 1019)
12155* BFD_RELOC_ARC_SECTOFF_2:               howto manager.      (line 1020)
12156* BFD_RELOC_ARC_SECTOFF_ME:              howto manager.      (line 1008)
12157* BFD_RELOC_ARC_SECTOFF_ME_1:            howto manager.      (line 1017)
12158* BFD_RELOC_ARC_SECTOFF_ME_2:            howto manager.      (line 1018)
12159* BFD_RELOC_ARC_TLS_DTPMOD:              howto manager.      (line 1036)
12160* BFD_RELOC_ARC_TLS_DTPOFF:              howto manager.      (line 1042)
12161* BFD_RELOC_ARC_TLS_DTPOFF_S9:           howto manager.      (line 1043)
12162* BFD_RELOC_ARC_TLS_GD_CALL:             howto manager.      (line 1040)
12163* BFD_RELOC_ARC_TLS_GD_GOT:              howto manager.      (line 1038)
12164* BFD_RELOC_ARC_TLS_GD_LD:               howto manager.      (line 1039)
12165* BFD_RELOC_ARC_TLS_IE_GOT:              howto manager.      (line 1041)
12166* BFD_RELOC_ARC_TLS_LE_32:               howto manager.      (line 1045)
12167* BFD_RELOC_ARC_TLS_LE_S9:               howto manager.      (line 1044)
12168* BFD_RELOC_ARC_TLS_TPOFF:               howto manager.      (line 1037)
12169* BFD_RELOC_ARC_W:                       howto manager.      (line 1004)
12170* BFD_RELOC_ARC_W_ME:                    howto manager.      (line 1010)
12171* BFD_RELOC_ARM_ADRL_IMMEDIATE:          howto manager.      (line  855)
12172* BFD_RELOC_ARM_ADR_IMM:                 howto manager.      (line  869)
12173* BFD_RELOC_ARM_ALU_PC_G0:               howto manager.      (line  817)
12174* BFD_RELOC_ARM_ALU_PC_G0_NC:            howto manager.      (line  816)
12175* BFD_RELOC_ARM_ALU_PC_G1:               howto manager.      (line  819)
12176* BFD_RELOC_ARM_ALU_PC_G1_NC:            howto manager.      (line  818)
12177* BFD_RELOC_ARM_ALU_PC_G2:               howto manager.      (line  820)
12178* BFD_RELOC_ARM_ALU_SB_G0:               howto manager.      (line  831)
12179* BFD_RELOC_ARM_ALU_SB_G0_NC:            howto manager.      (line  830)
12180* BFD_RELOC_ARM_ALU_SB_G1:               howto manager.      (line  833)
12181* BFD_RELOC_ARM_ALU_SB_G1_NC:            howto manager.      (line  832)
12182* BFD_RELOC_ARM_ALU_SB_G2:               howto manager.      (line  834)
12183* BFD_RELOC_ARM_CP_OFF_IMM:              howto manager.      (line  865)
12184* BFD_RELOC_ARM_CP_OFF_IMM_S2:           howto manager.      (line  866)
12185* BFD_RELOC_ARM_GLOB_DAT:                howto manager.      (line  793)
12186* BFD_RELOC_ARM_GOT32:                   howto manager.      (line  794)
12187* BFD_RELOC_ARM_GOTOFF:                  howto manager.      (line  797)
12188* BFD_RELOC_ARM_GOTPC:                   howto manager.      (line  798)
12189* BFD_RELOC_ARM_GOT_PREL:                howto manager.      (line  799)
12190* BFD_RELOC_ARM_HVC:                     howto manager.      (line  862)
12191* BFD_RELOC_ARM_HWLITERAL:               howto manager.      (line  876)
12192* BFD_RELOC_ARM_IMMEDIATE:               howto manager.      (line  854)
12193* BFD_RELOC_ARM_IN_POOL:                 howto manager.      (line  872)
12194* BFD_RELOC_ARM_IRELATIVE:               howto manager.      (line  847)
12195* BFD_RELOC_ARM_JUMP_SLOT:               howto manager.      (line  792)
12196* BFD_RELOC_ARM_LDC_PC_G0:               howto manager.      (line  827)
12197* BFD_RELOC_ARM_LDC_PC_G1:               howto manager.      (line  828)
12198* BFD_RELOC_ARM_LDC_PC_G2:               howto manager.      (line  829)
12199* BFD_RELOC_ARM_LDC_SB_G0:               howto manager.      (line  841)
12200* BFD_RELOC_ARM_LDC_SB_G1:               howto manager.      (line  842)
12201* BFD_RELOC_ARM_LDC_SB_G2:               howto manager.      (line  843)
12202* BFD_RELOC_ARM_LDRS_PC_G0:              howto manager.      (line  824)
12203* BFD_RELOC_ARM_LDRS_PC_G1:              howto manager.      (line  825)
12204* BFD_RELOC_ARM_LDRS_PC_G2:              howto manager.      (line  826)
12205* BFD_RELOC_ARM_LDRS_SB_G0:              howto manager.      (line  838)
12206* BFD_RELOC_ARM_LDRS_SB_G1:              howto manager.      (line  839)
12207* BFD_RELOC_ARM_LDRS_SB_G2:              howto manager.      (line  840)
12208* BFD_RELOC_ARM_LDR_IMM:                 howto manager.      (line  870)
12209* BFD_RELOC_ARM_LDR_PC_G0:               howto manager.      (line  821)
12210* BFD_RELOC_ARM_LDR_PC_G1:               howto manager.      (line  822)
12211* BFD_RELOC_ARM_LDR_PC_G2:               howto manager.      (line  823)
12212* BFD_RELOC_ARM_LDR_SB_G0:               howto manager.      (line  835)
12213* BFD_RELOC_ARM_LDR_SB_G1:               howto manager.      (line  836)
12214* BFD_RELOC_ARM_LDR_SB_G2:               howto manager.      (line  837)
12215* BFD_RELOC_ARM_LITERAL:                 howto manager.      (line  871)
12216* BFD_RELOC_ARM_MOVT:                    howto manager.      (line  784)
12217* BFD_RELOC_ARM_MOVT_PCREL:              howto manager.      (line  786)
12218* BFD_RELOC_ARM_MOVW:                    howto manager.      (line  783)
12219* BFD_RELOC_ARM_MOVW_PCREL:              howto manager.      (line  785)
12220* BFD_RELOC_ARM_MULTI:                   howto manager.      (line  864)
12221* BFD_RELOC_ARM_OFFSET_IMM:              howto manager.      (line  764)
12222* BFD_RELOC_ARM_OFFSET_IMM8:             howto manager.      (line  873)
12223* BFD_RELOC_ARM_PCREL_BLX:               howto manager.      (line  740)
12224* BFD_RELOC_ARM_PCREL_BRANCH:            howto manager.      (line  737)
12225* BFD_RELOC_ARM_PCREL_CALL:              howto manager.      (line  748)
12226* BFD_RELOC_ARM_PCREL_JUMP:              howto manager.      (line  751)
12227* BFD_RELOC_ARM_PLT32:                   howto manager.      (line  795)
12228* BFD_RELOC_ARM_PREL31:                  howto manager.      (line  781)
12229* BFD_RELOC_ARM_RELATIVE:                howto manager.      (line  796)
12230* BFD_RELOC_ARM_ROSEGREL32:              howto manager.      (line  773)
12231* BFD_RELOC_ARM_SBREL32:                 howto manager.      (line  775)
12232* BFD_RELOC_ARM_SHIFT_IMM:               howto manager.      (line  860)
12233* BFD_RELOC_ARM_SMC:                     howto manager.      (line  861)
12234* BFD_RELOC_ARM_SWI:                     howto manager.      (line  863)
12235* BFD_RELOC_ARM_T32_ADD_IMM:             howto manager.      (line  857)
12236* BFD_RELOC_ARM_T32_ADD_PC12:            howto manager.      (line  859)
12237* BFD_RELOC_ARM_T32_CP_OFF_IMM:          howto manager.      (line  867)
12238* BFD_RELOC_ARM_T32_CP_OFF_IMM_S2:       howto manager.      (line  868)
12239* BFD_RELOC_ARM_T32_IMM12:               howto manager.      (line  858)
12240* BFD_RELOC_ARM_T32_IMMEDIATE:           howto manager.      (line  856)
12241* BFD_RELOC_ARM_T32_OFFSET_IMM:          howto manager.      (line  875)
12242* BFD_RELOC_ARM_T32_OFFSET_U8:           howto manager.      (line  874)
12243* BFD_RELOC_ARM_TARGET1:                 howto manager.      (line  770)
12244* BFD_RELOC_ARM_TARGET2:                 howto manager.      (line  777)
12245* BFD_RELOC_ARM_THM_TLS_CALL:            howto manager.      (line  811)
12246* BFD_RELOC_ARM_THM_TLS_DESCSEQ:         howto manager.      (line  813)
12247* BFD_RELOC_ARM_THUMB_ADD:               howto manager.      (line  877)
12248* BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC:     howto manager.      (line  849)
12249* BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC:     howto manager.      (line  850)
12250* BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC:     howto manager.      (line  851)
12251* BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC:     howto manager.      (line  852)
12252* BFD_RELOC_ARM_THUMB_IMM:               howto manager.      (line  878)
12253* BFD_RELOC_ARM_THUMB_MOVT:              howto manager.      (line  788)
12254* BFD_RELOC_ARM_THUMB_MOVT_PCREL:        howto manager.      (line  790)
12255* BFD_RELOC_ARM_THUMB_MOVW:              howto manager.      (line  787)
12256* BFD_RELOC_ARM_THUMB_MOVW_PCREL:        howto manager.      (line  789)
12257* BFD_RELOC_ARM_THUMB_OFFSET:            howto manager.      (line  767)
12258* BFD_RELOC_ARM_THUMB_SHIFT:             howto manager.      (line  879)
12259* BFD_RELOC_ARM_TLS_CALL:                howto manager.      (line  810)
12260* BFD_RELOC_ARM_TLS_DESC:                howto manager.      (line  814)
12261* BFD_RELOC_ARM_TLS_DESCSEQ:             howto manager.      (line  812)
12262* BFD_RELOC_ARM_TLS_DTPMOD32:            howto manager.      (line  805)
12263* BFD_RELOC_ARM_TLS_DTPOFF32:            howto manager.      (line  804)
12264* BFD_RELOC_ARM_TLS_GD32:                howto manager.      (line  801)
12265* BFD_RELOC_ARM_TLS_GOTDESC:             howto manager.      (line  809)
12266* BFD_RELOC_ARM_TLS_IE32:                howto manager.      (line  807)
12267* BFD_RELOC_ARM_TLS_LDM32:               howto manager.      (line  803)
12268* BFD_RELOC_ARM_TLS_LDO32:               howto manager.      (line  802)
12269* BFD_RELOC_ARM_TLS_LE32:                howto manager.      (line  808)
12270* BFD_RELOC_ARM_TLS_TPOFF32:             howto manager.      (line  806)
12271* BFD_RELOC_ARM_V4BX:                    howto manager.      (line  845)
12272* BFD_RELOC_AVR_13_PCREL:                howto manager.      (line 1669)
12273* BFD_RELOC_AVR_16_PM:                   howto manager.      (line 1672)
12274* BFD_RELOC_AVR_6:                       howto manager.      (line 1740)
12275* BFD_RELOC_AVR_6_ADIW:                  howto manager.      (line 1743)
12276* BFD_RELOC_AVR_7_PCREL:                 howto manager.      (line 1666)
12277* BFD_RELOC_AVR_8_HI:                    howto manager.      (line 1749)
12278* BFD_RELOC_AVR_8_HLO:                   howto manager.      (line 1752)
12279* BFD_RELOC_AVR_8_LO:                    howto manager.      (line 1746)
12280* BFD_RELOC_AVR_CALL:                    howto manager.      (line 1734)
12281* BFD_RELOC_AVR_DIFF16:                  howto manager.      (line 1756)
12282* BFD_RELOC_AVR_DIFF32:                  howto manager.      (line 1757)
12283* BFD_RELOC_AVR_DIFF8:                   howto manager.      (line 1755)
12284* BFD_RELOC_AVR_HH8_LDI:                 howto manager.      (line 1681)
12285* BFD_RELOC_AVR_HH8_LDI_NEG:             howto manager.      (line 1696)
12286* BFD_RELOC_AVR_HH8_LDI_PM:              howto manager.      (line 1719)
12287* BFD_RELOC_AVR_HH8_LDI_PM_NEG:          howto manager.      (line 1730)
12288* BFD_RELOC_AVR_HI8_LDI:                 howto manager.      (line 1678)
12289* BFD_RELOC_AVR_HI8_LDI_GS:              howto manager.      (line 1714)
12290* BFD_RELOC_AVR_HI8_LDI_NEG:             howto manager.      (line 1692)
12291* BFD_RELOC_AVR_HI8_LDI_PM:              howto manager.      (line 1711)
12292* BFD_RELOC_AVR_HI8_LDI_PM_NEG:          howto manager.      (line 1726)
12293* BFD_RELOC_AVR_LDI:                     howto manager.      (line 1737)
12294* BFD_RELOC_AVR_LDS_STS_16:              howto manager.      (line 1764)
12295* BFD_RELOC_AVR_LO8_LDI:                 howto manager.      (line 1675)
12296* BFD_RELOC_AVR_LO8_LDI_GS:              howto manager.      (line 1706)
12297* BFD_RELOC_AVR_LO8_LDI_NEG:             howto manager.      (line 1688)
12298* BFD_RELOC_AVR_LO8_LDI_PM:              howto manager.      (line 1703)
12299* BFD_RELOC_AVR_LO8_LDI_PM_NEG:          howto manager.      (line 1723)
12300* BFD_RELOC_AVR_MS8_LDI:                 howto manager.      (line 1685)
12301* BFD_RELOC_AVR_MS8_LDI_NEG:             howto manager.      (line 1700)
12302* BFD_RELOC_AVR_PORT5:                   howto manager.      (line 1770)
12303* BFD_RELOC_AVR_PORT6:                   howto manager.      (line 1767)
12304* BFD_RELOC_BFIN_10_PCREL:               howto manager.      (line 1061)
12305* BFD_RELOC_BFIN_11_PCREL:               howto manager.      (line 1063)
12306* BFD_RELOC_BFIN_12_PCREL_JUMP:          howto manager.      (line 1065)
12307* BFD_RELOC_BFIN_12_PCREL_JUMP_S:        howto manager.      (line 1067)
12308* BFD_RELOC_BFIN_16_HIGH:                howto manager.      (line 1053)
12309* BFD_RELOC_BFIN_16_IMM:                 howto manager.      (line 1051)
12310* BFD_RELOC_BFIN_16_LOW:                 howto manager.      (line 1059)
12311* BFD_RELOC_BFIN_24_PCREL_CALL_X:        howto manager.      (line 1069)
12312* BFD_RELOC_BFIN_24_PCREL_JUMP_L:        howto manager.      (line 1071)
12313* BFD_RELOC_BFIN_4_PCREL:                howto manager.      (line 1055)
12314* BFD_RELOC_BFIN_5_PCREL:                howto manager.      (line 1057)
12315* BFD_RELOC_BFIN_FUNCDESC:               howto manager.      (line 1076)
12316* BFD_RELOC_BFIN_FUNCDESC_GOT17M4:       howto manager.      (line 1077)
12317* BFD_RELOC_BFIN_FUNCDESC_GOTHI:         howto manager.      (line 1078)
12318* BFD_RELOC_BFIN_FUNCDESC_GOTLO:         howto manager.      (line 1079)
12319* BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4:    howto manager.      (line 1081)
12320* BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI:      howto manager.      (line 1082)
12321* BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO:      howto manager.      (line 1083)
12322* BFD_RELOC_BFIN_FUNCDESC_VALUE:         howto manager.      (line 1080)
12323* BFD_RELOC_BFIN_GOT:                    howto manager.      (line 1088)
12324* BFD_RELOC_BFIN_GOT17M4:                howto manager.      (line 1073)
12325* BFD_RELOC_BFIN_GOTHI:                  howto manager.      (line 1074)
12326* BFD_RELOC_BFIN_GOTLO:                  howto manager.      (line 1075)
12327* BFD_RELOC_BFIN_GOTOFF17M4:             howto manager.      (line 1084)
12328* BFD_RELOC_BFIN_GOTOFFHI:               howto manager.      (line 1085)
12329* BFD_RELOC_BFIN_GOTOFFLO:               howto manager.      (line 1086)
12330* BFD_RELOC_BFIN_PLTPC:                  howto manager.      (line 1090)
12331* BFD_RELOC_C6000_ABS_H16:               howto manager.      (line 1511)
12332* BFD_RELOC_C6000_ABS_L16:               howto manager.      (line 1510)
12333* BFD_RELOC_C6000_ABS_S16:               howto manager.      (line 1509)
12334* BFD_RELOC_C6000_ALIGN:                 howto manager.      (line 1532)
12335* BFD_RELOC_C6000_COPY:                  howto manager.      (line 1527)
12336* BFD_RELOC_C6000_DSBT_INDEX:            howto manager.      (line 1525)
12337* BFD_RELOC_C6000_EHTYPE:                howto manager.      (line 1529)
12338* BFD_RELOC_C6000_FPHEAD:                howto manager.      (line 1533)
12339* BFD_RELOC_C6000_JUMP_SLOT:             howto manager.      (line 1528)
12340* BFD_RELOC_C6000_NOCMP:                 howto manager.      (line 1534)
12341* BFD_RELOC_C6000_PCR_H16:               howto manager.      (line 1530)
12342* BFD_RELOC_C6000_PCR_L16:               howto manager.      (line 1531)
12343* BFD_RELOC_C6000_PCR_S10:               howto manager.      (line 1507)
12344* BFD_RELOC_C6000_PCR_S12:               howto manager.      (line 1506)
12345* BFD_RELOC_C6000_PCR_S21:               howto manager.      (line 1505)
12346* BFD_RELOC_C6000_PCR_S7:                howto manager.      (line 1508)
12347* BFD_RELOC_C6000_PREL31:                howto manager.      (line 1526)
12348* BFD_RELOC_C6000_SBR_GOT_H16_W:         howto manager.      (line 1524)
12349* BFD_RELOC_C6000_SBR_GOT_L16_W:         howto manager.      (line 1523)
12350* BFD_RELOC_C6000_SBR_GOT_U15_W:         howto manager.      (line 1522)
12351* BFD_RELOC_C6000_SBR_H16_B:             howto manager.      (line 1519)
12352* BFD_RELOC_C6000_SBR_H16_H:             howto manager.      (line 1520)
12353* BFD_RELOC_C6000_SBR_H16_W:             howto manager.      (line 1521)
12354* BFD_RELOC_C6000_SBR_L16_B:             howto manager.      (line 1516)
12355* BFD_RELOC_C6000_SBR_L16_H:             howto manager.      (line 1517)
12356* BFD_RELOC_C6000_SBR_L16_W:             howto manager.      (line 1518)
12357* BFD_RELOC_C6000_SBR_S16:               howto manager.      (line 1515)
12358* BFD_RELOC_C6000_SBR_U15_B:             howto manager.      (line 1512)
12359* BFD_RELOC_C6000_SBR_U15_H:             howto manager.      (line 1513)
12360* BFD_RELOC_C6000_SBR_U15_W:             howto manager.      (line 1514)
12361* bfd_reloc_code_type:                   howto manager.      (line    9)
12362* BFD_RELOC_CR16_ABS20:                  howto manager.      (line 2248)
12363* BFD_RELOC_CR16_ABS24:                  howto manager.      (line 2249)
12364* BFD_RELOC_CR16_DISP16:                 howto manager.      (line 2259)
12365* BFD_RELOC_CR16_DISP20:                 howto manager.      (line 2260)
12366* BFD_RELOC_CR16_DISP24:                 howto manager.      (line 2261)
12367* BFD_RELOC_CR16_DISP24a:                howto manager.      (line 2262)
12368* BFD_RELOC_CR16_DISP4:                  howto manager.      (line 2257)
12369* BFD_RELOC_CR16_DISP8:                  howto manager.      (line 2258)
12370* BFD_RELOC_CR16_GLOB_DAT:               howto manager.      (line 2268)
12371* BFD_RELOC_CR16_GOTC_REGREL20:          howto manager.      (line 2267)
12372* BFD_RELOC_CR16_GOT_REGREL20:           howto manager.      (line 2266)
12373* BFD_RELOC_CR16_IMM16:                  howto manager.      (line 2252)
12374* BFD_RELOC_CR16_IMM20:                  howto manager.      (line 2253)
12375* BFD_RELOC_CR16_IMM24:                  howto manager.      (line 2254)
12376* BFD_RELOC_CR16_IMM32:                  howto manager.      (line 2255)
12377* BFD_RELOC_CR16_IMM32a:                 howto manager.      (line 2256)
12378* BFD_RELOC_CR16_IMM4:                   howto manager.      (line 2250)
12379* BFD_RELOC_CR16_IMM8:                   howto manager.      (line 2251)
12380* BFD_RELOC_CR16_NUM16:                  howto manager.      (line 2237)
12381* BFD_RELOC_CR16_NUM32:                  howto manager.      (line 2238)
12382* BFD_RELOC_CR16_NUM32a:                 howto manager.      (line 2239)
12383* BFD_RELOC_CR16_NUM8:                   howto manager.      (line 2236)
12384* BFD_RELOC_CR16_REGREL0:                howto manager.      (line 2240)
12385* BFD_RELOC_CR16_REGREL14:               howto manager.      (line 2243)
12386* BFD_RELOC_CR16_REGREL14a:              howto manager.      (line 2244)
12387* BFD_RELOC_CR16_REGREL16:               howto manager.      (line 2245)
12388* BFD_RELOC_CR16_REGREL20:               howto manager.      (line 2246)
12389* BFD_RELOC_CR16_REGREL20a:              howto manager.      (line 2247)
12390* BFD_RELOC_CR16_REGREL4:                howto manager.      (line 2241)
12391* BFD_RELOC_CR16_REGREL4a:               howto manager.      (line 2242)
12392* BFD_RELOC_CR16_SWITCH16:               howto manager.      (line 2264)
12393* BFD_RELOC_CR16_SWITCH32:               howto manager.      (line 2265)
12394* BFD_RELOC_CR16_SWITCH8:                howto manager.      (line 2263)
12395* BFD_RELOC_CRIS_16_DTPREL:              howto manager.      (line 2328)
12396* BFD_RELOC_CRIS_16_GOT:                 howto manager.      (line 2310)
12397* BFD_RELOC_CRIS_16_GOTPLT:              howto manager.      (line 2314)
12398* BFD_RELOC_CRIS_16_GOT_GD:              howto manager.      (line 2324)
12399* BFD_RELOC_CRIS_16_GOT_TPREL:           howto manager.      (line 2330)
12400* BFD_RELOC_CRIS_16_TPREL:               howto manager.      (line 2332)
12401* BFD_RELOC_CRIS_32_DTPREL:              howto manager.      (line 2327)
12402* BFD_RELOC_CRIS_32_GD:                  howto manager.      (line 2325)
12403* BFD_RELOC_CRIS_32_GOT:                 howto manager.      (line 2308)
12404* BFD_RELOC_CRIS_32_GOTPLT:              howto manager.      (line 2312)
12405* BFD_RELOC_CRIS_32_GOTREL:              howto manager.      (line 2316)
12406* BFD_RELOC_CRIS_32_GOT_GD:              howto manager.      (line 2323)
12407* BFD_RELOC_CRIS_32_GOT_TPREL:           howto manager.      (line 2329)
12408* BFD_RELOC_CRIS_32_IE:                  howto manager.      (line 2334)
12409* BFD_RELOC_CRIS_32_PLT_GOTREL:          howto manager.      (line 2318)
12410* BFD_RELOC_CRIS_32_PLT_PCREL:           howto manager.      (line 2320)
12411* BFD_RELOC_CRIS_32_TPREL:               howto manager.      (line 2331)
12412* BFD_RELOC_CRIS_BDISP8:                 howto manager.      (line 2291)
12413* BFD_RELOC_CRIS_COPY:                   howto manager.      (line 2303)
12414* BFD_RELOC_CRIS_DTP:                    howto manager.      (line 2326)
12415* BFD_RELOC_CRIS_DTPMOD:                 howto manager.      (line 2333)
12416* BFD_RELOC_CRIS_GLOB_DAT:               howto manager.      (line 2304)
12417* BFD_RELOC_CRIS_JUMP_SLOT:              howto manager.      (line 2305)
12418* BFD_RELOC_CRIS_LAPCQ_OFFSET:           howto manager.      (line 2299)
12419* BFD_RELOC_CRIS_RELATIVE:               howto manager.      (line 2306)
12420* BFD_RELOC_CRIS_SIGNED_16:              howto manager.      (line 2297)
12421* BFD_RELOC_CRIS_SIGNED_6:               howto manager.      (line 2293)
12422* BFD_RELOC_CRIS_SIGNED_8:               howto manager.      (line 2295)
12423* BFD_RELOC_CRIS_UNSIGNED_16:            howto manager.      (line 2298)
12424* BFD_RELOC_CRIS_UNSIGNED_4:             howto manager.      (line 2300)
12425* BFD_RELOC_CRIS_UNSIGNED_5:             howto manager.      (line 2292)
12426* BFD_RELOC_CRIS_UNSIGNED_6:             howto manager.      (line 2294)
12427* BFD_RELOC_CRIS_UNSIGNED_8:             howto manager.      (line 2296)
12428* BFD_RELOC_CRX_ABS16:                   howto manager.      (line 2280)
12429* BFD_RELOC_CRX_ABS32:                   howto manager.      (line 2281)
12430* BFD_RELOC_CRX_IMM16:                   howto manager.      (line 2285)
12431* BFD_RELOC_CRX_IMM32:                   howto manager.      (line 2286)
12432* BFD_RELOC_CRX_NUM16:                   howto manager.      (line 2283)
12433* BFD_RELOC_CRX_NUM32:                   howto manager.      (line 2284)
12434* BFD_RELOC_CRX_NUM8:                    howto manager.      (line 2282)
12435* BFD_RELOC_CRX_REGREL12:                howto manager.      (line 2276)
12436* BFD_RELOC_CRX_REGREL22:                howto manager.      (line 2277)
12437* BFD_RELOC_CRX_REGREL28:                howto manager.      (line 2278)
12438* BFD_RELOC_CRX_REGREL32:                howto manager.      (line 2279)
12439* BFD_RELOC_CRX_REL16:                   howto manager.      (line 2273)
12440* BFD_RELOC_CRX_REL24:                   howto manager.      (line 2274)
12441* BFD_RELOC_CRX_REL32:                   howto manager.      (line 2275)
12442* BFD_RELOC_CRX_REL4:                    howto manager.      (line 2270)
12443* BFD_RELOC_CRX_REL8:                    howto manager.      (line 2271)
12444* BFD_RELOC_CRX_REL8_CMP:                howto manager.      (line 2272)
12445* BFD_RELOC_CRX_SWITCH16:                howto manager.      (line 2288)
12446* BFD_RELOC_CRX_SWITCH32:                howto manager.      (line 2289)
12447* BFD_RELOC_CRX_SWITCH8:                 howto manager.      (line 2287)
12448* BFD_RELOC_CTOR:                        howto manager.      (line  732)
12449* BFD_RELOC_D10V_10_PCREL_L:             howto manager.      (line 1135)
12450* BFD_RELOC_D10V_10_PCREL_R:             howto manager.      (line 1132)
12451* BFD_RELOC_D10V_18:                     howto manager.      (line 1139)
12452* BFD_RELOC_D10V_18_PCREL:               howto manager.      (line 1141)
12453* BFD_RELOC_D30V_15:                     howto manager.      (line 1152)
12454* BFD_RELOC_D30V_15_PCREL:               howto manager.      (line 1155)
12455* BFD_RELOC_D30V_15_PCREL_R:             howto manager.      (line 1158)
12456* BFD_RELOC_D30V_21:                     howto manager.      (line 1162)
12457* BFD_RELOC_D30V_21_PCREL:               howto manager.      (line 1165)
12458* BFD_RELOC_D30V_21_PCREL_R:             howto manager.      (line 1168)
12459* BFD_RELOC_D30V_32:                     howto manager.      (line 1172)
12460* BFD_RELOC_D30V_32_PCREL:               howto manager.      (line 1174)
12461* BFD_RELOC_D30V_6:                      howto manager.      (line 1143)
12462* BFD_RELOC_D30V_9_PCREL:                howto manager.      (line 1145)
12463* BFD_RELOC_D30V_9_PCREL_R:              howto manager.      (line 1148)
12464* BFD_RELOC_DLX_HI16_S:                  howto manager.      (line 1176)
12465* BFD_RELOC_DLX_JMP26:                   howto manager.      (line 1180)
12466* BFD_RELOC_DLX_LO16:                    howto manager.      (line 1178)
12467* BFD_RELOC_EPIPHANY_HIGH:               howto manager.      (line 3227)
12468* BFD_RELOC_EPIPHANY_IMM11:              howto manager.      (line 3233)
12469* BFD_RELOC_EPIPHANY_IMM8:               howto manager.      (line 3236)
12470* BFD_RELOC_EPIPHANY_LOW:                howto manager.      (line 3229)
12471* BFD_RELOC_EPIPHANY_SIMM11:             howto manager.      (line 3231)
12472* BFD_RELOC_EPIPHANY_SIMM24:             howto manager.      (line 3225)
12473* BFD_RELOC_EPIPHANY_SIMM8:              howto manager.      (line 3223)
12474* BFD_RELOC_FR30_10_IN_8:                howto manager.      (line 1550)
12475* BFD_RELOC_FR30_12_PCREL:               howto manager.      (line 1556)
12476* BFD_RELOC_FR30_20:                     howto manager.      (line 1538)
12477* BFD_RELOC_FR30_48:                     howto manager.      (line 1536)
12478* BFD_RELOC_FR30_6_IN_4:                 howto manager.      (line 1541)
12479* BFD_RELOC_FR30_8_IN_8:                 howto manager.      (line 1544)
12480* BFD_RELOC_FR30_9_IN_8:                 howto manager.      (line 1547)
12481* BFD_RELOC_FR30_9_PCREL:                howto manager.      (line 1553)
12482* BFD_RELOC_FRV_FUNCDESC:                howto manager.      (line  455)
12483* BFD_RELOC_FRV_FUNCDESC_GOT12:          howto manager.      (line  456)
12484* BFD_RELOC_FRV_FUNCDESC_GOTHI:          howto manager.      (line  457)
12485* BFD_RELOC_FRV_FUNCDESC_GOTLO:          howto manager.      (line  458)
12486* BFD_RELOC_FRV_FUNCDESC_GOTOFF12:       howto manager.      (line  460)
12487* BFD_RELOC_FRV_FUNCDESC_GOTOFFHI:       howto manager.      (line  461)
12488* BFD_RELOC_FRV_FUNCDESC_GOTOFFLO:       howto manager.      (line  462)
12489* BFD_RELOC_FRV_FUNCDESC_VALUE:          howto manager.      (line  459)
12490* BFD_RELOC_FRV_GETTLSOFF:               howto manager.      (line  466)
12491* BFD_RELOC_FRV_GETTLSOFF_RELAX:         howto manager.      (line  479)
12492* BFD_RELOC_FRV_GOT12:                   howto manager.      (line  452)
12493* BFD_RELOC_FRV_GOTHI:                   howto manager.      (line  453)
12494* BFD_RELOC_FRV_GOTLO:                   howto manager.      (line  454)
12495* BFD_RELOC_FRV_GOTOFF12:                howto manager.      (line  463)
12496* BFD_RELOC_FRV_GOTOFFHI:                howto manager.      (line  464)
12497* BFD_RELOC_FRV_GOTOFFLO:                howto manager.      (line  465)
12498* BFD_RELOC_FRV_GOTTLSDESC12:            howto manager.      (line  468)
12499* BFD_RELOC_FRV_GOTTLSDESCHI:            howto manager.      (line  469)
12500* BFD_RELOC_FRV_GOTTLSDESCLO:            howto manager.      (line  470)
12501* BFD_RELOC_FRV_GOTTLSOFF12:             howto manager.      (line  474)
12502* BFD_RELOC_FRV_GOTTLSOFFHI:             howto manager.      (line  475)
12503* BFD_RELOC_FRV_GOTTLSOFFLO:             howto manager.      (line  476)
12504* BFD_RELOC_FRV_GPREL12:                 howto manager.      (line  447)
12505* BFD_RELOC_FRV_GPREL32:                 howto manager.      (line  449)
12506* BFD_RELOC_FRV_GPRELHI:                 howto manager.      (line  450)
12507* BFD_RELOC_FRV_GPRELLO:                 howto manager.      (line  451)
12508* BFD_RELOC_FRV_GPRELU12:                howto manager.      (line  448)
12509* BFD_RELOC_FRV_HI16:                    howto manager.      (line  446)
12510* BFD_RELOC_FRV_LABEL16:                 howto manager.      (line  443)
12511* BFD_RELOC_FRV_LABEL24:                 howto manager.      (line  444)
12512* BFD_RELOC_FRV_LO16:                    howto manager.      (line  445)
12513* BFD_RELOC_FRV_TLSDESC_RELAX:           howto manager.      (line  478)
12514* BFD_RELOC_FRV_TLSDESC_VALUE:           howto manager.      (line  467)
12515* BFD_RELOC_FRV_TLSMOFF:                 howto manager.      (line  481)
12516* BFD_RELOC_FRV_TLSMOFF12:               howto manager.      (line  471)
12517* BFD_RELOC_FRV_TLSMOFFHI:               howto manager.      (line  472)
12518* BFD_RELOC_FRV_TLSMOFFLO:               howto manager.      (line  473)
12519* BFD_RELOC_FRV_TLSOFF:                  howto manager.      (line  477)
12520* BFD_RELOC_FRV_TLSOFF_RELAX:            howto manager.      (line  480)
12521* BFD_RELOC_FT32_10:                     howto manager.      (line  433)
12522* BFD_RELOC_FT32_15:                     howto manager.      (line  440)
12523* BFD_RELOC_FT32_17:                     howto manager.      (line  435)
12524* BFD_RELOC_FT32_18:                     howto manager.      (line  436)
12525* BFD_RELOC_FT32_20:                     howto manager.      (line  434)
12526* BFD_RELOC_FT32_DIFF32:                 howto manager.      (line  441)
12527* BFD_RELOC_FT32_RELAX:                  howto manager.      (line  437)
12528* BFD_RELOC_FT32_SC0:                    howto manager.      (line  438)
12529* BFD_RELOC_FT32_SC1:                    howto manager.      (line  439)
12530* BFD_RELOC_GPREL16:                     howto manager.      (line  114)
12531* BFD_RELOC_GPREL32:                     howto manager.      (line  115)
12532* BFD_RELOC_H8_DIR16A8:                  howto manager.      (line 2394)
12533* BFD_RELOC_H8_DIR16R8:                  howto manager.      (line 2395)
12534* BFD_RELOC_H8_DIR24A8:                  howto manager.      (line 2396)
12535* BFD_RELOC_H8_DIR24R8:                  howto manager.      (line 2397)
12536* BFD_RELOC_H8_DIR32A16:                 howto manager.      (line 2398)
12537* BFD_RELOC_H8_DISP32A16:                howto manager.      (line 2399)
12538* BFD_RELOC_HI16:                        howto manager.      (line  316)
12539* BFD_RELOC_HI16_BASEREL:                howto manager.      (line   94)
12540* BFD_RELOC_HI16_GOTOFF:                 howto manager.      (line   53)
12541* BFD_RELOC_HI16_PCREL:                  howto manager.      (line  325)
12542* BFD_RELOC_HI16_PLTOFF:                 howto manager.      (line   65)
12543* BFD_RELOC_HI16_S:                      howto manager.      (line  318)
12544* BFD_RELOC_HI16_S_BASEREL:              howto manager.      (line   95)
12545* BFD_RELOC_HI16_S_GOTOFF:               howto manager.      (line   54)
12546* BFD_RELOC_HI16_S_PCREL:                howto manager.      (line  327)
12547* BFD_RELOC_HI16_S_PLTOFF:               howto manager.      (line   66)
12548* BFD_RELOC_HI22:                        howto manager.      (line  110)
12549* BFD_RELOC_I370_D12:                    howto manager.      (line  730)
12550* BFD_RELOC_I960_CALLJ:                  howto manager.      (line  120)
12551* BFD_RELOC_IA64_COPY:                   howto manager.      (line 2097)
12552* BFD_RELOC_IA64_DIR32LSB:               howto manager.      (line 2042)
12553* BFD_RELOC_IA64_DIR32MSB:               howto manager.      (line 2041)
12554* BFD_RELOC_IA64_DIR64LSB:               howto manager.      (line 2044)
12555* BFD_RELOC_IA64_DIR64MSB:               howto manager.      (line 2043)
12556* BFD_RELOC_IA64_DTPMOD64LSB:            howto manager.      (line 2107)
12557* BFD_RELOC_IA64_DTPMOD64MSB:            howto manager.      (line 2106)
12558* BFD_RELOC_IA64_DTPREL14:               howto manager.      (line 2109)
12559* BFD_RELOC_IA64_DTPREL22:               howto manager.      (line 2110)
12560* BFD_RELOC_IA64_DTPREL32LSB:            howto manager.      (line 2113)
12561* BFD_RELOC_IA64_DTPREL32MSB:            howto manager.      (line 2112)
12562* BFD_RELOC_IA64_DTPREL64I:              howto manager.      (line 2111)
12563* BFD_RELOC_IA64_DTPREL64LSB:            howto manager.      (line 2115)
12564* BFD_RELOC_IA64_DTPREL64MSB:            howto manager.      (line 2114)
12565* BFD_RELOC_IA64_FPTR32LSB:              howto manager.      (line 2059)
12566* BFD_RELOC_IA64_FPTR32MSB:              howto manager.      (line 2058)
12567* BFD_RELOC_IA64_FPTR64I:                howto manager.      (line 2057)
12568* BFD_RELOC_IA64_FPTR64LSB:              howto manager.      (line 2061)
12569* BFD_RELOC_IA64_FPTR64MSB:              howto manager.      (line 2060)
12570* BFD_RELOC_IA64_GPREL22:                howto manager.      (line 2045)
12571* BFD_RELOC_IA64_GPREL32LSB:             howto manager.      (line 2048)
12572* BFD_RELOC_IA64_GPREL32MSB:             howto manager.      (line 2047)
12573* BFD_RELOC_IA64_GPREL64I:               howto manager.      (line 2046)
12574* BFD_RELOC_IA64_GPREL64LSB:             howto manager.      (line 2050)
12575* BFD_RELOC_IA64_GPREL64MSB:             howto manager.      (line 2049)
12576* BFD_RELOC_IA64_IMM14:                  howto manager.      (line 2038)
12577* BFD_RELOC_IA64_IMM22:                  howto manager.      (line 2039)
12578* BFD_RELOC_IA64_IMM64:                  howto manager.      (line 2040)
12579* BFD_RELOC_IA64_IPLTLSB:                howto manager.      (line 2096)
12580* BFD_RELOC_IA64_IPLTMSB:                howto manager.      (line 2095)
12581* BFD_RELOC_IA64_LDXMOV:                 howto manager.      (line 2099)
12582* BFD_RELOC_IA64_LTOFF22:                howto manager.      (line 2051)
12583* BFD_RELOC_IA64_LTOFF22X:               howto manager.      (line 2098)
12584* BFD_RELOC_IA64_LTOFF64I:               howto manager.      (line 2052)
12585* BFD_RELOC_IA64_LTOFF_DTPMOD22:         howto manager.      (line 2108)
12586* BFD_RELOC_IA64_LTOFF_DTPREL22:         howto manager.      (line 2116)
12587* BFD_RELOC_IA64_LTOFF_FPTR22:           howto manager.      (line 2073)
12588* BFD_RELOC_IA64_LTOFF_FPTR32LSB:        howto manager.      (line 2076)
12589* BFD_RELOC_IA64_LTOFF_FPTR32MSB:        howto manager.      (line 2075)
12590* BFD_RELOC_IA64_LTOFF_FPTR64I:          howto manager.      (line 2074)
12591* BFD_RELOC_IA64_LTOFF_FPTR64LSB:        howto manager.      (line 2078)
12592* BFD_RELOC_IA64_LTOFF_FPTR64MSB:        howto manager.      (line 2077)
12593* BFD_RELOC_IA64_LTOFF_TPREL22:          howto manager.      (line 2105)
12594* BFD_RELOC_IA64_LTV32LSB:               howto manager.      (line 2092)
12595* BFD_RELOC_IA64_LTV32MSB:               howto manager.      (line 2091)
12596* BFD_RELOC_IA64_LTV64LSB:               howto manager.      (line 2094)
12597* BFD_RELOC_IA64_LTV64MSB:               howto manager.      (line 2093)
12598* BFD_RELOC_IA64_PCREL21B:               howto manager.      (line 2062)
12599* BFD_RELOC_IA64_PCREL21BI:              howto manager.      (line 2063)
12600* BFD_RELOC_IA64_PCREL21F:               howto manager.      (line 2065)
12601* BFD_RELOC_IA64_PCREL21M:               howto manager.      (line 2064)
12602* BFD_RELOC_IA64_PCREL22:                howto manager.      (line 2066)
12603* BFD_RELOC_IA64_PCREL32LSB:             howto manager.      (line 2070)
12604* BFD_RELOC_IA64_PCREL32MSB:             howto manager.      (line 2069)
12605* BFD_RELOC_IA64_PCREL60B:               howto manager.      (line 2067)
12606* BFD_RELOC_IA64_PCREL64I:               howto manager.      (line 2068)
12607* BFD_RELOC_IA64_PCREL64LSB:             howto manager.      (line 2072)
12608* BFD_RELOC_IA64_PCREL64MSB:             howto manager.      (line 2071)
12609* BFD_RELOC_IA64_PLTOFF22:               howto manager.      (line 2053)
12610* BFD_RELOC_IA64_PLTOFF64I:              howto manager.      (line 2054)
12611* BFD_RELOC_IA64_PLTOFF64LSB:            howto manager.      (line 2056)
12612* BFD_RELOC_IA64_PLTOFF64MSB:            howto manager.      (line 2055)
12613* BFD_RELOC_IA64_REL32LSB:               howto manager.      (line 2088)
12614* BFD_RELOC_IA64_REL32MSB:               howto manager.      (line 2087)
12615* BFD_RELOC_IA64_REL64LSB:               howto manager.      (line 2090)
12616* BFD_RELOC_IA64_REL64MSB:               howto manager.      (line 2089)
12617* BFD_RELOC_IA64_SECREL32LSB:            howto manager.      (line 2084)
12618* BFD_RELOC_IA64_SECREL32MSB:            howto manager.      (line 2083)
12619* BFD_RELOC_IA64_SECREL64LSB:            howto manager.      (line 2086)
12620* BFD_RELOC_IA64_SECREL64MSB:            howto manager.      (line 2085)
12621* BFD_RELOC_IA64_SEGREL32LSB:            howto manager.      (line 2080)
12622* BFD_RELOC_IA64_SEGREL32MSB:            howto manager.      (line 2079)
12623* BFD_RELOC_IA64_SEGREL64LSB:            howto manager.      (line 2082)
12624* BFD_RELOC_IA64_SEGREL64MSB:            howto manager.      (line 2081)
12625* BFD_RELOC_IA64_TPREL14:                howto manager.      (line 2100)
12626* BFD_RELOC_IA64_TPREL22:                howto manager.      (line 2101)
12627* BFD_RELOC_IA64_TPREL64I:               howto manager.      (line 2102)
12628* BFD_RELOC_IA64_TPREL64LSB:             howto manager.      (line 2104)
12629* BFD_RELOC_IA64_TPREL64MSB:             howto manager.      (line 2103)
12630* BFD_RELOC_IP2K_ADDR16CJP:              howto manager.      (line 1999)
12631* BFD_RELOC_IP2K_BANK:                   howto manager.      (line 1997)
12632* BFD_RELOC_IP2K_EX8DATA:                howto manager.      (line 2005)
12633* BFD_RELOC_IP2K_FR9:                    howto manager.      (line 1995)
12634* BFD_RELOC_IP2K_FR_OFFSET:              howto manager.      (line 2014)
12635* BFD_RELOC_IP2K_HI8DATA:                howto manager.      (line 2004)
12636* BFD_RELOC_IP2K_HI8INSN:                howto manager.      (line 2008)
12637* BFD_RELOC_IP2K_LO8DATA:                howto manager.      (line 2003)
12638* BFD_RELOC_IP2K_LO8INSN:                howto manager.      (line 2007)
12639* BFD_RELOC_IP2K_PAGE3:                  howto manager.      (line 2001)
12640* BFD_RELOC_IP2K_PC_SKIP:                howto manager.      (line 2010)
12641* BFD_RELOC_IP2K_TEXT:                   howto manager.      (line 2012)
12642* BFD_RELOC_IQ2000_OFFSET_16:            howto manager.      (line 2533)
12643* BFD_RELOC_IQ2000_OFFSET_21:            howto manager.      (line 2534)
12644* BFD_RELOC_IQ2000_UHI16:                howto manager.      (line 2535)
12645* BFD_RELOC_LM32_16_GOT:                 howto manager.      (line 2625)
12646* BFD_RELOC_LM32_BRANCH:                 howto manager.      (line 2624)
12647* BFD_RELOC_LM32_CALL:                   howto manager.      (line 2623)
12648* BFD_RELOC_LM32_COPY:                   howto manager.      (line 2628)
12649* BFD_RELOC_LM32_GLOB_DAT:               howto manager.      (line 2629)
12650* BFD_RELOC_LM32_GOTOFF_HI16:            howto manager.      (line 2626)
12651* BFD_RELOC_LM32_GOTOFF_LO16:            howto manager.      (line 2627)
12652* BFD_RELOC_LM32_JMP_SLOT:               howto manager.      (line 2630)
12653* BFD_RELOC_LM32_RELATIVE:               howto manager.      (line 2631)
12654* BFD_RELOC_LO10:                        howto manager.      (line  111)
12655* BFD_RELOC_LO16:                        howto manager.      (line  323)
12656* BFD_RELOC_LO16_BASEREL:                howto manager.      (line   93)
12657* BFD_RELOC_LO16_GOTOFF:                 howto manager.      (line   52)
12658* BFD_RELOC_LO16_PCREL:                  howto manager.      (line  329)
12659* BFD_RELOC_LO16_PLTOFF:                 howto manager.      (line   64)
12660* BFD_RELOC_M32C_HI8:                    howto manager.      (line 1182)
12661* BFD_RELOC_M32C_RL_1ADDR:               howto manager.      (line 1184)
12662* BFD_RELOC_M32C_RL_2ADDR:               howto manager.      (line 1185)
12663* BFD_RELOC_M32C_RL_JUMP:                howto manager.      (line 1183)
12664* BFD_RELOC_M32R_10_PCREL:               howto manager.      (line 1190)
12665* BFD_RELOC_M32R_18_PCREL:               howto manager.      (line 1193)
12666* BFD_RELOC_M32R_24:                     howto manager.      (line 1187)
12667* BFD_RELOC_M32R_26_PCREL:               howto manager.      (line 1195)
12668* BFD_RELOC_M32R_26_PLTREL:              howto manager.      (line 1209)
12669* BFD_RELOC_M32R_COPY:                   howto manager.      (line 1210)
12670* BFD_RELOC_M32R_GLOB_DAT:               howto manager.      (line 1211)
12671* BFD_RELOC_M32R_GOT16_HI_SLO:           howto manager.      (line 1220)
12672* BFD_RELOC_M32R_GOT16_HI_ULO:           howto manager.      (line 1219)
12673* BFD_RELOC_M32R_GOT16_LO:               howto manager.      (line 1221)
12674* BFD_RELOC_M32R_GOT24:                  howto manager.      (line 1208)
12675* BFD_RELOC_M32R_GOTOFF:                 howto manager.      (line 1214)
12676* BFD_RELOC_M32R_GOTOFF_HI_SLO:          howto manager.      (line 1216)
12677* BFD_RELOC_M32R_GOTOFF_HI_ULO:          howto manager.      (line 1215)
12678* BFD_RELOC_M32R_GOTOFF_LO:              howto manager.      (line 1217)
12679* BFD_RELOC_M32R_GOTPC24:                howto manager.      (line 1218)
12680* BFD_RELOC_M32R_GOTPC_HI_SLO:           howto manager.      (line 1223)
12681* BFD_RELOC_M32R_GOTPC_HI_ULO:           howto manager.      (line 1222)
12682* BFD_RELOC_M32R_GOTPC_LO:               howto manager.      (line 1224)
12683* BFD_RELOC_M32R_HI16_SLO:               howto manager.      (line 1200)
12684* BFD_RELOC_M32R_HI16_ULO:               howto manager.      (line 1197)
12685* BFD_RELOC_M32R_JMP_SLOT:               howto manager.      (line 1212)
12686* BFD_RELOC_M32R_LO16:                   howto manager.      (line 1203)
12687* BFD_RELOC_M32R_RELATIVE:               howto manager.      (line 1213)
12688* BFD_RELOC_M32R_SDA16:                  howto manager.      (line 1205)
12689* BFD_RELOC_M68HC11_24:                  howto manager.      (line 2144)
12690* BFD_RELOC_M68HC11_3B:                  howto manager.      (line 2124)
12691* BFD_RELOC_M68HC11_HI8:                 howto manager.      (line 2118)
12692* BFD_RELOC_M68HC11_LO16:                howto manager.      (line 2135)
12693* BFD_RELOC_M68HC11_LO8:                 howto manager.      (line 2121)
12694* BFD_RELOC_M68HC11_PAGE:                howto manager.      (line 2140)
12695* BFD_RELOC_M68HC11_RL_GROUP:            howto manager.      (line 2131)
12696* BFD_RELOC_M68HC11_RL_JUMP:             howto manager.      (line 2126)
12697* BFD_RELOC_M68HC12_10_PCREL:            howto manager.      (line 2187)
12698* BFD_RELOC_M68HC12_16B:                 howto manager.      (line 2183)
12699* BFD_RELOC_M68HC12_5B:                  howto manager.      (line 2149)
12700* BFD_RELOC_M68HC12_9B:                  howto manager.      (line 2181)
12701* BFD_RELOC_M68HC12_9_PCREL:             howto manager.      (line 2185)
12702* BFD_RELOC_M68HC12_HI8XG:               howto manager.      (line 2192)
12703* BFD_RELOC_M68HC12_LO8XG:               howto manager.      (line 2189)
12704* BFD_RELOC_MACH_O_ARM64_ADDEND:         howto manager.      (line 2659)
12705* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21: howto manager.     (line 2661)
12706* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12: howto manager.  (line 2663)
12707* BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT: howto manager.      (line 2665)
12708* BFD_RELOC_MACH_O_LOCAL_SECTDIFF:       howto manager.      (line 2636)
12709* BFD_RELOC_MACH_O_PAIR:                 howto manager.      (line 2638)
12710* BFD_RELOC_MACH_O_SECTDIFF:             howto manager.      (line 2633)
12711* BFD_RELOC_MACH_O_SUBTRACTOR32:         howto manager.      (line 2640)
12712* BFD_RELOC_MACH_O_SUBTRACTOR64:         howto manager.      (line 2642)
12713* BFD_RELOC_MACH_O_X86_64_BRANCH32:      howto manager.      (line 2644)
12714* BFD_RELOC_MACH_O_X86_64_BRANCH8:       howto manager.      (line 2645)
12715* BFD_RELOC_MACH_O_X86_64_GOT:           howto manager.      (line 2648)
12716* BFD_RELOC_MACH_O_X86_64_GOT_LOAD:      howto manager.      (line 2650)
12717* BFD_RELOC_MACH_O_X86_64_PCREL32_1:     howto manager.      (line 2653)
12718* BFD_RELOC_MACH_O_X86_64_PCREL32_2:     howto manager.      (line 2655)
12719* BFD_RELOC_MACH_O_X86_64_PCREL32_4:     howto manager.      (line 2657)
12720* BFD_RELOC_MCORE_PCREL_32:              howto manager.      (line 1562)
12721* BFD_RELOC_MCORE_PCREL_IMM11BY2:        howto manager.      (line 1560)
12722* BFD_RELOC_MCORE_PCREL_IMM4BY2:         howto manager.      (line 1561)
12723* BFD_RELOC_MCORE_PCREL_IMM8BY4:         howto manager.      (line 1559)
12724* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2:    howto manager.      (line 1563)
12725* BFD_RELOC_MCORE_RVA:                   howto manager.      (line 1564)
12726* BFD_RELOC_MEP_16:                      howto manager.      (line 1567)
12727* BFD_RELOC_MEP_32:                      howto manager.      (line 1568)
12728* BFD_RELOC_MEP_8:                       howto manager.      (line 1566)
12729* BFD_RELOC_MEP_ADDR24A4:                howto manager.      (line 1583)
12730* BFD_RELOC_MEP_GNU_VTENTRY:             howto manager.      (line 1585)
12731* BFD_RELOC_MEP_GNU_VTINHERIT:           howto manager.      (line 1584)
12732* BFD_RELOC_MEP_GPREL:                   howto manager.      (line 1577)
12733* BFD_RELOC_MEP_HI16S:                   howto manager.      (line 1576)
12734* BFD_RELOC_MEP_HI16U:                   howto manager.      (line 1575)
12735* BFD_RELOC_MEP_LOW16:                   howto manager.      (line 1574)
12736* BFD_RELOC_MEP_PCABS24A2:               howto manager.      (line 1573)
12737* BFD_RELOC_MEP_PCREL12A2:               howto manager.      (line 1570)
12738* BFD_RELOC_MEP_PCREL17A2:               howto manager.      (line 1571)
12739* BFD_RELOC_MEP_PCREL24A2:               howto manager.      (line 1572)
12740* BFD_RELOC_MEP_PCREL8A2:                howto manager.      (line 1569)
12741* BFD_RELOC_MEP_TPREL:                   howto manager.      (line 1578)
12742* BFD_RELOC_MEP_TPREL7:                  howto manager.      (line 1579)
12743* BFD_RELOC_MEP_TPREL7A2:                howto manager.      (line 1580)
12744* BFD_RELOC_MEP_TPREL7A4:                howto manager.      (line 1581)
12745* BFD_RELOC_MEP_UIMM24:                  howto manager.      (line 1582)
12746* BFD_RELOC_METAG_COPY:                  howto manager.      (line 1606)
12747* BFD_RELOC_METAG_GETSETOFF:             howto manager.      (line 1590)
12748* BFD_RELOC_METAG_GETSET_GOT:            howto manager.      (line 1598)
12749* BFD_RELOC_METAG_GETSET_GOTOFF:         howto manager.      (line 1597)
12750* BFD_RELOC_METAG_GLOB_DAT:              howto manager.      (line 1609)
12751* BFD_RELOC_METAG_GOTOFF:                howto manager.      (line 1604)
12752* BFD_RELOC_METAG_HI16_GOTOFF:           howto manager.      (line 1595)
12753* BFD_RELOC_METAG_HI16_GOTPC:            howto manager.      (line 1599)
12754* BFD_RELOC_METAG_HI16_PLT:              howto manager.      (line 1601)
12755* BFD_RELOC_METAG_HIADDR16:              howto manager.      (line 1587)
12756* BFD_RELOC_METAG_HIOG:                  howto manager.      (line 1591)
12757* BFD_RELOC_METAG_JMP_SLOT:              howto manager.      (line 1607)
12758* BFD_RELOC_METAG_LO16_GOTOFF:           howto manager.      (line 1596)
12759* BFD_RELOC_METAG_LO16_GOTPC:            howto manager.      (line 1600)
12760* BFD_RELOC_METAG_LO16_PLT:              howto manager.      (line 1602)
12761* BFD_RELOC_METAG_LOADDR16:              howto manager.      (line 1588)
12762* BFD_RELOC_METAG_LOOG:                  howto manager.      (line 1592)
12763* BFD_RELOC_METAG_PLT:                   howto manager.      (line 1605)
12764* BFD_RELOC_METAG_REL16:                 howto manager.      (line 1594)
12765* BFD_RELOC_METAG_REL8:                  howto manager.      (line 1593)
12766* BFD_RELOC_METAG_RELATIVE:              howto manager.      (line 1608)
12767* BFD_RELOC_METAG_RELBRANCH:             howto manager.      (line 1589)
12768* BFD_RELOC_METAG_RELBRANCH_PLT:         howto manager.      (line 1603)
12769* BFD_RELOC_METAG_TLS_DTPMOD:            howto manager.      (line 1620)
12770* BFD_RELOC_METAG_TLS_DTPOFF:            howto manager.      (line 1621)
12771* BFD_RELOC_METAG_TLS_GD:                howto manager.      (line 1610)
12772* BFD_RELOC_METAG_TLS_IE:                howto manager.      (line 1615)
12773* BFD_RELOC_METAG_TLS_IENONPIC:          howto manager.      (line 1616)
12774* BFD_RELOC_METAG_TLS_IENONPIC_HI16:     howto manager.      (line 1617)
12775* BFD_RELOC_METAG_TLS_IENONPIC_LO16:     howto manager.      (line 1618)
12776* BFD_RELOC_METAG_TLS_LDM:               howto manager.      (line 1611)
12777* BFD_RELOC_METAG_TLS_LDO:               howto manager.      (line 1614)
12778* BFD_RELOC_METAG_TLS_LDO_HI16:          howto manager.      (line 1612)
12779* BFD_RELOC_METAG_TLS_LDO_LO16:          howto manager.      (line 1613)
12780* BFD_RELOC_METAG_TLS_LE:                howto manager.      (line 1622)
12781* BFD_RELOC_METAG_TLS_LE_HI16:           howto manager.      (line 1623)
12782* BFD_RELOC_METAG_TLS_LE_LO16:           howto manager.      (line 1624)
12783* BFD_RELOC_METAG_TLS_TPOFF:             howto manager.      (line 1619)
12784* BFD_RELOC_MICROBLAZE_32_GOTOFF:        howto manager.      (line 2701)
12785* BFD_RELOC_MICROBLAZE_32_LO:            howto manager.      (line 2667)
12786* BFD_RELOC_MICROBLAZE_32_LO_PCREL:      howto manager.      (line 2670)
12787* BFD_RELOC_MICROBLAZE_32_ROSDA:         howto manager.      (line 2673)
12788* BFD_RELOC_MICROBLAZE_32_RWSDA:         howto manager.      (line 2676)
12789* BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM:    howto manager.      (line 2679)
12790* BFD_RELOC_MICROBLAZE_32_TLSDTPMOD:     howto manager.      (line 2717)
12791* BFD_RELOC_MICROBLAZE_32_TLSDTPREL:     howto manager.      (line 2719)
12792* BFD_RELOC_MICROBLAZE_64_GOT:           howto manager.      (line 2690)
12793* BFD_RELOC_MICROBLAZE_64_GOTOFF:        howto manager.      (line 2697)
12794* BFD_RELOC_MICROBLAZE_64_GOTPC:         howto manager.      (line 2686)
12795* BFD_RELOC_MICROBLAZE_64_NONE:          howto manager.      (line 2682)
12796* BFD_RELOC_MICROBLAZE_64_PLT:           howto manager.      (line 2693)
12797* BFD_RELOC_MICROBLAZE_64_TLS:           howto manager.      (line 2707)
12798* BFD_RELOC_MICROBLAZE_64_TLSDTPREL:     howto manager.      (line 2721)
12799* BFD_RELOC_MICROBLAZE_64_TLSGD:         howto manager.      (line 2709)
12800* BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL:   howto manager.      (line 2724)
12801* BFD_RELOC_MICROBLAZE_64_TLSLD:         howto manager.      (line 2713)
12802* BFD_RELOC_MICROBLAZE_64_TLSTPREL:      howto manager.      (line 2727)
12803* BFD_RELOC_MICROBLAZE_COPY:             howto manager.      (line 2704)
12804* BFD_RELOC_MICROMIPS_10_PCREL_S1:       howto manager.      (line  356)
12805* BFD_RELOC_MICROMIPS_16_PCREL_S1:       howto manager.      (line  357)
12806* BFD_RELOC_MICROMIPS_7_PCREL_S1:        howto manager.      (line  355)
12807* BFD_RELOC_MICROMIPS_CALL16:            howto manager.      (line  374)
12808* BFD_RELOC_MICROMIPS_CALL_HI16:         howto manager.      (line  380)
12809* BFD_RELOC_MICROMIPS_CALL_LO16:         howto manager.      (line  382)
12810* BFD_RELOC_MICROMIPS_GOT16:             howto manager.      (line  372)
12811* BFD_RELOC_MICROMIPS_GOT_DISP:          howto manager.      (line  390)
12812* BFD_RELOC_MICROMIPS_GOT_HI16:          howto manager.      (line  376)
12813* BFD_RELOC_MICROMIPS_GOT_LO16:          howto manager.      (line  378)
12814* BFD_RELOC_MICROMIPS_GOT_OFST:          howto manager.      (line  388)
12815* BFD_RELOC_MICROMIPS_GOT_PAGE:          howto manager.      (line  386)
12816* BFD_RELOC_MICROMIPS_GPREL16:           howto manager.      (line  366)
12817* BFD_RELOC_MICROMIPS_HI16:              howto manager.      (line  367)
12818* BFD_RELOC_MICROMIPS_HI16_S:            howto manager.      (line  368)
12819* BFD_RELOC_MICROMIPS_HIGHER:            howto manager.      (line  399)
12820* BFD_RELOC_MICROMIPS_HIGHEST:           howto manager.      (line  397)
12821* BFD_RELOC_MICROMIPS_JALR:              howto manager.      (line  405)
12822* BFD_RELOC_MICROMIPS_JMP:               howto manager.      (line  310)
12823* BFD_RELOC_MICROMIPS_LITERAL:           howto manager.      (line  353)
12824* BFD_RELOC_MICROMIPS_LO16:              howto manager.      (line  369)
12825* BFD_RELOC_MICROMIPS_SCN_DISP:          howto manager.      (line  401)
12826* BFD_RELOC_MICROMIPS_SUB:               howto manager.      (line  384)
12827* BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16:   howto manager.      (line  415)
12828* BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16:   howto manager.      (line  417)
12829* BFD_RELOC_MICROMIPS_TLS_GD:            howto manager.      (line  411)
12830* BFD_RELOC_MICROMIPS_TLS_GOTTPREL:      howto manager.      (line  419)
12831* BFD_RELOC_MICROMIPS_TLS_LDM:           howto manager.      (line  413)
12832* BFD_RELOC_MICROMIPS_TLS_TPREL_HI16:    howto manager.      (line  423)
12833* BFD_RELOC_MICROMIPS_TLS_TPREL_LO16:    howto manager.      (line  425)
12834* BFD_RELOC_MIPS16_16_PCREL_S1:          howto manager.      (line  359)
12835* BFD_RELOC_MIPS16_CALL16:               howto manager.      (line  332)
12836* BFD_RELOC_MIPS16_GOT16:                howto manager.      (line  331)
12837* BFD_RELOC_MIPS16_GPREL:                howto manager.      (line  314)
12838* BFD_RELOC_MIPS16_HI16:                 howto manager.      (line  335)
12839* BFD_RELOC_MIPS16_HI16_S:               howto manager.      (line  337)
12840* BFD_RELOC_MIPS16_JMP:                  howto manager.      (line  312)
12841* BFD_RELOC_MIPS16_LO16:                 howto manager.      (line  342)
12842* BFD_RELOC_MIPS16_TLS_DTPREL_HI16:      howto manager.      (line  346)
12843* BFD_RELOC_MIPS16_TLS_DTPREL_LO16:      howto manager.      (line  347)
12844* BFD_RELOC_MIPS16_TLS_GD:               howto manager.      (line  344)
12845* BFD_RELOC_MIPS16_TLS_GOTTPREL:         howto manager.      (line  348)
12846* BFD_RELOC_MIPS16_TLS_LDM:              howto manager.      (line  345)
12847* BFD_RELOC_MIPS16_TLS_TPREL_HI16:       howto manager.      (line  349)
12848* BFD_RELOC_MIPS16_TLS_TPREL_LO16:       howto manager.      (line  350)
12849* BFD_RELOC_MIPS_18_PCREL_S3:            howto manager.      (line  363)
12850* BFD_RELOC_MIPS_19_PCREL_S2:            howto manager.      (line  364)
12851* BFD_RELOC_MIPS_21_PCREL_S2:            howto manager.      (line  361)
12852* BFD_RELOC_MIPS_26_PCREL_S2:            howto manager.      (line  362)
12853* BFD_RELOC_MIPS_CALL16:                 howto manager.      (line  373)
12854* BFD_RELOC_MIPS_CALL_HI16:              howto manager.      (line  379)
12855* BFD_RELOC_MIPS_CALL_LO16:              howto manager.      (line  381)
12856* BFD_RELOC_MIPS_COPY:                   howto manager.      (line  428)
12857* BFD_RELOC_MIPS_DELETE:                 howto manager.      (line  395)
12858* BFD_RELOC_MIPS_EH:                     howto manager.      (line  426)
12859* BFD_RELOC_MIPS_GOT16:                  howto manager.      (line  371)
12860* BFD_RELOC_MIPS_GOT_DISP:               howto manager.      (line  389)
12861* BFD_RELOC_MIPS_GOT_HI16:               howto manager.      (line  375)
12862* BFD_RELOC_MIPS_GOT_LO16:               howto manager.      (line  377)
12863* BFD_RELOC_MIPS_GOT_OFST:               howto manager.      (line  387)
12864* BFD_RELOC_MIPS_GOT_PAGE:               howto manager.      (line  385)
12865* BFD_RELOC_MIPS_HIGHER:                 howto manager.      (line  398)
12866* BFD_RELOC_MIPS_HIGHEST:                howto manager.      (line  396)
12867* BFD_RELOC_MIPS_INSERT_A:               howto manager.      (line  393)
12868* BFD_RELOC_MIPS_INSERT_B:               howto manager.      (line  394)
12869* BFD_RELOC_MIPS_JALR:                   howto manager.      (line  404)
12870* BFD_RELOC_MIPS_JMP:                    howto manager.      (line  309)
12871* BFD_RELOC_MIPS_JUMP_SLOT:              howto manager.      (line  429)
12872* BFD_RELOC_MIPS_LITERAL:                howto manager.      (line  352)
12873* BFD_RELOC_MIPS_REL16:                  howto manager.      (line  402)
12874* BFD_RELOC_MIPS_RELGOT:                 howto manager.      (line  403)
12875* BFD_RELOC_MIPS_SCN_DISP:               howto manager.      (line  400)
12876* BFD_RELOC_MIPS_SHIFT5:                 howto manager.      (line  391)
12877* BFD_RELOC_MIPS_SHIFT6:                 howto manager.      (line  392)
12878* BFD_RELOC_MIPS_SUB:                    howto manager.      (line  383)
12879* BFD_RELOC_MIPS_TLS_DTPMOD32:           howto manager.      (line  406)
12880* BFD_RELOC_MIPS_TLS_DTPMOD64:           howto manager.      (line  408)
12881* BFD_RELOC_MIPS_TLS_DTPREL32:           howto manager.      (line  407)
12882* BFD_RELOC_MIPS_TLS_DTPREL64:           howto manager.      (line  409)
12883* BFD_RELOC_MIPS_TLS_DTPREL_HI16:        howto manager.      (line  414)
12884* BFD_RELOC_MIPS_TLS_DTPREL_LO16:        howto manager.      (line  416)
12885* BFD_RELOC_MIPS_TLS_GD:                 howto manager.      (line  410)
12886* BFD_RELOC_MIPS_TLS_GOTTPREL:           howto manager.      (line  418)
12887* BFD_RELOC_MIPS_TLS_LDM:                howto manager.      (line  412)
12888* BFD_RELOC_MIPS_TLS_TPREL32:            howto manager.      (line  420)
12889* BFD_RELOC_MIPS_TLS_TPREL64:            howto manager.      (line  421)
12890* BFD_RELOC_MIPS_TLS_TPREL_HI16:         howto manager.      (line  422)
12891* BFD_RELOC_MIPS_TLS_TPREL_LO16:         howto manager.      (line  424)
12892* BFD_RELOC_MMIX_ADDR19:                 howto manager.      (line 1648)
12893* BFD_RELOC_MMIX_ADDR27:                 howto manager.      (line 1651)
12894* BFD_RELOC_MMIX_BASE_PLUS_OFFSET:       howto manager.      (line 1660)
12895* BFD_RELOC_MMIX_CBRANCH:                howto manager.      (line 1631)
12896* BFD_RELOC_MMIX_CBRANCH_1:              howto manager.      (line 1633)
12897* BFD_RELOC_MMIX_CBRANCH_2:              howto manager.      (line 1634)
12898* BFD_RELOC_MMIX_CBRANCH_3:              howto manager.      (line 1635)
12899* BFD_RELOC_MMIX_CBRANCH_J:              howto manager.      (line 1632)
12900* BFD_RELOC_MMIX_GETA:                   howto manager.      (line 1626)
12901* BFD_RELOC_MMIX_GETA_1:                 howto manager.      (line 1627)
12902* BFD_RELOC_MMIX_GETA_2:                 howto manager.      (line 1628)
12903* BFD_RELOC_MMIX_GETA_3:                 howto manager.      (line 1629)
12904* BFD_RELOC_MMIX_JMP:                    howto manager.      (line 1643)
12905* BFD_RELOC_MMIX_JMP_1:                  howto manager.      (line 1644)
12906* BFD_RELOC_MMIX_JMP_2:                  howto manager.      (line 1645)
12907* BFD_RELOC_MMIX_JMP_3:                  howto manager.      (line 1646)
12908* BFD_RELOC_MMIX_LOCAL:                  howto manager.      (line 1663)
12909* BFD_RELOC_MMIX_PUSHJ:                  howto manager.      (line 1637)
12910* BFD_RELOC_MMIX_PUSHJ_1:                howto manager.      (line 1638)
12911* BFD_RELOC_MMIX_PUSHJ_2:                howto manager.      (line 1639)
12912* BFD_RELOC_MMIX_PUSHJ_3:                howto manager.      (line 1640)
12913* BFD_RELOC_MMIX_PUSHJ_STUBBABLE:        howto manager.      (line 1641)
12914* BFD_RELOC_MMIX_REG:                    howto manager.      (line 1657)
12915* BFD_RELOC_MMIX_REG_OR_BYTE:            howto manager.      (line 1654)
12916* BFD_RELOC_MN10300_16_PCREL:            howto manager.      (line  522)
12917* BFD_RELOC_MN10300_32_PCREL:            howto manager.      (line  519)
12918* BFD_RELOC_MN10300_ALIGN:               howto manager.      (line  506)
12919* BFD_RELOC_MN10300_COPY:                howto manager.      (line  494)
12920* BFD_RELOC_MN10300_GLOB_DAT:            howto manager.      (line  496)
12921* BFD_RELOC_MN10300_GOT16:               howto manager.      (line  491)
12922* BFD_RELOC_MN10300_GOT24:               howto manager.      (line  488)
12923* BFD_RELOC_MN10300_GOT32:               howto manager.      (line  485)
12924* BFD_RELOC_MN10300_GOTOFF24:            howto manager.      (line  483)
12925* BFD_RELOC_MN10300_JMP_SLOT:            howto manager.      (line  498)
12926* BFD_RELOC_MN10300_RELATIVE:            howto manager.      (line  500)
12927* BFD_RELOC_MN10300_SYM_DIFF:            howto manager.      (line  502)
12928* BFD_RELOC_MN10300_TLS_DTPMOD:          howto manager.      (line  515)
12929* BFD_RELOC_MN10300_TLS_DTPOFF:          howto manager.      (line  516)
12930* BFD_RELOC_MN10300_TLS_GD:              howto manager.      (line  509)
12931* BFD_RELOC_MN10300_TLS_GOTIE:           howto manager.      (line  512)
12932* BFD_RELOC_MN10300_TLS_IE:              howto manager.      (line  513)
12933* BFD_RELOC_MN10300_TLS_LD:              howto manager.      (line  510)
12934* BFD_RELOC_MN10300_TLS_LDO:             howto manager.      (line  511)
12935* BFD_RELOC_MN10300_TLS_LE:              howto manager.      (line  514)
12936* BFD_RELOC_MN10300_TLS_TPOFF:           howto manager.      (line  517)
12937* BFD_RELOC_MOXIE_10_PCREL:              howto manager.      (line  431)
12938* BFD_RELOC_MSP430X_ABS16:               howto manager.      (line 2447)
12939* BFD_RELOC_MSP430X_ABS20_ADR_DST:       howto manager.      (line 2444)
12940* BFD_RELOC_MSP430X_ABS20_ADR_SRC:       howto manager.      (line 2443)
12941* BFD_RELOC_MSP430X_ABS20_EXT_DST:       howto manager.      (line 2441)
12942* BFD_RELOC_MSP430X_ABS20_EXT_ODST:      howto manager.      (line 2442)
12943* BFD_RELOC_MSP430X_ABS20_EXT_SRC:       howto manager.      (line 2440)
12944* BFD_RELOC_MSP430X_PCR16:               howto manager.      (line 2445)
12945* BFD_RELOC_MSP430X_PCR20_CALL:          howto manager.      (line 2446)
12946* BFD_RELOC_MSP430X_PCR20_EXT_DST:       howto manager.      (line 2438)
12947* BFD_RELOC_MSP430X_PCR20_EXT_ODST:      howto manager.      (line 2439)
12948* BFD_RELOC_MSP430X_PCR20_EXT_SRC:       howto manager.      (line 2437)
12949* BFD_RELOC_MSP430_10_PCREL:             howto manager.      (line 2429)
12950* BFD_RELOC_MSP430_16:                   howto manager.      (line 2431)
12951* BFD_RELOC_MSP430_16_BYTE:              howto manager.      (line 2433)
12952* BFD_RELOC_MSP430_16_PCREL:             howto manager.      (line 2430)
12953* BFD_RELOC_MSP430_16_PCREL_BYTE:        howto manager.      (line 2432)
12954* BFD_RELOC_MSP430_2X_PCREL:             howto manager.      (line 2434)
12955* BFD_RELOC_MSP430_ABS8:                 howto manager.      (line 2436)
12956* BFD_RELOC_MSP430_ABS_HI16:             howto manager.      (line 2448)
12957* BFD_RELOC_MSP430_PREL31:               howto manager.      (line 2449)
12958* BFD_RELOC_MSP430_RL_PCREL:             howto manager.      (line 2435)
12959* BFD_RELOC_MSP430_SYM_DIFF:             howto manager.      (line 2450)
12960* BFD_RELOC_MT_GNU_VTENTRY:              howto manager.      (line 2425)
12961* BFD_RELOC_MT_GNU_VTINHERIT:            howto manager.      (line 2423)
12962* BFD_RELOC_MT_HI16:                     howto manager.      (line 2419)
12963* BFD_RELOC_MT_LO16:                     howto manager.      (line 2421)
12964* BFD_RELOC_MT_PC16:                     howto manager.      (line 2417)
12965* BFD_RELOC_MT_PCINSN8:                  howto manager.      (line 2427)
12966* BFD_RELOC_NDS32_10IFCU_PCREL:          howto manager.      (line 1376)
12967* BFD_RELOC_NDS32_10_UPCREL:             howto manager.      (line 1347)
12968* BFD_RELOC_NDS32_15_FIXED:              howto manager.      (line 1308)
12969* BFD_RELOC_NDS32_15_PCREL:              howto manager.      (line 1234)
12970* BFD_RELOC_NDS32_17IFC_PCREL:           howto manager.      (line 1375)
12971* BFD_RELOC_NDS32_17_FIXED:              howto manager.      (line 1309)
12972* BFD_RELOC_NDS32_17_PCREL:              howto manager.      (line 1236)
12973* BFD_RELOC_NDS32_20:                    howto manager.      (line 1226)
12974* BFD_RELOC_NDS32_25_ABS:                howto manager.      (line 1371)
12975* BFD_RELOC_NDS32_25_FIXED:              howto manager.      (line 1310)
12976* BFD_RELOC_NDS32_25_PCREL:              howto manager.      (line 1238)
12977* BFD_RELOC_NDS32_25_PLTREL:             howto manager.      (line 1284)
12978* BFD_RELOC_NDS32_5:                     howto manager.      (line 1345)
12979* BFD_RELOC_NDS32_9_FIXED:               howto manager.      (line 1307)
12980* BFD_RELOC_NDS32_9_PCREL:               howto manager.      (line 1228)
12981* BFD_RELOC_NDS32_9_PLTREL:              howto manager.      (line 1283)
12982* BFD_RELOC_NDS32_COPY:                  howto manager.      (line 1285)
12983* BFD_RELOC_NDS32_DATA:                  howto manager.      (line 1373)
12984* BFD_RELOC_NDS32_DIFF16:                howto manager.      (line 1366)
12985* BFD_RELOC_NDS32_DIFF32:                howto manager.      (line 1367)
12986* BFD_RELOC_NDS32_DIFF8:                 howto manager.      (line 1365)
12987* BFD_RELOC_NDS32_DIFF_ULEB128:          howto manager.      (line 1368)
12988* BFD_RELOC_NDS32_DWARF2_LEB:            howto manager.      (line 1331)
12989* BFD_RELOC_NDS32_DWARF2_OP1:            howto manager.      (line 1329)
12990* BFD_RELOC_NDS32_DWARF2_OP2:            howto manager.      (line 1330)
12991* BFD_RELOC_NDS32_EMPTY:                 howto manager.      (line 1369)
12992* BFD_RELOC_NDS32_GLOB_DAT:              howto manager.      (line 1286)
12993* BFD_RELOC_NDS32_GOT15S2:               howto manager.      (line 1342)
12994* BFD_RELOC_NDS32_GOT17S2:               howto manager.      (line 1343)
12995* BFD_RELOC_NDS32_GOT20:                 howto manager.      (line 1282)
12996* BFD_RELOC_NDS32_GOTOFF:                howto manager.      (line 1289)
12997* BFD_RELOC_NDS32_GOTOFF_HI20:           howto manager.      (line 1290)
12998* BFD_RELOC_NDS32_GOTOFF_LO12:           howto manager.      (line 1291)
12999* BFD_RELOC_NDS32_GOTOFF_LO15:           howto manager.      (line 1340)
13000* BFD_RELOC_NDS32_GOTOFF_LO19:           howto manager.      (line 1341)
13001* BFD_RELOC_NDS32_GOTOFF_SUFF:           howto manager.      (line 1354)
13002* BFD_RELOC_NDS32_GOTPC20:               howto manager.      (line 1292)
13003* BFD_RELOC_NDS32_GOTPC_HI20:            howto manager.      (line 1295)
13004* BFD_RELOC_NDS32_GOTPC_LO12:            howto manager.      (line 1296)
13005* BFD_RELOC_NDS32_GOTTPOFF:              howto manager.      (line 1383)
13006* BFD_RELOC_NDS32_GOT_HI20:              howto manager.      (line 1293)
13007* BFD_RELOC_NDS32_GOT_LO12:              howto manager.      (line 1294)
13008* BFD_RELOC_NDS32_GOT_LO15:              howto manager.      (line 1338)
13009* BFD_RELOC_NDS32_GOT_LO19:              howto manager.      (line 1339)
13010* BFD_RELOC_NDS32_GOT_SUFF:              howto manager.      (line 1353)
13011* BFD_RELOC_NDS32_HI20:                  howto manager.      (line 1240)
13012* BFD_RELOC_NDS32_INSN16:                howto manager.      (line 1298)
13013* BFD_RELOC_NDS32_JMP_SLOT:              howto manager.      (line 1287)
13014* BFD_RELOC_NDS32_LABEL:                 howto manager.      (line 1299)
13015* BFD_RELOC_NDS32_LO12S0:                howto manager.      (line 1252)
13016* BFD_RELOC_NDS32_LO12S0_ORI:            howto manager.      (line 1255)
13017* BFD_RELOC_NDS32_LO12S1:                howto manager.      (line 1249)
13018* BFD_RELOC_NDS32_LO12S2:                howto manager.      (line 1246)
13019* BFD_RELOC_NDS32_LO12S2_DP:             howto manager.      (line 1326)
13020* BFD_RELOC_NDS32_LO12S2_SP:             howto manager.      (line 1327)
13021* BFD_RELOC_NDS32_LO12S3:                howto manager.      (line 1243)
13022* BFD_RELOC_NDS32_LOADSTORE:             howto manager.      (line 1306)
13023* BFD_RELOC_NDS32_LONGCALL1:             howto manager.      (line 1300)
13024* BFD_RELOC_NDS32_LONGCALL2:             howto manager.      (line 1301)
13025* BFD_RELOC_NDS32_LONGCALL3:             howto manager.      (line 1302)
13026* BFD_RELOC_NDS32_LONGCALL4:             howto manager.      (line 1311)
13027* BFD_RELOC_NDS32_LONGCALL5:             howto manager.      (line 1312)
13028* BFD_RELOC_NDS32_LONGCALL6:             howto manager.      (line 1313)
13029* BFD_RELOC_NDS32_LONGJUMP1:             howto manager.      (line 1303)
13030* BFD_RELOC_NDS32_LONGJUMP2:             howto manager.      (line 1304)
13031* BFD_RELOC_NDS32_LONGJUMP3:             howto manager.      (line 1305)
13032* BFD_RELOC_NDS32_LONGJUMP4:             howto manager.      (line 1314)
13033* BFD_RELOC_NDS32_LONGJUMP5:             howto manager.      (line 1315)
13034* BFD_RELOC_NDS32_LONGJUMP6:             howto manager.      (line 1316)
13035* BFD_RELOC_NDS32_LONGJUMP7:             howto manager.      (line 1317)
13036* BFD_RELOC_NDS32_MINUEND:               howto manager.      (line 1363)
13037* BFD_RELOC_NDS32_MULCALL_SUFF:          howto manager.      (line 1356)
13038* BFD_RELOC_NDS32_PLTBLOCK:              howto manager.      (line 1360)
13039* BFD_RELOC_NDS32_PLTREL_HI20:           howto manager.      (line 1319)
13040* BFD_RELOC_NDS32_PLTREL_LO12:           howto manager.      (line 1320)
13041* BFD_RELOC_NDS32_PLT_GOTREL_HI20:       howto manager.      (line 1321)
13042* BFD_RELOC_NDS32_PLT_GOTREL_LO12:       howto manager.      (line 1322)
13043* BFD_RELOC_NDS32_PLT_GOTREL_LO15:       howto manager.      (line 1336)
13044* BFD_RELOC_NDS32_PLT_GOTREL_LO19:       howto manager.      (line 1337)
13045* BFD_RELOC_NDS32_PLT_GOTREL_LO20:       howto manager.      (line 1335)
13046* BFD_RELOC_NDS32_PLT_GOT_SUFF:          howto manager.      (line 1355)
13047* BFD_RELOC_NDS32_PTR:                   howto manager.      (line 1357)
13048* BFD_RELOC_NDS32_PTR_COUNT:             howto manager.      (line 1358)
13049* BFD_RELOC_NDS32_PTR_RESOLVED:          howto manager.      (line 1359)
13050* BFD_RELOC_NDS32_RELATIVE:              howto manager.      (line 1288)
13051* BFD_RELOC_NDS32_RELAX_ENTRY:           howto manager.      (line 1352)
13052* BFD_RELOC_NDS32_RELAX_REGION_BEGIN:    howto manager.      (line 1361)
13053* BFD_RELOC_NDS32_RELAX_REGION_END:      howto manager.      (line 1362)
13054* BFD_RELOC_NDS32_SDA12S2_DP:            howto manager.      (line 1324)
13055* BFD_RELOC_NDS32_SDA12S2_SP:            howto manager.      (line 1325)
13056* BFD_RELOC_NDS32_SDA15S0:               howto manager.      (line 1267)
13057* BFD_RELOC_NDS32_SDA15S1:               howto manager.      (line 1264)
13058* BFD_RELOC_NDS32_SDA15S2:               howto manager.      (line 1261)
13059* BFD_RELOC_NDS32_SDA15S3:               howto manager.      (line 1258)
13060* BFD_RELOC_NDS32_SDA16S3:               howto manager.      (line 1270)
13061* BFD_RELOC_NDS32_SDA17S2:               howto manager.      (line 1273)
13062* BFD_RELOC_NDS32_SDA18S1:               howto manager.      (line 1276)
13063* BFD_RELOC_NDS32_SDA19S0:               howto manager.      (line 1279)
13064* BFD_RELOC_NDS32_SDA_FP7U2_RELA:        howto manager.      (line 1350)
13065* BFD_RELOC_NDS32_SUBTRAHEND:            howto manager.      (line 1364)
13066* BFD_RELOC_NDS32_TLS_IE_HI20:           howto manager.      (line 1384)
13067* BFD_RELOC_NDS32_TLS_IE_LO12S2:         howto manager.      (line 1385)
13068* BFD_RELOC_NDS32_TLS_LE_15S0:           howto manager.      (line 1388)
13069* BFD_RELOC_NDS32_TLS_LE_15S1:           howto manager.      (line 1389)
13070* BFD_RELOC_NDS32_TLS_LE_15S2:           howto manager.      (line 1390)
13071* BFD_RELOC_NDS32_TLS_LE_20:             howto manager.      (line 1387)
13072* BFD_RELOC_NDS32_TLS_LE_ADD:            howto manager.      (line 1381)
13073* BFD_RELOC_NDS32_TLS_LE_HI20:           howto manager.      (line 1379)
13074* BFD_RELOC_NDS32_TLS_LE_LO12:           howto manager.      (line 1380)
13075* BFD_RELOC_NDS32_TLS_LE_LS:             howto manager.      (line 1382)
13076* BFD_RELOC_NDS32_TLS_TPOFF:             howto manager.      (line 1386)
13077* BFD_RELOC_NDS32_TPOFF:                 howto manager.      (line 1378)
13078* BFD_RELOC_NDS32_TRAN:                  howto manager.      (line 1374)
13079* BFD_RELOC_NDS32_UPDATE_TA:             howto manager.      (line 1333)
13080* BFD_RELOC_NDS32_WORD_9_PCREL:          howto manager.      (line 1231)
13081* BFD_RELOC_NIOS2_ALIGN:                 howto manager.      (line 2466)
13082* BFD_RELOC_NIOS2_CACHE_OPX:             howto manager.      (line 2456)
13083* BFD_RELOC_NIOS2_CALL16:                howto manager.      (line 2468)
13084* BFD_RELOC_NIOS2_CALL26:                howto manager.      (line 2454)
13085* BFD_RELOC_NIOS2_CALL26_NOAT:           howto manager.      (line 2486)
13086* BFD_RELOC_NIOS2_CALLR:                 howto manager.      (line 2465)
13087* BFD_RELOC_NIOS2_CALL_HA:               howto manager.      (line 2490)
13088* BFD_RELOC_NIOS2_CALL_LO:               howto manager.      (line 2489)
13089* BFD_RELOC_NIOS2_CJMP:                  howto manager.      (line 2464)
13090* BFD_RELOC_NIOS2_COPY:                  howto manager.      (line 2481)
13091* BFD_RELOC_NIOS2_GLOB_DAT:              howto manager.      (line 2482)
13092* BFD_RELOC_NIOS2_GOT16:                 howto manager.      (line 2467)
13093* BFD_RELOC_NIOS2_GOTOFF:                howto manager.      (line 2485)
13094* BFD_RELOC_NIOS2_GOTOFF_HA:             howto manager.      (line 2470)
13095* BFD_RELOC_NIOS2_GOTOFF_LO:             howto manager.      (line 2469)
13096* BFD_RELOC_NIOS2_GOT_HA:                howto manager.      (line 2488)
13097* BFD_RELOC_NIOS2_GOT_LO:                howto manager.      (line 2487)
13098* BFD_RELOC_NIOS2_GPREL:                 howto manager.      (line 2462)
13099* BFD_RELOC_NIOS2_HI16:                  howto manager.      (line 2459)
13100* BFD_RELOC_NIOS2_HIADJ16:               howto manager.      (line 2461)
13101* BFD_RELOC_NIOS2_IMM5:                  howto manager.      (line 2455)
13102* BFD_RELOC_NIOS2_IMM6:                  howto manager.      (line 2457)
13103* BFD_RELOC_NIOS2_IMM8:                  howto manager.      (line 2458)
13104* BFD_RELOC_NIOS2_JUMP_SLOT:             howto manager.      (line 2483)
13105* BFD_RELOC_NIOS2_LO16:                  howto manager.      (line 2460)
13106* BFD_RELOC_NIOS2_PCREL_HA:              howto manager.      (line 2472)
13107* BFD_RELOC_NIOS2_PCREL_LO:              howto manager.      (line 2471)
13108* BFD_RELOC_NIOS2_R2_F1I5_2:             howto manager.      (line 2500)
13109* BFD_RELOC_NIOS2_R2_I10_1_PCREL:        howto manager.      (line 2492)
13110* BFD_RELOC_NIOS2_R2_L5I4X1:             howto manager.      (line 2501)
13111* BFD_RELOC_NIOS2_R2_S12:                howto manager.      (line 2491)
13112* BFD_RELOC_NIOS2_R2_T1I7_1_PCREL:       howto manager.      (line 2493)
13113* BFD_RELOC_NIOS2_R2_T1I7_2:             howto manager.      (line 2494)
13114* BFD_RELOC_NIOS2_R2_T1X1I6:             howto manager.      (line 2502)
13115* BFD_RELOC_NIOS2_R2_T1X1I6_2:           howto manager.      (line 2503)
13116* BFD_RELOC_NIOS2_R2_T2I4:               howto manager.      (line 2495)
13117* BFD_RELOC_NIOS2_R2_T2I4_1:             howto manager.      (line 2496)
13118* BFD_RELOC_NIOS2_R2_T2I4_2:             howto manager.      (line 2497)
13119* BFD_RELOC_NIOS2_R2_X1I7_2:             howto manager.      (line 2498)
13120* BFD_RELOC_NIOS2_R2_X2L5:               howto manager.      (line 2499)
13121* BFD_RELOC_NIOS2_RELATIVE:              howto manager.      (line 2484)
13122* BFD_RELOC_NIOS2_S16:                   howto manager.      (line 2452)
13123* BFD_RELOC_NIOS2_TLS_DTPMOD:            howto manager.      (line 2478)
13124* BFD_RELOC_NIOS2_TLS_DTPREL:            howto manager.      (line 2479)
13125* BFD_RELOC_NIOS2_TLS_GD16:              howto manager.      (line 2473)
13126* BFD_RELOC_NIOS2_TLS_IE16:              howto manager.      (line 2476)
13127* BFD_RELOC_NIOS2_TLS_LDM16:             howto manager.      (line 2474)
13128* BFD_RELOC_NIOS2_TLS_LDO16:             howto manager.      (line 2475)
13129* BFD_RELOC_NIOS2_TLS_LE16:              howto manager.      (line 2477)
13130* BFD_RELOC_NIOS2_TLS_TPREL:             howto manager.      (line 2480)
13131* BFD_RELOC_NIOS2_U16:                   howto manager.      (line 2453)
13132* BFD_RELOC_NIOS2_UJMP:                  howto manager.      (line 2463)
13133* BFD_RELOC_NONE:                        howto manager.      (line  122)
13134* BFD_RELOC_NS32K_DISP_16:               howto manager.      (line  590)
13135* BFD_RELOC_NS32K_DISP_16_PCREL:         howto manager.      (line  593)
13136* BFD_RELOC_NS32K_DISP_32:               howto manager.      (line  591)
13137* BFD_RELOC_NS32K_DISP_32_PCREL:         howto manager.      (line  594)
13138* BFD_RELOC_NS32K_DISP_8:                howto manager.      (line  589)
13139* BFD_RELOC_NS32K_DISP_8_PCREL:          howto manager.      (line  592)
13140* BFD_RELOC_NS32K_IMM_16:                howto manager.      (line  584)
13141* BFD_RELOC_NS32K_IMM_16_PCREL:          howto manager.      (line  587)
13142* BFD_RELOC_NS32K_IMM_32:                howto manager.      (line  585)
13143* BFD_RELOC_NS32K_IMM_32_PCREL:          howto manager.      (line  588)
13144* BFD_RELOC_NS32K_IMM_8:                 howto manager.      (line  583)
13145* BFD_RELOC_NS32K_IMM_8_PCREL:           howto manager.      (line  586)
13146* bfd_reloc_offset_in_range:             typedef arelent.    (line  370)
13147* BFD_RELOC_OR1K_COPY:                   howto manager.      (line 2376)
13148* BFD_RELOC_OR1K_GLOB_DAT:               howto manager.      (line 2377)
13149* BFD_RELOC_OR1K_GOT16:                  howto manager.      (line 2372)
13150* BFD_RELOC_OR1K_GOTOFF_HI16:            howto manager.      (line 2374)
13151* BFD_RELOC_OR1K_GOTOFF_LO16:            howto manager.      (line 2375)
13152* BFD_RELOC_OR1K_GOTPC_HI16:             howto manager.      (line 2370)
13153* BFD_RELOC_OR1K_GOTPC_LO16:             howto manager.      (line 2371)
13154* BFD_RELOC_OR1K_JMP_SLOT:               howto manager.      (line 2378)
13155* BFD_RELOC_OR1K_PLT26:                  howto manager.      (line 2373)
13156* BFD_RELOC_OR1K_RELATIVE:               howto manager.      (line 2379)
13157* BFD_RELOC_OR1K_REL_26:                 howto manager.      (line 2369)
13158* BFD_RELOC_OR1K_TLS_DTPMOD:             howto manager.      (line 2392)
13159* BFD_RELOC_OR1K_TLS_DTPOFF:             howto manager.      (line 2391)
13160* BFD_RELOC_OR1K_TLS_GD_HI16:            howto manager.      (line 2380)
13161* BFD_RELOC_OR1K_TLS_GD_LO16:            howto manager.      (line 2381)
13162* BFD_RELOC_OR1K_TLS_IE_HI16:            howto manager.      (line 2386)
13163* BFD_RELOC_OR1K_TLS_IE_LO16:            howto manager.      (line 2387)
13164* BFD_RELOC_OR1K_TLS_LDM_HI16:           howto manager.      (line 2382)
13165* BFD_RELOC_OR1K_TLS_LDM_LO16:           howto manager.      (line 2383)
13166* BFD_RELOC_OR1K_TLS_LDO_HI16:           howto manager.      (line 2384)
13167* BFD_RELOC_OR1K_TLS_LDO_LO16:           howto manager.      (line 2385)
13168* BFD_RELOC_OR1K_TLS_LE_HI16:            howto manager.      (line 2388)
13169* BFD_RELOC_OR1K_TLS_LE_LO16:            howto manager.      (line 2389)
13170* BFD_RELOC_OR1K_TLS_TPOFF:              howto manager.      (line 2390)
13171* BFD_RELOC_PDP11_DISP_6_PCREL:          howto manager.      (line  597)
13172* BFD_RELOC_PDP11_DISP_8_PCREL:          howto manager.      (line  596)
13173* BFD_RELOC_PJ_CODE_DIR16:               howto manager.      (line  601)
13174* BFD_RELOC_PJ_CODE_DIR32:               howto manager.      (line  602)
13175* BFD_RELOC_PJ_CODE_HI16:                howto manager.      (line  599)
13176* BFD_RELOC_PJ_CODE_LO16:                howto manager.      (line  600)
13177* BFD_RELOC_PJ_CODE_REL16:               howto manager.      (line  603)
13178* BFD_RELOC_PJ_CODE_REL32:               howto manager.      (line  604)
13179* BFD_RELOC_PPC64_ADDR16_DS:             howto manager.      (line  667)
13180* BFD_RELOC_PPC64_ADDR16_HIGH:           howto manager.      (line  678)
13181* BFD_RELOC_PPC64_ADDR16_HIGHA:          howto manager.      (line  679)
13182* BFD_RELOC_PPC64_ADDR16_LO_DS:          howto manager.      (line  668)
13183* BFD_RELOC_PPC64_ADDR64_LOCAL:          howto manager.      (line  680)
13184* BFD_RELOC_PPC64_DTPREL16_DS:           howto manager.      (line  719)
13185* BFD_RELOC_PPC64_DTPREL16_HIGH:         howto manager.      (line  727)
13186* BFD_RELOC_PPC64_DTPREL16_HIGHA:        howto manager.      (line  728)
13187* BFD_RELOC_PPC64_DTPREL16_HIGHER:       howto manager.      (line  721)
13188* BFD_RELOC_PPC64_DTPREL16_HIGHERA:      howto manager.      (line  722)
13189* BFD_RELOC_PPC64_DTPREL16_HIGHEST:      howto manager.      (line  723)
13190* BFD_RELOC_PPC64_DTPREL16_HIGHESTA:     howto manager.      (line  724)
13191* BFD_RELOC_PPC64_DTPREL16_LO_DS:        howto manager.      (line  720)
13192* BFD_RELOC_PPC64_ENTRY:                 howto manager.      (line  681)
13193* BFD_RELOC_PPC64_GOT16_DS:              howto manager.      (line  669)
13194* BFD_RELOC_PPC64_GOT16_LO_DS:           howto manager.      (line  670)
13195* BFD_RELOC_PPC64_HIGHER:                howto manager.      (line  655)
13196* BFD_RELOC_PPC64_HIGHER_S:              howto manager.      (line  656)
13197* BFD_RELOC_PPC64_HIGHEST:               howto manager.      (line  657)
13198* BFD_RELOC_PPC64_HIGHEST_S:             howto manager.      (line  658)
13199* BFD_RELOC_PPC64_PLT16_LO_DS:           howto manager.      (line  671)
13200* BFD_RELOC_PPC64_PLTGOT16:              howto manager.      (line  663)
13201* BFD_RELOC_PPC64_PLTGOT16_DS:           howto manager.      (line  676)
13202* BFD_RELOC_PPC64_PLTGOT16_HA:           howto manager.      (line  666)
13203* BFD_RELOC_PPC64_PLTGOT16_HI:           howto manager.      (line  665)
13204* BFD_RELOC_PPC64_PLTGOT16_LO:           howto manager.      (line  664)
13205* BFD_RELOC_PPC64_PLTGOT16_LO_DS:        howto manager.      (line  677)
13206* BFD_RELOC_PPC64_SECTOFF_DS:            howto manager.      (line  672)
13207* BFD_RELOC_PPC64_SECTOFF_LO_DS:         howto manager.      (line  673)
13208* BFD_RELOC_PPC64_TOC:                   howto manager.      (line  662)
13209* BFD_RELOC_PPC64_TOC16_DS:              howto manager.      (line  674)
13210* BFD_RELOC_PPC64_TOC16_HA:              howto manager.      (line  661)
13211* BFD_RELOC_PPC64_TOC16_HI:              howto manager.      (line  660)
13212* BFD_RELOC_PPC64_TOC16_LO:              howto manager.      (line  659)
13213* BFD_RELOC_PPC64_TOC16_LO_DS:           howto manager.      (line  675)
13214* BFD_RELOC_PPC64_TPREL16_DS:            howto manager.      (line  713)
13215* BFD_RELOC_PPC64_TPREL16_HIGH:          howto manager.      (line  725)
13216* BFD_RELOC_PPC64_TPREL16_HIGHA:         howto manager.      (line  726)
13217* BFD_RELOC_PPC64_TPREL16_HIGHER:        howto manager.      (line  715)
13218* BFD_RELOC_PPC64_TPREL16_HIGHERA:       howto manager.      (line  716)
13219* BFD_RELOC_PPC64_TPREL16_HIGHEST:       howto manager.      (line  717)
13220* BFD_RELOC_PPC64_TPREL16_HIGHESTA:      howto manager.      (line  718)
13221* BFD_RELOC_PPC64_TPREL16_LO_DS:         howto manager.      (line  714)
13222* BFD_RELOC_PPC_16DX_HA:                 howto manager.      (line  653)
13223* BFD_RELOC_PPC_B16:                     howto manager.      (line  609)
13224* BFD_RELOC_PPC_B16_BRNTAKEN:            howto manager.      (line  611)
13225* BFD_RELOC_PPC_B16_BRTAKEN:             howto manager.      (line  610)
13226* BFD_RELOC_PPC_B26:                     howto manager.      (line  606)
13227* BFD_RELOC_PPC_BA16:                    howto manager.      (line  612)
13228* BFD_RELOC_PPC_BA16_BRNTAKEN:           howto manager.      (line  614)
13229* BFD_RELOC_PPC_BA16_BRTAKEN:            howto manager.      (line  613)
13230* BFD_RELOC_PPC_BA26:                    howto manager.      (line  607)
13231* BFD_RELOC_PPC_COPY:                    howto manager.      (line  615)
13232* BFD_RELOC_PPC_DTPMOD:                  howto manager.      (line  686)
13233* BFD_RELOC_PPC_DTPREL:                  howto manager.      (line  696)
13234* BFD_RELOC_PPC_DTPREL16:                howto manager.      (line  692)
13235* BFD_RELOC_PPC_DTPREL16_HA:             howto manager.      (line  695)
13236* BFD_RELOC_PPC_DTPREL16_HI:             howto manager.      (line  694)
13237* BFD_RELOC_PPC_DTPREL16_LO:             howto manager.      (line  693)
13238* BFD_RELOC_PPC_EMB_BIT_FLD:             howto manager.      (line  634)
13239* BFD_RELOC_PPC_EMB_MRKREF:              howto manager.      (line  629)
13240* BFD_RELOC_PPC_EMB_NADDR16:             howto manager.      (line  621)
13241* BFD_RELOC_PPC_EMB_NADDR16_HA:          howto manager.      (line  624)
13242* BFD_RELOC_PPC_EMB_NADDR16_HI:          howto manager.      (line  623)
13243* BFD_RELOC_PPC_EMB_NADDR16_LO:          howto manager.      (line  622)
13244* BFD_RELOC_PPC_EMB_NADDR32:             howto manager.      (line  620)
13245* BFD_RELOC_PPC_EMB_RELSDA:              howto manager.      (line  635)
13246* BFD_RELOC_PPC_EMB_RELSEC16:            howto manager.      (line  630)
13247* BFD_RELOC_PPC_EMB_RELST_HA:            howto manager.      (line  633)
13248* BFD_RELOC_PPC_EMB_RELST_HI:            howto manager.      (line  632)
13249* BFD_RELOC_PPC_EMB_RELST_LO:            howto manager.      (line  631)
13250* BFD_RELOC_PPC_EMB_SDA21:               howto manager.      (line  628)
13251* BFD_RELOC_PPC_EMB_SDA2I16:             howto manager.      (line  626)
13252* BFD_RELOC_PPC_EMB_SDA2REL:             howto manager.      (line  627)
13253* BFD_RELOC_PPC_EMB_SDAI16:              howto manager.      (line  625)
13254* BFD_RELOC_PPC_GLOB_DAT:                howto manager.      (line  616)
13255* BFD_RELOC_PPC_GOT_DTPREL16:            howto manager.      (line  709)
13256* BFD_RELOC_PPC_GOT_DTPREL16_HA:         howto manager.      (line  712)
13257* BFD_RELOC_PPC_GOT_DTPREL16_HI:         howto manager.      (line  711)
13258* BFD_RELOC_PPC_GOT_DTPREL16_LO:         howto manager.      (line  710)
13259* BFD_RELOC_PPC_GOT_TLSGD16:             howto manager.      (line  697)
13260* BFD_RELOC_PPC_GOT_TLSGD16_HA:          howto manager.      (line  700)
13261* BFD_RELOC_PPC_GOT_TLSGD16_HI:          howto manager.      (line  699)
13262* BFD_RELOC_PPC_GOT_TLSGD16_LO:          howto manager.      (line  698)
13263* BFD_RELOC_PPC_GOT_TLSLD16:             howto manager.      (line  701)
13264* BFD_RELOC_PPC_GOT_TLSLD16_HA:          howto manager.      (line  704)
13265* BFD_RELOC_PPC_GOT_TLSLD16_HI:          howto manager.      (line  703)
13266* BFD_RELOC_PPC_GOT_TLSLD16_LO:          howto manager.      (line  702)
13267* BFD_RELOC_PPC_GOT_TPREL16:             howto manager.      (line  705)
13268* BFD_RELOC_PPC_GOT_TPREL16_HA:          howto manager.      (line  708)
13269* BFD_RELOC_PPC_GOT_TPREL16_HI:          howto manager.      (line  707)
13270* BFD_RELOC_PPC_GOT_TPREL16_LO:          howto manager.      (line  706)
13271* BFD_RELOC_PPC_JMP_SLOT:                howto manager.      (line  617)
13272* BFD_RELOC_PPC_LOCAL24PC:               howto manager.      (line  619)
13273* BFD_RELOC_PPC_REL16DX_HA:              howto manager.      (line  654)
13274* BFD_RELOC_PPC_RELATIVE:                howto manager.      (line  618)
13275* BFD_RELOC_PPC_TLS:                     howto manager.      (line  683)
13276* BFD_RELOC_PPC_TLSGD:                   howto manager.      (line  684)
13277* BFD_RELOC_PPC_TLSLD:                   howto manager.      (line  685)
13278* BFD_RELOC_PPC_TOC16:                   howto manager.      (line  608)
13279* BFD_RELOC_PPC_TPREL:                   howto manager.      (line  691)
13280* BFD_RELOC_PPC_TPREL16:                 howto manager.      (line  687)
13281* BFD_RELOC_PPC_TPREL16_HA:              howto manager.      (line  690)
13282* BFD_RELOC_PPC_TPREL16_HI:              howto manager.      (line  689)
13283* BFD_RELOC_PPC_TPREL16_LO:              howto manager.      (line  688)
13284* BFD_RELOC_PPC_VLE_HA16A:               howto manager.      (line  643)
13285* BFD_RELOC_PPC_VLE_HA16D:               howto manager.      (line  644)
13286* BFD_RELOC_PPC_VLE_HI16A:               howto manager.      (line  641)
13287* BFD_RELOC_PPC_VLE_HI16D:               howto manager.      (line  642)
13288* BFD_RELOC_PPC_VLE_LO16A:               howto manager.      (line  639)
13289* BFD_RELOC_PPC_VLE_LO16D:               howto manager.      (line  640)
13290* BFD_RELOC_PPC_VLE_REL15:               howto manager.      (line  637)
13291* BFD_RELOC_PPC_VLE_REL24:               howto manager.      (line  638)
13292* BFD_RELOC_PPC_VLE_REL8:                howto manager.      (line  636)
13293* BFD_RELOC_PPC_VLE_SDA21:               howto manager.      (line  645)
13294* BFD_RELOC_PPC_VLE_SDA21_LO:            howto manager.      (line  646)
13295* BFD_RELOC_PPC_VLE_SDAREL_HA16A:        howto manager.      (line  651)
13296* BFD_RELOC_PPC_VLE_SDAREL_HA16D:        howto manager.      (line  652)
13297* BFD_RELOC_PPC_VLE_SDAREL_HI16A:        howto manager.      (line  649)
13298* BFD_RELOC_PPC_VLE_SDAREL_HI16D:        howto manager.      (line  650)
13299* BFD_RELOC_PPC_VLE_SDAREL_LO16A:        howto manager.      (line  647)
13300* BFD_RELOC_PPC_VLE_SDAREL_LO16D:        howto manager.      (line  648)
13301* BFD_RELOC_PRU_16_PMEM:                 howto manager.      (line 2518)
13302* BFD_RELOC_PRU_32_PMEM:                 howto manager.      (line 2517)
13303* BFD_RELOC_PRU_GNU_DIFF16:              howto manager.      (line 2522)
13304* BFD_RELOC_PRU_GNU_DIFF16_PMEM:         howto manager.      (line 2524)
13305* BFD_RELOC_PRU_GNU_DIFF32:              howto manager.      (line 2523)
13306* BFD_RELOC_PRU_GNU_DIFF32_PMEM:         howto manager.      (line 2525)
13307* BFD_RELOC_PRU_GNU_DIFF8:               howto manager.      (line 2521)
13308* BFD_RELOC_PRU_LDI32:                   howto manager.      (line 2509)
13309* BFD_RELOC_PRU_S10_PCREL:               howto manager.      (line 2513)
13310* BFD_RELOC_PRU_U16:                     howto manager.      (line 2505)
13311* BFD_RELOC_PRU_U16_PMEMIMM:             howto manager.      (line 2507)
13312* BFD_RELOC_PRU_U8_PCREL:                howto manager.      (line 2515)
13313* BFD_RELOC_RELC:                        howto manager.      (line 2406)
13314* BFD_RELOC_RISCV_32_PCREL:              howto manager.      (line 1820)
13315* BFD_RELOC_RISCV_ADD16:                 howto manager.      (line 1788)
13316* BFD_RELOC_RISCV_ADD32:                 howto manager.      (line 1789)
13317* BFD_RELOC_RISCV_ADD64:                 howto manager.      (line 1790)
13318* BFD_RELOC_RISCV_ADD8:                  howto manager.      (line 1787)
13319* BFD_RELOC_RISCV_ALIGN:                 howto manager.      (line 1805)
13320* BFD_RELOC_RISCV_CALL:                  howto manager.      (line 1785)
13321* BFD_RELOC_RISCV_CALL_PLT:              howto manager.      (line 1786)
13322* BFD_RELOC_RISCV_CFA:                   howto manager.      (line 1814)
13323* BFD_RELOC_RISCV_GOT_HI20:              howto manager.      (line 1795)
13324* BFD_RELOC_RISCV_GPREL12_I:             howto manager.      (line 1779)
13325* BFD_RELOC_RISCV_GPREL12_S:             howto manager.      (line 1780)
13326* BFD_RELOC_RISCV_GPREL_I:               howto manager.      (line 1809)
13327* BFD_RELOC_RISCV_GPREL_S:               howto manager.      (line 1810)
13328* BFD_RELOC_RISCV_HI20:                  howto manager.      (line 1773)
13329* BFD_RELOC_RISCV_JMP:                   howto manager.      (line 1798)
13330* BFD_RELOC_RISCV_LO12_I:                howto manager.      (line 1777)
13331* BFD_RELOC_RISCV_LO12_S:                howto manager.      (line 1778)
13332* BFD_RELOC_RISCV_PCREL_HI20:            howto manager.      (line 1774)
13333* BFD_RELOC_RISCV_PCREL_LO12_I:          howto manager.      (line 1775)
13334* BFD_RELOC_RISCV_PCREL_LO12_S:          howto manager.      (line 1776)
13335* BFD_RELOC_RISCV_RELAX:                 howto manager.      (line 1813)
13336* BFD_RELOC_RISCV_RVC_BRANCH:            howto manager.      (line 1806)
13337* BFD_RELOC_RISCV_RVC_JUMP:              howto manager.      (line 1807)
13338* BFD_RELOC_RISCV_RVC_LUI:               howto manager.      (line 1808)
13339* BFD_RELOC_RISCV_SET16:                 howto manager.      (line 1818)
13340* BFD_RELOC_RISCV_SET32:                 howto manager.      (line 1819)
13341* BFD_RELOC_RISCV_SET6:                  howto manager.      (line 1816)
13342* BFD_RELOC_RISCV_SET8:                  howto manager.      (line 1817)
13343* BFD_RELOC_RISCV_SUB16:                 howto manager.      (line 1792)
13344* BFD_RELOC_RISCV_SUB32:                 howto manager.      (line 1793)
13345* BFD_RELOC_RISCV_SUB6:                  howto manager.      (line 1815)
13346* BFD_RELOC_RISCV_SUB64:                 howto manager.      (line 1794)
13347* BFD_RELOC_RISCV_SUB8:                  howto manager.      (line 1791)
13348* BFD_RELOC_RISCV_TLS_DTPMOD32:          howto manager.      (line 1799)
13349* BFD_RELOC_RISCV_TLS_DTPMOD64:          howto manager.      (line 1801)
13350* BFD_RELOC_RISCV_TLS_DTPREL32:          howto manager.      (line 1800)
13351* BFD_RELOC_RISCV_TLS_DTPREL64:          howto manager.      (line 1802)
13352* BFD_RELOC_RISCV_TLS_GD_HI20:           howto manager.      (line 1797)
13353* BFD_RELOC_RISCV_TLS_GOT_HI20:          howto manager.      (line 1796)
13354* BFD_RELOC_RISCV_TLS_TPREL32:           howto manager.      (line 1803)
13355* BFD_RELOC_RISCV_TLS_TPREL64:           howto manager.      (line 1804)
13356* BFD_RELOC_RISCV_TPREL_ADD:             howto manager.      (line 1784)
13357* BFD_RELOC_RISCV_TPREL_HI20:            howto manager.      (line 1781)
13358* BFD_RELOC_RISCV_TPREL_I:               howto manager.      (line 1811)
13359* BFD_RELOC_RISCV_TPREL_LO12_I:          howto manager.      (line 1782)
13360* BFD_RELOC_RISCV_TPREL_LO12_S:          howto manager.      (line 1783)
13361* BFD_RELOC_RISCV_TPREL_S:               howto manager.      (line 1812)
13362* BFD_RELOC_RL78_16U:                    howto manager.      (line 1830)
13363* BFD_RELOC_RL78_16_OP:                  howto manager.      (line 1826)
13364* BFD_RELOC_RL78_24U:                    howto manager.      (line 1831)
13365* BFD_RELOC_RL78_24_OP:                  howto manager.      (line 1827)
13366* BFD_RELOC_RL78_32_OP:                  howto manager.      (line 1828)
13367* BFD_RELOC_RL78_8U:                     howto manager.      (line 1829)
13368* BFD_RELOC_RL78_ABS16:                  howto manager.      (line 1843)
13369* BFD_RELOC_RL78_ABS16U:                 howto manager.      (line 1847)
13370* BFD_RELOC_RL78_ABS16UL:                howto manager.      (line 1849)
13371* BFD_RELOC_RL78_ABS16UW:                howto manager.      (line 1848)
13372* BFD_RELOC_RL78_ABS16_REV:              howto manager.      (line 1844)
13373* BFD_RELOC_RL78_ABS32:                  howto manager.      (line 1845)
13374* BFD_RELOC_RL78_ABS32_REV:              howto manager.      (line 1846)
13375* BFD_RELOC_RL78_ABS8:                   howto manager.      (line 1842)
13376* BFD_RELOC_RL78_CODE:                   howto manager.      (line 1854)
13377* BFD_RELOC_RL78_DIFF:                   howto manager.      (line 1833)
13378* BFD_RELOC_RL78_DIR3U_PCREL:            howto manager.      (line 1832)
13379* BFD_RELOC_RL78_GPRELB:                 howto manager.      (line 1834)
13380* BFD_RELOC_RL78_GPRELL:                 howto manager.      (line 1836)
13381* BFD_RELOC_RL78_GPRELW:                 howto manager.      (line 1835)
13382* BFD_RELOC_RL78_HI16:                   howto manager.      (line 1851)
13383* BFD_RELOC_RL78_HI8:                    howto manager.      (line 1852)
13384* BFD_RELOC_RL78_LO16:                   howto manager.      (line 1853)
13385* BFD_RELOC_RL78_NEG16:                  howto manager.      (line 1823)
13386* BFD_RELOC_RL78_NEG24:                  howto manager.      (line 1824)
13387* BFD_RELOC_RL78_NEG32:                  howto manager.      (line 1825)
13388* BFD_RELOC_RL78_NEG8:                   howto manager.      (line 1822)
13389* BFD_RELOC_RL78_OP_AND:                 howto manager.      (line 1840)
13390* BFD_RELOC_RL78_OP_NEG:                 howto manager.      (line 1839)
13391* BFD_RELOC_RL78_OP_SHRA:                howto manager.      (line 1841)
13392* BFD_RELOC_RL78_OP_SUBTRACT:            howto manager.      (line 1838)
13393* BFD_RELOC_RL78_RELAX:                  howto manager.      (line 1850)
13394* BFD_RELOC_RL78_SADDR:                  howto manager.      (line 1855)
13395* BFD_RELOC_RL78_SYM:                    howto manager.      (line 1837)
13396* BFD_RELOC_RVA:                         howto manager.      (line   97)
13397* BFD_RELOC_RX_16U:                      howto manager.      (line 1865)
13398* BFD_RELOC_RX_16_OP:                    howto manager.      (line 1861)
13399* BFD_RELOC_RX_24U:                      howto manager.      (line 1866)
13400* BFD_RELOC_RX_24_OP:                    howto manager.      (line 1862)
13401* BFD_RELOC_RX_32_OP:                    howto manager.      (line 1863)
13402* BFD_RELOC_RX_8U:                       howto manager.      (line 1864)
13403* BFD_RELOC_RX_ABS16:                    howto manager.      (line 1876)
13404* BFD_RELOC_RX_ABS16U:                   howto manager.      (line 1880)
13405* BFD_RELOC_RX_ABS16UL:                  howto manager.      (line 1882)
13406* BFD_RELOC_RX_ABS16UW:                  howto manager.      (line 1881)
13407* BFD_RELOC_RX_ABS16_REV:                howto manager.      (line 1877)
13408* BFD_RELOC_RX_ABS32:                    howto manager.      (line 1878)
13409* BFD_RELOC_RX_ABS32_REV:                howto manager.      (line 1879)
13410* BFD_RELOC_RX_ABS8:                     howto manager.      (line 1875)
13411* BFD_RELOC_RX_DIFF:                     howto manager.      (line 1868)
13412* BFD_RELOC_RX_DIR3U_PCREL:              howto manager.      (line 1867)
13413* BFD_RELOC_RX_GPRELB:                   howto manager.      (line 1869)
13414* BFD_RELOC_RX_GPRELL:                   howto manager.      (line 1871)
13415* BFD_RELOC_RX_GPRELW:                   howto manager.      (line 1870)
13416* BFD_RELOC_RX_NEG16:                    howto manager.      (line 1858)
13417* BFD_RELOC_RX_NEG24:                    howto manager.      (line 1859)
13418* BFD_RELOC_RX_NEG32:                    howto manager.      (line 1860)
13419* BFD_RELOC_RX_NEG8:                     howto manager.      (line 1857)
13420* BFD_RELOC_RX_OP_NEG:                   howto manager.      (line 1874)
13421* BFD_RELOC_RX_OP_SUBTRACT:              howto manager.      (line 1873)
13422* BFD_RELOC_RX_RELAX:                    howto manager.      (line 1883)
13423* BFD_RELOC_RX_SYM:                      howto manager.      (line 1872)
13424* BFD_RELOC_SCORE16_BRANCH:              howto manager.      (line 1986)
13425* BFD_RELOC_SCORE16_JMP:                 howto manager.      (line 1984)
13426* BFD_RELOC_SCORE_BCMP:                  howto manager.      (line 1988)
13427* BFD_RELOC_SCORE_BRANCH:                howto manager.      (line 1978)
13428* BFD_RELOC_SCORE_CALL15:                howto manager.      (line 1992)
13429* BFD_RELOC_SCORE_DUMMY2:                howto manager.      (line 1975)
13430* BFD_RELOC_SCORE_DUMMY_HI16:            howto manager.      (line 1993)
13431* BFD_RELOC_SCORE_GOT15:                 howto manager.      (line 1990)
13432* BFD_RELOC_SCORE_GOT_LO16:              howto manager.      (line 1991)
13433* BFD_RELOC_SCORE_GPREL15:               howto manager.      (line 1973)
13434* BFD_RELOC_SCORE_IMM30:                 howto manager.      (line 1980)
13435* BFD_RELOC_SCORE_IMM32:                 howto manager.      (line 1982)
13436* BFD_RELOC_SCORE_JMP:                   howto manager.      (line 1976)
13437* BFD_RELOC_SH_ALIGN:                    howto manager.      (line  904)
13438* BFD_RELOC_SH_CODE:                     howto manager.      (line  905)
13439* BFD_RELOC_SH_COPY:                     howto manager.      (line  910)
13440* BFD_RELOC_SH_COPY64:                   howto manager.      (line  935)
13441* BFD_RELOC_SH_COUNT:                    howto manager.      (line  903)
13442* BFD_RELOC_SH_DATA:                     howto manager.      (line  906)
13443* BFD_RELOC_SH_DISP12:                   howto manager.      (line  886)
13444* BFD_RELOC_SH_DISP12BY2:                howto manager.      (line  887)
13445* BFD_RELOC_SH_DISP12BY4:                howto manager.      (line  888)
13446* BFD_RELOC_SH_DISP12BY8:                howto manager.      (line  889)
13447* BFD_RELOC_SH_DISP20:                   howto manager.      (line  890)
13448* BFD_RELOC_SH_DISP20BY8:                howto manager.      (line  891)
13449* BFD_RELOC_SH_FUNCDESC:                 howto manager.      (line  978)
13450* BFD_RELOC_SH_GLOB_DAT:                 howto manager.      (line  911)
13451* BFD_RELOC_SH_GLOB_DAT64:               howto manager.      (line  936)
13452* BFD_RELOC_SH_GOT10BY4:                 howto manager.      (line  939)
13453* BFD_RELOC_SH_GOT10BY8:                 howto manager.      (line  940)
13454* BFD_RELOC_SH_GOT20:                    howto manager.      (line  972)
13455* BFD_RELOC_SH_GOTFUNCDESC:              howto manager.      (line  974)
13456* BFD_RELOC_SH_GOTFUNCDESC20:            howto manager.      (line  975)
13457* BFD_RELOC_SH_GOTOFF20:                 howto manager.      (line  973)
13458* BFD_RELOC_SH_GOTOFFFUNCDESC:           howto manager.      (line  976)
13459* BFD_RELOC_SH_GOTOFFFUNCDESC20:         howto manager.      (line  977)
13460* BFD_RELOC_SH_GOTOFF_HI16:              howto manager.      (line  930)
13461* BFD_RELOC_SH_GOTOFF_LOW16:             howto manager.      (line  927)
13462* BFD_RELOC_SH_GOTOFF_MEDHI16:           howto manager.      (line  929)
13463* BFD_RELOC_SH_GOTOFF_MEDLOW16:          howto manager.      (line  928)
13464* BFD_RELOC_SH_GOTPC:                    howto manager.      (line  914)
13465* BFD_RELOC_SH_GOTPC_HI16:               howto manager.      (line  934)
13466* BFD_RELOC_SH_GOTPC_LOW16:              howto manager.      (line  931)
13467* BFD_RELOC_SH_GOTPC_MEDHI16:            howto manager.      (line  933)
13468* BFD_RELOC_SH_GOTPC_MEDLOW16:           howto manager.      (line  932)
13469* BFD_RELOC_SH_GOTPLT10BY4:              howto manager.      (line  941)
13470* BFD_RELOC_SH_GOTPLT10BY8:              howto manager.      (line  942)
13471* BFD_RELOC_SH_GOTPLT32:                 howto manager.      (line  943)
13472* BFD_RELOC_SH_GOTPLT_HI16:              howto manager.      (line  922)
13473* BFD_RELOC_SH_GOTPLT_LOW16:             howto manager.      (line  919)
13474* BFD_RELOC_SH_GOTPLT_MEDHI16:           howto manager.      (line  921)
13475* BFD_RELOC_SH_GOTPLT_MEDLOW16:          howto manager.      (line  920)
13476* BFD_RELOC_SH_GOT_HI16:                 howto manager.      (line  918)
13477* BFD_RELOC_SH_GOT_LOW16:                howto manager.      (line  915)
13478* BFD_RELOC_SH_GOT_MEDHI16:              howto manager.      (line  917)
13479* BFD_RELOC_SH_GOT_MEDLOW16:             howto manager.      (line  916)
13480* BFD_RELOC_SH_IMM3:                     howto manager.      (line  884)
13481* BFD_RELOC_SH_IMM3U:                    howto manager.      (line  885)
13482* BFD_RELOC_SH_IMM4:                     howto manager.      (line  892)
13483* BFD_RELOC_SH_IMM4BY2:                  howto manager.      (line  893)
13484* BFD_RELOC_SH_IMM4BY4:                  howto manager.      (line  894)
13485* BFD_RELOC_SH_IMM8:                     howto manager.      (line  895)
13486* BFD_RELOC_SH_IMM8BY2:                  howto manager.      (line  896)
13487* BFD_RELOC_SH_IMM8BY4:                  howto manager.      (line  897)
13488* BFD_RELOC_SH_IMMS10:                   howto manager.      (line  949)
13489* BFD_RELOC_SH_IMMS10BY2:                howto manager.      (line  950)
13490* BFD_RELOC_SH_IMMS10BY4:                howto manager.      (line  951)
13491* BFD_RELOC_SH_IMMS10BY8:                howto manager.      (line  952)
13492* BFD_RELOC_SH_IMMS16:                   howto manager.      (line  953)
13493* BFD_RELOC_SH_IMMS6:                    howto manager.      (line  946)
13494* BFD_RELOC_SH_IMMS6BY32:                howto manager.      (line  947)
13495* BFD_RELOC_SH_IMMU16:                   howto manager.      (line  954)
13496* BFD_RELOC_SH_IMMU5:                    howto manager.      (line  945)
13497* BFD_RELOC_SH_IMMU6:                    howto manager.      (line  948)
13498* BFD_RELOC_SH_IMM_HI16:                 howto manager.      (line  961)
13499* BFD_RELOC_SH_IMM_HI16_PCREL:           howto manager.      (line  962)
13500* BFD_RELOC_SH_IMM_LOW16:                howto manager.      (line  955)
13501* BFD_RELOC_SH_IMM_LOW16_PCREL:          howto manager.      (line  956)
13502* BFD_RELOC_SH_IMM_MEDHI16:              howto manager.      (line  959)
13503* BFD_RELOC_SH_IMM_MEDHI16_PCREL:        howto manager.      (line  960)
13504* BFD_RELOC_SH_IMM_MEDLOW16:             howto manager.      (line  957)
13505* BFD_RELOC_SH_IMM_MEDLOW16_PCREL:       howto manager.      (line  958)
13506* BFD_RELOC_SH_JMP_SLOT:                 howto manager.      (line  912)
13507* BFD_RELOC_SH_JMP_SLOT64:               howto manager.      (line  937)
13508* BFD_RELOC_SH_LABEL:                    howto manager.      (line  907)
13509* BFD_RELOC_SH_LOOP_END:                 howto manager.      (line  909)
13510* BFD_RELOC_SH_LOOP_START:               howto manager.      (line  908)
13511* BFD_RELOC_SH_PCDISP12BY2:              howto manager.      (line  883)
13512* BFD_RELOC_SH_PCDISP8BY2:               howto manager.      (line  882)
13513* BFD_RELOC_SH_PCRELIMM8BY2:             howto manager.      (line  898)
13514* BFD_RELOC_SH_PCRELIMM8BY4:             howto manager.      (line  899)
13515* BFD_RELOC_SH_PLT_HI16:                 howto manager.      (line  926)
13516* BFD_RELOC_SH_PLT_LOW16:                howto manager.      (line  923)
13517* BFD_RELOC_SH_PLT_MEDHI16:              howto manager.      (line  925)
13518* BFD_RELOC_SH_PLT_MEDLOW16:             howto manager.      (line  924)
13519* BFD_RELOC_SH_PT_16:                    howto manager.      (line  963)
13520* BFD_RELOC_SH_RELATIVE:                 howto manager.      (line  913)
13521* BFD_RELOC_SH_RELATIVE64:               howto manager.      (line  938)
13522* BFD_RELOC_SH_SHMEDIA_CODE:             howto manager.      (line  944)
13523* BFD_RELOC_SH_SWITCH16:                 howto manager.      (line  900)
13524* BFD_RELOC_SH_SWITCH32:                 howto manager.      (line  901)
13525* BFD_RELOC_SH_TLS_DTPMOD32:             howto manager.      (line  969)
13526* BFD_RELOC_SH_TLS_DTPOFF32:             howto manager.      (line  970)
13527* BFD_RELOC_SH_TLS_GD_32:                howto manager.      (line  964)
13528* BFD_RELOC_SH_TLS_IE_32:                howto manager.      (line  967)
13529* BFD_RELOC_SH_TLS_LDO_32:               howto manager.      (line  966)
13530* BFD_RELOC_SH_TLS_LD_32:                howto manager.      (line  965)
13531* BFD_RELOC_SH_TLS_LE_32:                howto manager.      (line  968)
13532* BFD_RELOC_SH_TLS_TPOFF32:              howto manager.      (line  971)
13533* BFD_RELOC_SH_USES:                     howto manager.      (line  902)
13534* BFD_RELOC_SIZE32:                      howto manager.      (line   69)
13535* BFD_RELOC_SIZE64:                      howto manager.      (line   70)
13536* BFD_RELOC_SPARC13:                     howto manager.      (line  125)
13537* BFD_RELOC_SPARC22:                     howto manager.      (line  124)
13538* BFD_RELOC_SPARC_10:                    howto manager.      (line  152)
13539* BFD_RELOC_SPARC_11:                    howto manager.      (line  153)
13540* BFD_RELOC_SPARC_5:                     howto manager.      (line  165)
13541* BFD_RELOC_SPARC_6:                     howto manager.      (line  164)
13542* BFD_RELOC_SPARC_64:                    howto manager.      (line  151)
13543* BFD_RELOC_SPARC_7:                     howto manager.      (line  163)
13544* BFD_RELOC_SPARC_BASE13:                howto manager.      (line  148)
13545* BFD_RELOC_SPARC_BASE22:                howto manager.      (line  149)
13546* BFD_RELOC_SPARC_COPY:                  howto manager.      (line  132)
13547* BFD_RELOC_SPARC_DISP64:                howto manager.      (line  166)
13548* BFD_RELOC_SPARC_GLOB_DAT:              howto manager.      (line  133)
13549* BFD_RELOC_SPARC_GOT10:                 howto manager.      (line  126)
13550* BFD_RELOC_SPARC_GOT13:                 howto manager.      (line  127)
13551* BFD_RELOC_SPARC_GOT22:                 howto manager.      (line  128)
13552* BFD_RELOC_SPARC_GOTDATA_HIX22:         howto manager.      (line  139)
13553* BFD_RELOC_SPARC_GOTDATA_LOX10:         howto manager.      (line  140)
13554* BFD_RELOC_SPARC_GOTDATA_OP:            howto manager.      (line  143)
13555* BFD_RELOC_SPARC_GOTDATA_OP_HIX22:      howto manager.      (line  141)
13556* BFD_RELOC_SPARC_GOTDATA_OP_LOX10:      howto manager.      (line  142)
13557* BFD_RELOC_SPARC_H34:                   howto manager.      (line  175)
13558* BFD_RELOC_SPARC_H44:                   howto manager.      (line  171)
13559* BFD_RELOC_SPARC_HH22:                  howto manager.      (line  155)
13560* BFD_RELOC_SPARC_HIX22:                 howto manager.      (line  169)
13561* BFD_RELOC_SPARC_HM10:                  howto manager.      (line  156)
13562* BFD_RELOC_SPARC_IRELATIVE:             howto manager.      (line  145)
13563* BFD_RELOC_SPARC_JMP_IREL:              howto manager.      (line  144)
13564* BFD_RELOC_SPARC_JMP_SLOT:              howto manager.      (line  134)
13565* BFD_RELOC_SPARC_L44:                   howto manager.      (line  173)
13566* BFD_RELOC_SPARC_LM22:                  howto manager.      (line  157)
13567* BFD_RELOC_SPARC_LOX10:                 howto manager.      (line  170)
13568* BFD_RELOC_SPARC_M44:                   howto manager.      (line  172)
13569* BFD_RELOC_SPARC_OLO10:                 howto manager.      (line  154)
13570* BFD_RELOC_SPARC_PC10:                  howto manager.      (line  129)
13571* BFD_RELOC_SPARC_PC22:                  howto manager.      (line  130)
13572* BFD_RELOC_SPARC_PC_HH22:               howto manager.      (line  158)
13573* BFD_RELOC_SPARC_PC_HM10:               howto manager.      (line  159)
13574* BFD_RELOC_SPARC_PC_LM22:               howto manager.      (line  160)
13575* BFD_RELOC_SPARC_PLT32:                 howto manager.      (line  167)
13576* BFD_RELOC_SPARC_PLT64:                 howto manager.      (line  168)
13577* BFD_RELOC_SPARC_REGISTER:              howto manager.      (line  174)
13578* BFD_RELOC_SPARC_RELATIVE:              howto manager.      (line  135)
13579* BFD_RELOC_SPARC_REV32:                 howto manager.      (line  180)
13580* BFD_RELOC_SPARC_SIZE32:                howto manager.      (line  176)
13581* BFD_RELOC_SPARC_SIZE64:                howto manager.      (line  177)
13582* BFD_RELOC_SPARC_TLS_DTPMOD32:          howto manager.      (line  200)
13583* BFD_RELOC_SPARC_TLS_DTPMOD64:          howto manager.      (line  201)
13584* BFD_RELOC_SPARC_TLS_DTPOFF32:          howto manager.      (line  202)
13585* BFD_RELOC_SPARC_TLS_DTPOFF64:          howto manager.      (line  203)
13586* BFD_RELOC_SPARC_TLS_GD_ADD:            howto manager.      (line  184)
13587* BFD_RELOC_SPARC_TLS_GD_CALL:           howto manager.      (line  185)
13588* BFD_RELOC_SPARC_TLS_GD_HI22:           howto manager.      (line  182)
13589* BFD_RELOC_SPARC_TLS_GD_LO10:           howto manager.      (line  183)
13590* BFD_RELOC_SPARC_TLS_IE_ADD:            howto manager.      (line  197)
13591* BFD_RELOC_SPARC_TLS_IE_HI22:           howto manager.      (line  193)
13592* BFD_RELOC_SPARC_TLS_IE_LD:             howto manager.      (line  195)
13593* BFD_RELOC_SPARC_TLS_IE_LDX:            howto manager.      (line  196)
13594* BFD_RELOC_SPARC_TLS_IE_LO10:           howto manager.      (line  194)
13595* BFD_RELOC_SPARC_TLS_LDM_ADD:           howto manager.      (line  188)
13596* BFD_RELOC_SPARC_TLS_LDM_CALL:          howto manager.      (line  189)
13597* BFD_RELOC_SPARC_TLS_LDM_HI22:          howto manager.      (line  186)
13598* BFD_RELOC_SPARC_TLS_LDM_LO10:          howto manager.      (line  187)
13599* BFD_RELOC_SPARC_TLS_LDO_ADD:           howto manager.      (line  192)
13600* BFD_RELOC_SPARC_TLS_LDO_HIX22:         howto manager.      (line  190)
13601* BFD_RELOC_SPARC_TLS_LDO_LOX10:         howto manager.      (line  191)
13602* BFD_RELOC_SPARC_TLS_LE_HIX22:          howto manager.      (line  198)
13603* BFD_RELOC_SPARC_TLS_LE_LOX10:          howto manager.      (line  199)
13604* BFD_RELOC_SPARC_TLS_TPOFF32:           howto manager.      (line  204)
13605* BFD_RELOC_SPARC_TLS_TPOFF64:           howto manager.      (line  205)
13606* BFD_RELOC_SPARC_UA16:                  howto manager.      (line  136)
13607* BFD_RELOC_SPARC_UA32:                  howto manager.      (line  137)
13608* BFD_RELOC_SPARC_UA64:                  howto manager.      (line  138)
13609* BFD_RELOC_SPARC_WDISP10:               howto manager.      (line  178)
13610* BFD_RELOC_SPARC_WDISP16:               howto manager.      (line  161)
13611* BFD_RELOC_SPARC_WDISP19:               howto manager.      (line  162)
13612* BFD_RELOC_SPARC_WDISP22:               howto manager.      (line  123)
13613* BFD_RELOC_SPARC_WPLT30:                howto manager.      (line  131)
13614* BFD_RELOC_SPU_ADD_PIC:                 howto manager.      (line  221)
13615* BFD_RELOC_SPU_HI16:                    howto manager.      (line  218)
13616* BFD_RELOC_SPU_IMM10:                   howto manager.      (line  209)
13617* BFD_RELOC_SPU_IMM10W:                  howto manager.      (line  210)
13618* BFD_RELOC_SPU_IMM16:                   howto manager.      (line  211)
13619* BFD_RELOC_SPU_IMM16W:                  howto manager.      (line  212)
13620* BFD_RELOC_SPU_IMM18:                   howto manager.      (line  213)
13621* BFD_RELOC_SPU_IMM7:                    howto manager.      (line  207)
13622* BFD_RELOC_SPU_IMM8:                    howto manager.      (line  208)
13623* BFD_RELOC_SPU_LO16:                    howto manager.      (line  217)
13624* BFD_RELOC_SPU_PCREL16:                 howto manager.      (line  216)
13625* BFD_RELOC_SPU_PCREL9a:                 howto manager.      (line  214)
13626* BFD_RELOC_SPU_PCREL9b:                 howto manager.      (line  215)
13627* BFD_RELOC_SPU_PPU32:                   howto manager.      (line  219)
13628* BFD_RELOC_SPU_PPU64:                   howto manager.      (line  220)
13629* BFD_RELOC_THUMB_PCREL_BLX:             howto manager.      (line  744)
13630* BFD_RELOC_THUMB_PCREL_BRANCH12:        howto manager.      (line  755)
13631* BFD_RELOC_THUMB_PCREL_BRANCH20:        howto manager.      (line  756)
13632* BFD_RELOC_THUMB_PCREL_BRANCH23:        howto manager.      (line  757)
13633* BFD_RELOC_THUMB_PCREL_BRANCH25:        howto manager.      (line  758)
13634* BFD_RELOC_THUMB_PCREL_BRANCH7:         howto manager.      (line  753)
13635* BFD_RELOC_THUMB_PCREL_BRANCH9:         howto manager.      (line  754)
13636* BFD_RELOC_TIC30_LDP:                   howto manager.      (line 1484)
13637* BFD_RELOC_TIC54X_16_OF_23:             howto manager.      (line 1498)
13638* BFD_RELOC_TIC54X_23:                   howto manager.      (line 1496)
13639* BFD_RELOC_TIC54X_MS7_OF_23:            howto manager.      (line 1502)
13640* BFD_RELOC_TIC54X_PARTLS7:              howto manager.      (line 1488)
13641* BFD_RELOC_TIC54X_PARTMS9:              howto manager.      (line 1492)
13642* BFD_RELOC_TILEGX_BROFF_X1:             howto manager.      (line 3124)
13643* BFD_RELOC_TILEGX_COPY:                 howto manager.      (line 3120)
13644* BFD_RELOC_TILEGX_DEST_IMM8_X1:         howto manager.      (line 3131)
13645* BFD_RELOC_TILEGX_GLOB_DAT:             howto manager.      (line 3121)
13646* BFD_RELOC_TILEGX_HW0:                  howto manager.      (line 3113)
13647* BFD_RELOC_TILEGX_HW0_LAST:             howto manager.      (line 3117)
13648* BFD_RELOC_TILEGX_HW1:                  howto manager.      (line 3114)
13649* BFD_RELOC_TILEGX_HW1_LAST:             howto manager.      (line 3118)
13650* BFD_RELOC_TILEGX_HW2:                  howto manager.      (line 3115)
13651* BFD_RELOC_TILEGX_HW2_LAST:             howto manager.      (line 3119)
13652* BFD_RELOC_TILEGX_HW3:                  howto manager.      (line 3116)
13653* BFD_RELOC_TILEGX_IMM16_X0_HW0:         howto manager.      (line 3140)
13654* BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT:     howto manager.      (line 3168)
13655* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST:    howto manager.      (line 3148)
13656* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT: howto manager.     (line 3176)
13657* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL: howto manager.   (line 3162)
13658* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL: howto manager.
13659                                                             (line 3196)
13660* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD: howto manager.  (line 3190)
13661* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE: howto manager.  (line 3202)
13662* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE: howto manager.  (line 3186)
13663* BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL:   howto manager.      (line 3154)
13664* BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL: howto manager.    (line 3170)
13665* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD:  howto manager.      (line 3182)
13666* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE:  howto manager.      (line 3194)
13667* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE:  howto manager.      (line 3184)
13668* BFD_RELOC_TILEGX_IMM16_X0_HW1:         howto manager.      (line 3142)
13669* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST:    howto manager.      (line 3150)
13670* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT: howto manager.     (line 3178)
13671* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL: howto manager.   (line 3164)
13672* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL: howto manager.
13673                                                             (line 3198)
13674* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD: howto manager.  (line 3192)
13675* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE: howto manager.  (line 3204)
13676* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE: howto manager.  (line 3188)
13677* BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL:   howto manager.      (line 3156)
13678* BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL: howto manager.    (line 3172)
13679* BFD_RELOC_TILEGX_IMM16_X0_HW2:         howto manager.      (line 3144)
13680* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST:    howto manager.      (line 3152)
13681* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL: howto manager.   (line 3166)
13682* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL: howto manager.
13683                                                             (line 3200)
13684* BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL:   howto manager.      (line 3158)
13685* BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL: howto manager.    (line 3174)
13686* BFD_RELOC_TILEGX_IMM16_X0_HW3:         howto manager.      (line 3146)
13687* BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL:   howto manager.      (line 3160)
13688* BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL: howto manager.    (line 3180)
13689* BFD_RELOC_TILEGX_IMM16_X1_HW0:         howto manager.      (line 3141)
13690* BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT:     howto manager.      (line 3169)
13691* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST:    howto manager.      (line 3149)
13692* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT: howto manager.     (line 3177)
13693* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL: howto manager.   (line 3163)
13694* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL: howto manager.
13695                                                             (line 3197)
13696* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD: howto manager.  (line 3191)
13697* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE: howto manager.  (line 3203)
13698* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE: howto manager.  (line 3187)
13699* BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL:   howto manager.      (line 3155)
13700* BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL: howto manager.    (line 3171)
13701* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD:  howto manager.      (line 3183)
13702* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE:  howto manager.      (line 3195)
13703* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE:  howto manager.      (line 3185)
13704* BFD_RELOC_TILEGX_IMM16_X1_HW1:         howto manager.      (line 3143)
13705* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST:    howto manager.      (line 3151)
13706* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT: howto manager.     (line 3179)
13707* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL: howto manager.   (line 3165)
13708* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL: howto manager.
13709                                                             (line 3199)
13710* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD: howto manager.  (line 3193)
13711* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE: howto manager.  (line 3205)
13712* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE: howto manager.  (line 3189)
13713* BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL:   howto manager.      (line 3157)
13714* BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL: howto manager.    (line 3173)
13715* BFD_RELOC_TILEGX_IMM16_X1_HW2:         howto manager.      (line 3145)
13716* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST:    howto manager.      (line 3153)
13717* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL: howto manager.   (line 3167)
13718* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL: howto manager.
13719                                                             (line 3201)
13720* BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL:   howto manager.      (line 3159)
13721* BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL: howto manager.    (line 3175)
13722* BFD_RELOC_TILEGX_IMM16_X1_HW3:         howto manager.      (line 3147)
13723* BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL:   howto manager.      (line 3161)
13724* BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL: howto manager.    (line 3181)
13725* BFD_RELOC_TILEGX_IMM8_X0:              howto manager.      (line 3127)
13726* BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD:      howto manager.      (line 3218)
13727* BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD:   howto manager.      (line 3213)
13728* BFD_RELOC_TILEGX_IMM8_X1:              howto manager.      (line 3129)
13729* BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD:      howto manager.      (line 3219)
13730* BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD:   howto manager.      (line 3214)
13731* BFD_RELOC_TILEGX_IMM8_Y0:              howto manager.      (line 3128)
13732* BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD:      howto manager.      (line 3220)
13733* BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD:   howto manager.      (line 3215)
13734* BFD_RELOC_TILEGX_IMM8_Y1:              howto manager.      (line 3130)
13735* BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD:      howto manager.      (line 3221)
13736* BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD:   howto manager.      (line 3216)
13737* BFD_RELOC_TILEGX_JMP_SLOT:             howto manager.      (line 3122)
13738* BFD_RELOC_TILEGX_JUMPOFF_X1:           howto manager.      (line 3125)
13739* BFD_RELOC_TILEGX_JUMPOFF_X1_PLT:       howto manager.      (line 3126)
13740* BFD_RELOC_TILEGX_MF_IMM14_X1:          howto manager.      (line 3133)
13741* BFD_RELOC_TILEGX_MMEND_X0:             howto manager.      (line 3135)
13742* BFD_RELOC_TILEGX_MMSTART_X0:           howto manager.      (line 3134)
13743* BFD_RELOC_TILEGX_MT_IMM14_X1:          howto manager.      (line 3132)
13744* BFD_RELOC_TILEGX_RELATIVE:             howto manager.      (line 3123)
13745* BFD_RELOC_TILEGX_SHAMT_X0:             howto manager.      (line 3136)
13746* BFD_RELOC_TILEGX_SHAMT_X1:             howto manager.      (line 3137)
13747* BFD_RELOC_TILEGX_SHAMT_Y0:             howto manager.      (line 3138)
13748* BFD_RELOC_TILEGX_SHAMT_Y1:             howto manager.      (line 3139)
13749* BFD_RELOC_TILEGX_TLS_DTPMOD32:         howto manager.      (line 3209)
13750* BFD_RELOC_TILEGX_TLS_DTPMOD64:         howto manager.      (line 3206)
13751* BFD_RELOC_TILEGX_TLS_DTPOFF32:         howto manager.      (line 3210)
13752* BFD_RELOC_TILEGX_TLS_DTPOFF64:         howto manager.      (line 3207)
13753* BFD_RELOC_TILEGX_TLS_GD_CALL:          howto manager.      (line 3212)
13754* BFD_RELOC_TILEGX_TLS_IE_LOAD:          howto manager.      (line 3217)
13755* BFD_RELOC_TILEGX_TLS_TPOFF32:          howto manager.      (line 3211)
13756* BFD_RELOC_TILEGX_TLS_TPOFF64:          howto manager.      (line 3208)
13757* BFD_RELOC_TILEPRO_BROFF_X1:            howto manager.      (line 3037)
13758* BFD_RELOC_TILEPRO_COPY:                howto manager.      (line 3033)
13759* BFD_RELOC_TILEPRO_DEST_IMM8_X1:        howto manager.      (line 3044)
13760* BFD_RELOC_TILEPRO_GLOB_DAT:            howto manager.      (line 3034)
13761* BFD_RELOC_TILEPRO_IMM16_X0:            howto manager.      (line 3047)
13762* BFD_RELOC_TILEPRO_IMM16_X0_GOT:        howto manager.      (line 3063)
13763* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA:     howto manager.      (line 3069)
13764* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI:     howto manager.      (line 3067)
13765* BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO:     howto manager.      (line 3065)
13766* BFD_RELOC_TILEPRO_IMM16_X0_HA:         howto manager.      (line 3053)
13767* BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL:   howto manager.      (line 3061)
13768* BFD_RELOC_TILEPRO_IMM16_X0_HI:         howto manager.      (line 3051)
13769* BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL:   howto manager.      (line 3059)
13770* BFD_RELOC_TILEPRO_IMM16_X0_LO:         howto manager.      (line 3049)
13771* BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL:   howto manager.      (line 3057)
13772* BFD_RELOC_TILEPRO_IMM16_X0_PCREL:      howto manager.      (line 3055)
13773* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD:     howto manager.      (line 3085)
13774* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA:  howto manager.      (line 3091)
13775* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI:  howto manager.      (line 3089)
13776* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO:  howto manager.      (line 3087)
13777* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE:     howto manager.      (line 3093)
13778* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA:  howto manager.      (line 3099)
13779* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI:  howto manager.      (line 3097)
13780* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO:  howto manager.      (line 3095)
13781* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE:     howto manager.      (line 3104)
13782* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA:  howto manager.      (line 3110)
13783* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI:  howto manager.      (line 3108)
13784* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO:  howto manager.      (line 3106)
13785* BFD_RELOC_TILEPRO_IMM16_X1:            howto manager.      (line 3048)
13786* BFD_RELOC_TILEPRO_IMM16_X1_GOT:        howto manager.      (line 3064)
13787* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA:     howto manager.      (line 3070)
13788* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI:     howto manager.      (line 3068)
13789* BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO:     howto manager.      (line 3066)
13790* BFD_RELOC_TILEPRO_IMM16_X1_HA:         howto manager.      (line 3054)
13791* BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL:   howto manager.      (line 3062)
13792* BFD_RELOC_TILEPRO_IMM16_X1_HI:         howto manager.      (line 3052)
13793* BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL:   howto manager.      (line 3060)
13794* BFD_RELOC_TILEPRO_IMM16_X1_LO:         howto manager.      (line 3050)
13795* BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL:   howto manager.      (line 3058)
13796* BFD_RELOC_TILEPRO_IMM16_X1_PCREL:      howto manager.      (line 3056)
13797* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD:     howto manager.      (line 3086)
13798* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA:  howto manager.      (line 3092)
13799* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI:  howto manager.      (line 3090)
13800* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO:  howto manager.      (line 3088)
13801* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE:     howto manager.      (line 3094)
13802* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA:  howto manager.      (line 3100)
13803* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI:  howto manager.      (line 3098)
13804* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO:  howto manager.      (line 3096)
13805* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE:     howto manager.      (line 3105)
13806* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA:  howto manager.      (line 3111)
13807* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI:  howto manager.      (line 3109)
13808* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO:  howto manager.      (line 3107)
13809* BFD_RELOC_TILEPRO_IMM8_X0:             howto manager.      (line 3040)
13810* BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD:  howto manager.      (line 3080)
13811* BFD_RELOC_TILEPRO_IMM8_X1:             howto manager.      (line 3042)
13812* BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD:  howto manager.      (line 3081)
13813* BFD_RELOC_TILEPRO_IMM8_Y0:             howto manager.      (line 3041)
13814* BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD:  howto manager.      (line 3082)
13815* BFD_RELOC_TILEPRO_IMM8_Y1:             howto manager.      (line 3043)
13816* BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD:  howto manager.      (line 3083)
13817* BFD_RELOC_TILEPRO_JMP_SLOT:            howto manager.      (line 3035)
13818* BFD_RELOC_TILEPRO_JOFFLONG_X1:         howto manager.      (line 3038)
13819* BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT:     howto manager.      (line 3039)
13820* BFD_RELOC_TILEPRO_MF_IMM15_X1:         howto manager.      (line 3046)
13821* BFD_RELOC_TILEPRO_MMEND_X0:            howto manager.      (line 3072)
13822* BFD_RELOC_TILEPRO_MMEND_X1:            howto manager.      (line 3074)
13823* BFD_RELOC_TILEPRO_MMSTART_X0:          howto manager.      (line 3071)
13824* BFD_RELOC_TILEPRO_MMSTART_X1:          howto manager.      (line 3073)
13825* BFD_RELOC_TILEPRO_MT_IMM15_X1:         howto manager.      (line 3045)
13826* BFD_RELOC_TILEPRO_RELATIVE:            howto manager.      (line 3036)
13827* BFD_RELOC_TILEPRO_SHAMT_X0:            howto manager.      (line 3075)
13828* BFD_RELOC_TILEPRO_SHAMT_X1:            howto manager.      (line 3076)
13829* BFD_RELOC_TILEPRO_SHAMT_Y0:            howto manager.      (line 3077)
13830* BFD_RELOC_TILEPRO_SHAMT_Y1:            howto manager.      (line 3078)
13831* BFD_RELOC_TILEPRO_TLS_DTPMOD32:        howto manager.      (line 3101)
13832* BFD_RELOC_TILEPRO_TLS_DTPOFF32:        howto manager.      (line 3102)
13833* BFD_RELOC_TILEPRO_TLS_GD_CALL:         howto manager.      (line 3079)
13834* BFD_RELOC_TILEPRO_TLS_IE_LOAD:         howto manager.      (line 3084)
13835* BFD_RELOC_TILEPRO_TLS_TPOFF32:         howto manager.      (line 3103)
13836* bfd_reloc_type_lookup:                 howto manager.      (line 3259)
13837* BFD_RELOC_V850_16_GOT:                 howto manager.      (line 1460)
13838* BFD_RELOC_V850_16_GOTOFF:              howto manager.      (line 1476)
13839* BFD_RELOC_V850_16_PCREL:               howto manager.      (line 1440)
13840* BFD_RELOC_V850_16_S1:                  howto manager.      (line 1452)
13841* BFD_RELOC_V850_16_SPLIT_OFFSET:        howto manager.      (line 1450)
13842* BFD_RELOC_V850_17_PCREL:               howto manager.      (line 1442)
13843* BFD_RELOC_V850_22_PCREL:               howto manager.      (line 1394)
13844* BFD_RELOC_V850_22_PLT_PCREL:           howto manager.      (line 1464)
13845* BFD_RELOC_V850_23:                     howto manager.      (line 1444)
13846* BFD_RELOC_V850_32_ABS:                 howto manager.      (line 1448)
13847* BFD_RELOC_V850_32_GOT:                 howto manager.      (line 1462)
13848* BFD_RELOC_V850_32_GOTOFF:              howto manager.      (line 1478)
13849* BFD_RELOC_V850_32_GOTPCREL:            howto manager.      (line 1458)
13850* BFD_RELOC_V850_32_PCREL:               howto manager.      (line 1446)
13851* BFD_RELOC_V850_32_PLT_PCREL:           howto manager.      (line 1466)
13852* BFD_RELOC_V850_9_PCREL:                howto manager.      (line 1392)
13853* BFD_RELOC_V850_ALIGN:                  howto manager.      (line 1435)
13854* BFD_RELOC_V850_CALLT_15_16_OFFSET:     howto manager.      (line 1456)
13855* BFD_RELOC_V850_CALLT_16_16_OFFSET:     howto manager.      (line 1429)
13856* BFD_RELOC_V850_CALLT_6_7_OFFSET:       howto manager.      (line 1427)
13857* BFD_RELOC_V850_CODE:                   howto manager.      (line 1480)
13858* BFD_RELOC_V850_COPY:                   howto manager.      (line 1468)
13859* BFD_RELOC_V850_DATA:                   howto manager.      (line 1482)
13860* BFD_RELOC_V850_GLOB_DAT:               howto manager.      (line 1470)
13861* BFD_RELOC_V850_JMP_SLOT:               howto manager.      (line 1472)
13862* BFD_RELOC_V850_LO16_S1:                howto manager.      (line 1454)
13863* BFD_RELOC_V850_LO16_SPLIT_OFFSET:      howto manager.      (line 1437)
13864* BFD_RELOC_V850_LONGCALL:               howto manager.      (line 1431)
13865* BFD_RELOC_V850_LONGJUMP:               howto manager.      (line 1433)
13866* BFD_RELOC_V850_RELATIVE:               howto manager.      (line 1474)
13867* BFD_RELOC_V850_SDA_15_16_OFFSET:       howto manager.      (line 1398)
13868* BFD_RELOC_V850_SDA_16_16_OFFSET:       howto manager.      (line 1396)
13869* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.      (line 1421)
13870* BFD_RELOC_V850_TDA_16_16_OFFSET:       howto manager.      (line 1414)
13871* BFD_RELOC_V850_TDA_4_4_OFFSET:         howto manager.      (line 1419)
13872* BFD_RELOC_V850_TDA_4_5_OFFSET:         howto manager.      (line 1416)
13873* BFD_RELOC_V850_TDA_6_8_OFFSET:         howto manager.      (line 1406)
13874* BFD_RELOC_V850_TDA_7_7_OFFSET:         howto manager.      (line 1412)
13875* BFD_RELOC_V850_TDA_7_8_OFFSET:         howto manager.      (line 1409)
13876* BFD_RELOC_V850_ZDA_15_16_OFFSET:       howto manager.      (line 1403)
13877* BFD_RELOC_V850_ZDA_16_16_OFFSET:       howto manager.      (line 1401)
13878* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.      (line 1424)
13879* BFD_RELOC_VAX_GLOB_DAT:                howto manager.      (line 2413)
13880* BFD_RELOC_VAX_JMP_SLOT:                howto manager.      (line 2414)
13881* BFD_RELOC_VAX_RELATIVE:                howto manager.      (line 2415)
13882* BFD_RELOC_VISIUM_HI16:                 howto manager.      (line 3238)
13883* BFD_RELOC_VISIUM_HI16_PCREL:           howto manager.      (line 3242)
13884* BFD_RELOC_VISIUM_IM16:                 howto manager.      (line 3240)
13885* BFD_RELOC_VISIUM_IM16_PCREL:           howto manager.      (line 3244)
13886* BFD_RELOC_VISIUM_LO16:                 howto manager.      (line 3239)
13887* BFD_RELOC_VISIUM_LO16_PCREL:           howto manager.      (line 3243)
13888* BFD_RELOC_VISIUM_REL16:                howto manager.      (line 3241)
13889* BFD_RELOC_VPE4KMATH_DATA:              howto manager.      (line 2016)
13890* BFD_RELOC_VPE4KMATH_INSN:              howto manager.      (line 2017)
13891* BFD_RELOC_VTABLE_ENTRY:                howto manager.      (line 2020)
13892* BFD_RELOC_VTABLE_INHERIT:              howto manager.      (line 2019)
13893* BFD_RELOC_WASM32_ABS32_CODE:           howto manager.      (line 3251)
13894* BFD_RELOC_WASM32_CODE_POINTER:         howto manager.      (line 3253)
13895* BFD_RELOC_WASM32_COPY:                 howto manager.      (line 3252)
13896* BFD_RELOC_WASM32_INDEX:                howto manager.      (line 3254)
13897* BFD_RELOC_WASM32_LEB128:               howto manager.      (line 3246)
13898* BFD_RELOC_WASM32_LEB128_GOT:           howto manager.      (line 3247)
13899* BFD_RELOC_WASM32_LEB128_GOT_CODE:      howto manager.      (line 3248)
13900* BFD_RELOC_WASM32_LEB128_PLT:           howto manager.      (line 3249)
13901* BFD_RELOC_WASM32_PLT_INDEX:            howto manager.      (line 3250)
13902* BFD_RELOC_WASM32_PLT_SIG:              howto manager.      (line 3255)
13903* BFD_RELOC_X86_64_32S:                  howto manager.      (line  558)
13904* BFD_RELOC_X86_64_COPY:                 howto manager.      (line  553)
13905* BFD_RELOC_X86_64_DTPMOD64:             howto manager.      (line  559)
13906* BFD_RELOC_X86_64_DTPOFF32:             howto manager.      (line  564)
13907* BFD_RELOC_X86_64_DTPOFF64:             howto manager.      (line  560)
13908* BFD_RELOC_X86_64_GLOB_DAT:             howto manager.      (line  554)
13909* BFD_RELOC_X86_64_GOT32:                howto manager.      (line  551)
13910* BFD_RELOC_X86_64_GOT64:                howto manager.      (line  569)
13911* BFD_RELOC_X86_64_GOTOFF64:             howto manager.      (line  567)
13912* BFD_RELOC_X86_64_GOTPC32:              howto manager.      (line  568)
13913* BFD_RELOC_X86_64_GOTPC32_TLSDESC:      howto manager.      (line  574)
13914* BFD_RELOC_X86_64_GOTPC64:              howto manager.      (line  571)
13915* BFD_RELOC_X86_64_GOTPCREL:             howto manager.      (line  557)
13916* BFD_RELOC_X86_64_GOTPCREL64:           howto manager.      (line  570)
13917* BFD_RELOC_X86_64_GOTPCRELX:            howto manager.      (line  580)
13918* BFD_RELOC_X86_64_GOTPLT64:             howto manager.      (line  572)
13919* BFD_RELOC_X86_64_GOTTPOFF:             howto manager.      (line  565)
13920* BFD_RELOC_X86_64_IRELATIVE:            howto manager.      (line  577)
13921* BFD_RELOC_X86_64_JUMP_SLOT:            howto manager.      (line  555)
13922* BFD_RELOC_X86_64_PC32_BND:             howto manager.      (line  578)
13923* BFD_RELOC_X86_64_PLT32:                howto manager.      (line  552)
13924* BFD_RELOC_X86_64_PLT32_BND:            howto manager.      (line  579)
13925* BFD_RELOC_X86_64_PLTOFF64:             howto manager.      (line  573)
13926* BFD_RELOC_X86_64_RELATIVE:             howto manager.      (line  556)
13927* BFD_RELOC_X86_64_REX_GOTPCRELX:        howto manager.      (line  581)
13928* BFD_RELOC_X86_64_TLSDESC:              howto manager.      (line  576)
13929* BFD_RELOC_X86_64_TLSDESC_CALL:         howto manager.      (line  575)
13930* BFD_RELOC_X86_64_TLSGD:                howto manager.      (line  562)
13931* BFD_RELOC_X86_64_TLSLD:                howto manager.      (line  563)
13932* BFD_RELOC_X86_64_TPOFF32:              howto manager.      (line  566)
13933* BFD_RELOC_X86_64_TPOFF64:              howto manager.      (line  561)
13934* BFD_RELOC_XC16X_PAG:                   howto manager.      (line 2408)
13935* BFD_RELOC_XC16X_POF:                   howto manager.      (line 2409)
13936* BFD_RELOC_XC16X_SEG:                   howto manager.      (line 2410)
13937* BFD_RELOC_XC16X_SOF:                   howto manager.      (line 2411)
13938* BFD_RELOC_XGATE_24:                    howto manager.      (line 2163)
13939* BFD_RELOC_XGATE_GPAGE:                 howto manager.      (line 2161)
13940* BFD_RELOC_XGATE_IMM3:                  howto manager.      (line 2175)
13941* BFD_RELOC_XGATE_IMM4:                  howto manager.      (line 2177)
13942* BFD_RELOC_XGATE_IMM5:                  howto manager.      (line 2179)
13943* BFD_RELOC_XGATE_IMM8_HI:               howto manager.      (line 2172)
13944* BFD_RELOC_XGATE_IMM8_LO:               howto manager.      (line 2169)
13945* BFD_RELOC_XGATE_LO16:                  howto manager.      (line 2158)
13946* BFD_RELOC_XGATE_PCREL_10:              howto manager.      (line 2167)
13947* BFD_RELOC_XGATE_PCREL_9:               howto manager.      (line 2165)
13948* BFD_RELOC_XGATE_RL_GROUP:              howto manager.      (line 2154)
13949* BFD_RELOC_XGATE_RL_JUMP:               howto manager.      (line 2151)
13950* BFD_RELOC_XSTORMY16_12:                howto manager.      (line 2402)
13951* BFD_RELOC_XSTORMY16_24:                howto manager.      (line 2403)
13952* BFD_RELOC_XSTORMY16_FPTR16:            howto manager.      (line 2404)
13953* BFD_RELOC_XSTORMY16_REL_12:            howto manager.      (line 2401)
13954* BFD_RELOC_XTENSA_ASM_EXPAND:           howto manager.      (line 2599)
13955* BFD_RELOC_XTENSA_ASM_SIMPLIFY:         howto manager.      (line 2603)
13956* BFD_RELOC_XTENSA_DIFF16:               howto manager.      (line 2550)
13957* BFD_RELOC_XTENSA_DIFF32:               howto manager.      (line 2551)
13958* BFD_RELOC_XTENSA_DIFF8:                howto manager.      (line 2549)
13959* BFD_RELOC_XTENSA_GLOB_DAT:             howto manager.      (line 2541)
13960* BFD_RELOC_XTENSA_JMP_SLOT:             howto manager.      (line 2542)
13961* BFD_RELOC_XTENSA_OP0:                  howto manager.      (line 2594)
13962* BFD_RELOC_XTENSA_OP1:                  howto manager.      (line 2595)
13963* BFD_RELOC_XTENSA_OP2:                  howto manager.      (line 2596)
13964* BFD_RELOC_XTENSA_PLT:                  howto manager.      (line 2545)
13965* BFD_RELOC_XTENSA_RELATIVE:             howto manager.      (line 2543)
13966* BFD_RELOC_XTENSA_RTLD:                 howto manager.      (line 2537)
13967* BFD_RELOC_XTENSA_SLOT0_ALT:            howto manager.      (line 2577)
13968* BFD_RELOC_XTENSA_SLOT0_OP:             howto manager.      (line 2558)
13969* BFD_RELOC_XTENSA_SLOT10_ALT:           howto manager.      (line 2587)
13970* BFD_RELOC_XTENSA_SLOT10_OP:            howto manager.      (line 2568)
13971* BFD_RELOC_XTENSA_SLOT11_ALT:           howto manager.      (line 2588)
13972* BFD_RELOC_XTENSA_SLOT11_OP:            howto manager.      (line 2569)
13973* BFD_RELOC_XTENSA_SLOT12_ALT:           howto manager.      (line 2589)
13974* BFD_RELOC_XTENSA_SLOT12_OP:            howto manager.      (line 2570)
13975* BFD_RELOC_XTENSA_SLOT13_ALT:           howto manager.      (line 2590)
13976* BFD_RELOC_XTENSA_SLOT13_OP:            howto manager.      (line 2571)
13977* BFD_RELOC_XTENSA_SLOT14_ALT:           howto manager.      (line 2591)
13978* BFD_RELOC_XTENSA_SLOT14_OP:            howto manager.      (line 2572)
13979* BFD_RELOC_XTENSA_SLOT1_ALT:            howto manager.      (line 2578)
13980* BFD_RELOC_XTENSA_SLOT1_OP:             howto manager.      (line 2559)
13981* BFD_RELOC_XTENSA_SLOT2_ALT:            howto manager.      (line 2579)
13982* BFD_RELOC_XTENSA_SLOT2_OP:             howto manager.      (line 2560)
13983* BFD_RELOC_XTENSA_SLOT3_ALT:            howto manager.      (line 2580)
13984* BFD_RELOC_XTENSA_SLOT3_OP:             howto manager.      (line 2561)
13985* BFD_RELOC_XTENSA_SLOT4_ALT:            howto manager.      (line 2581)
13986* BFD_RELOC_XTENSA_SLOT4_OP:             howto manager.      (line 2562)
13987* BFD_RELOC_XTENSA_SLOT5_ALT:            howto manager.      (line 2582)
13988* BFD_RELOC_XTENSA_SLOT5_OP:             howto manager.      (line 2563)
13989* BFD_RELOC_XTENSA_SLOT6_ALT:            howto manager.      (line 2583)
13990* BFD_RELOC_XTENSA_SLOT6_OP:             howto manager.      (line 2564)
13991* BFD_RELOC_XTENSA_SLOT7_ALT:            howto manager.      (line 2584)
13992* BFD_RELOC_XTENSA_SLOT7_OP:             howto manager.      (line 2565)
13993* BFD_RELOC_XTENSA_SLOT8_ALT:            howto manager.      (line 2585)
13994* BFD_RELOC_XTENSA_SLOT8_OP:             howto manager.      (line 2566)
13995* BFD_RELOC_XTENSA_SLOT9_ALT:            howto manager.      (line 2586)
13996* BFD_RELOC_XTENSA_SLOT9_OP:             howto manager.      (line 2567)
13997* BFD_RELOC_XTENSA_TLSDESC_ARG:          howto manager.      (line 2608)
13998* BFD_RELOC_XTENSA_TLSDESC_FN:           howto manager.      (line 2607)
13999* BFD_RELOC_XTENSA_TLS_ARG:              howto manager.      (line 2612)
14000* BFD_RELOC_XTENSA_TLS_CALL:             howto manager.      (line 2613)
14001* BFD_RELOC_XTENSA_TLS_DTPOFF:           howto manager.      (line 2609)
14002* BFD_RELOC_XTENSA_TLS_FUNC:             howto manager.      (line 2611)
14003* BFD_RELOC_XTENSA_TLS_TPOFF:            howto manager.      (line 2610)
14004* BFD_RELOC_Z80_DISP8:                   howto manager.      (line 2615)
14005* BFD_RELOC_Z8K_CALLR:                   howto manager.      (line 2619)
14006* BFD_RELOC_Z8K_DISP7:                   howto manager.      (line 2617)
14007* BFD_RELOC_Z8K_IMM4L:                   howto manager.      (line 2621)
14008* bfd_rename_section:                    section prototypes. (line  177)
14009* bfd_scan_arch:                         Architectures.      (line  555)
14010* bfd_scan_vma:                          Miscellaneous.      (line  126)
14011* bfd_sections_find_if:                  section prototypes. (line  207)
14012* bfd_section_already_linked:            Writing the symbol table.
14013                                                             (line   55)
14014* bfd_section_list_clear:                section prototypes. (line    7)
14015* bfd_set_archive_head:                  Archives.           (line   74)
14016* bfd_set_arch_info:                     Architectures.      (line  596)
14017* bfd_set_assert_handler:                Error reporting.    (line  146)
14018* bfd_set_default_target:                bfd_target.         (line  483)
14019* bfd_set_error:                         Error reporting.    (line   57)
14020* bfd_set_error_handler:                 Error reporting.    (line  111)
14021* bfd_set_error_program_name:            Error reporting.    (line  120)
14022* bfd_set_file_flags:                    Miscellaneous.      (line   45)
14023* bfd_set_format:                        Formats.            (line   67)
14024* bfd_set_gp_size:                       Miscellaneous.      (line  116)
14025* bfd_set_input_error:                   Error reporting.    (line   68)
14026* bfd_set_private_flags:                 Miscellaneous.      (line  174)
14027* bfd_set_reloc:                         Miscellaneous.      (line   33)
14028* bfd_set_section_contents:              section prototypes. (line  239)
14029* bfd_set_section_flags:                 section prototypes. (line  162)
14030* bfd_set_section_size:                  section prototypes. (line  224)
14031* bfd_set_start_address:                 Miscellaneous.      (line   95)
14032* bfd_set_symtab:                        symbol handling functions.
14033                                                             (line   63)
14034* bfd_symbol_info:                       symbol handling functions.
14035                                                             (line  135)
14036* bfd_target_list:                       bfd_target.         (line  535)
14037* bfd_update_compression_header:         Miscellaneous.      (line  350)
14038* bfd_write_bigendian_4byte_int:         Internal.           (line   12)
14039* bfd_zalloc:                            Opening and Closing.
14040                                                             (line  257)
14041* bfd_zalloc2:                           Opening and Closing.
14042                                                             (line  266)
14043* check_build_id_file:                   Opening and Closing.
14044                                                             (line  491)
14045* coff_symbol_type:                      coff.               (line  244)
14046* core_file_matches_executable_p:        Core Files.         (line   38)
14047* find_separate_debug_file:              Opening and Closing.
14048                                                             (line  365)
14049* generic_core_file_matches_executable_p: Core Files.        (line   48)
14050* get_build_id:                          Opening and Closing.
14051                                                             (line  460)
14052* get_build_id_name:                     Opening and Closing.
14053                                                             (line  474)
14054* Hash tables:                           Hash Tables.        (line    6)
14055* internal object-file format:           Canonical format.   (line   11)
14056* Linker:                                Linker Functions.   (line    6)
14057* Other functions:                       Miscellaneous.      (line  188)
14058* separate_alt_debug_file_exists:        Opening and Closing.
14059                                                             (line  356)
14060* separate_debug_file_exists:            Opening and Closing.
14061                                                             (line  343)
14062* struct bfd_iovec:                      Miscellaneous.      (line  409)
14063* target vector (_bfd_final_link):       Performing the Final Link.
14064                                                             (line    6)
14065* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
14066                                                             (line    6)
14067* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
14068                                                             (line    6)
14069* The HOWTO Macro:                       typedef arelent.    (line  290)
14070* what is it?:                           Overview.           (line    6)
14071
14072
14073
14074Tag Table:
14075Node: Top1054
14076Node: Overview1390
14077Node: History2448
14078Node: How It Works3393
14079Node: What BFD Version 2 Can Do4930
14080Node: BFD information loss6247
14081Node: Canonical format8788
14082Node: BFD front end13165
14083Node: typedef bfd13589
14084Node: Error reporting26116
14085Node: Miscellaneous30839
14086Node: Memory Usage49719
14087Node: Initialization50950
14088Node: Sections51409
14089Node: Section Input51892
14090Node: Section Output53261
14091Node: typedef asection55748
14092Node: section prototypes83566
14093Node: Symbols94177
14094Node: Reading Symbols95780
14095Node: Writing Symbols96888
14096Node: Mini Symbols98632
14097Node: typedef asymbol99606
14098Node: symbol handling functions105691
14099Node: Archives111066
14100Node: Formats115203
14101Node: Relocations118154
14102Node: typedef arelent118881
14103Node: howto manager134986
14104Node: Core Files260527
14105Node: Targets262565
14106Node: bfd_target264540
14107Node: Architectures289896
14108Node: Opening and Closing320577
14109Node: Internal338752
14110Node: File Caching345077
14111Node: Linker Functions346995
14112Node: Creating a Linker Hash Table348669
14113Node: Adding Symbols to the Hash Table350408
14114Node: Differing file formats351308
14115Node: Adding symbols from an object file353033
14116Node: Adding symbols from an archive355183
14117Node: Performing the Final Link357529
14118Node: Information provided by the linker358770
14119Node: Relocating the section contents359924
14120Node: Writing the symbol table361676
14121Node: Hash Tables368342
14122Node: Creating and Freeing a Hash Table369540
14123Node: Looking Up or Entering a String370790
14124Node: Traversing a Hash Table372043
14125Node: Deriving a New Hash Table Type372832
14126Node: Define the Derived Structures373898
14127Node: Write the Derived Creation Routine374979
14128Node: Write Other Derived Routines377604
14129Node: BFD back ends378919
14130Node: What to Put Where379189
14131Node: aout379369
14132Node: coff385712
14133Node: elf414503
14134Node: mmo414904
14135Node: File layout415774
14136Node: Symbol-table421687
14137Node: mmo section mapping425450
14138Node: GNU Free Documentation License429104
14139Node: BFD Index454168
14140
14141End Tag Table
14142