bfd.info revision 1.6
1This is bfd.info, produced by makeinfo version 6.4 from bfd.texi.
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, Oasys) and the type is simple enough to fit within
262     one word (nearly everything but aggregates), the information will
263     be preserved.
264
265_relocation level_
266     Each canonical BFD relocation record contains a pointer to the
267     symbol to relocate to, the offset of the data to relocate, the
268     section the data is in, and a pointer to a relocation type
269     descriptor.  Relocation is performed by passing messages through
270     the relocation type descriptor and the symbol pointer.  Therefore,
271     relocations can be performed on output data using a relocation
272     method that is only available in one of the input formats.  For
273     instance, Oasys provides a byte relocation format.  A relocation
274     record requesting this relocation type would point indirectly to a
275     routine to perform this, so the relocation may be performed on a
276     byte being written to a 68k COFF file, even though 68k COFF has no
277     such relocation type.
278
279_line numbers_
280     Object formats can contain, for debugging purposes, some form of
281     mapping between symbols, source line numbers, and addresses in the
282     output file.  These addresses have to be relocated along with the
283     symbol information.  Each symbol with an associated list of line
284     number records points to the first record of the list.  The head of
285     a line number list consists of a pointer to the symbol, which
286     allows finding out the address of the function whose line number is
287     being described.  The rest of the list is made up of pairs: offsets
288     into the section and line numbers.  Any format which can simply
289     derive this information can pass it successfully between formats.
290
291
292File: bfd.info,  Node: BFD front end,  Next: BFD back ends,  Prev: Overview,  Up: Top
293
2942 BFD Front End
295***************
296
297* Menu:
298
299* typedef bfd::
300* Error reporting::
301* Miscellaneous::
302* Memory Usage::
303* Initialization::
304* Sections::
305* Symbols::
306* Archives::
307* Formats::
308* Relocations::
309* Core Files::
310* Targets::
311* Architectures::
312* Opening and Closing::
313* Internal::
314* File Caching::
315* Linker Functions::
316* Hash Tables::
317
318
319File: bfd.info,  Node: typedef bfd,  Next: Error reporting,  Prev: BFD front end,  Up: BFD front end
320
3212.1 'typedef bfd'
322=================
323
324A BFD has type 'bfd'; objects of this type are the cornerstone of any
325application using BFD. Using BFD consists of making references though
326the BFD and to data in the BFD.
327
328   Here is the structure that defines the type 'bfd'.  It contains the
329major data about the file and pointers to the rest of the data.
330
331
332     enum bfd_direction
333       {
334         no_direction = 0,
335         read_direction = 1,
336         write_direction = 2,
337         both_direction = 3
338       };
339
340     enum bfd_plugin_format
341       {
342         bfd_plugin_unknown = 0,
343         bfd_plugin_yes = 1,
344         bfd_plugin_no = 2
345       };
346
347     struct bfd_build_id
348       {
349         bfd_size_type size;
350         bfd_byte data[1];
351       };
352
353     struct bfd
354     {
355       /* The filename the application opened the BFD with.  */
356       const char *filename;
357
358       /* A pointer to the target jump table.  */
359       const struct bfd_target *xvec;
360
361       /* The IOSTREAM, and corresponding IO vector that provide access
362          to the file backing the BFD.  */
363       void *iostream;
364       const struct bfd_iovec *iovec;
365
366       /* The caching routines use these to maintain a
367          least-recently-used list of BFDs.  */
368       struct bfd *lru_prev, *lru_next;
369
370       /* Track current file position (or current buffer offset for
371          in-memory BFDs).  When a file is closed by the caching routines,
372          BFD retains state information on the file here.  */
373       ufile_ptr where;
374
375       /* File modified time, if mtime_set is TRUE.  */
376       long mtime;
377
378       /* A unique identifier of the BFD  */
379       unsigned int id;
380
381       /* 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 coff_tdata *coff_obj_data;
602           struct pe_tdata *pe_obj_data;
603           struct xcoff_tdata *xcoff_obj_data;
604           struct ecoff_tdata *ecoff_obj_data;
605           struct srec_data_struct *srec_data;
606           struct verilog_data_struct *verilog_data;
607           struct ihex_data_struct *ihex_data;
608           struct tekhex_data_struct *tekhex_data;
609           struct elf_obj_tdata *elf_obj_data;
610           struct mmo_data_struct *mmo_data;
611           struct sun_core_struct *sun_core_data;
612           struct sco5_core_struct *sco5_core_data;
613           struct trad_core_struct *trad_core_data;
614           struct som_data_struct *som_data;
615           struct hpux_core_struct *hpux_core_data;
616           struct hppabsd_core_struct *hppabsd_core_data;
617           struct sgi_core_struct *sgi_core_data;
618           struct lynx_core_struct *lynx_core_data;
619           struct osf_core_struct *osf_core_data;
620           struct cisco_core_struct *cisco_core_data;
621           struct versados_data_struct *versados_data;
622           struct netbsd_core_struct *netbsd_core_data;
623           struct mach_o_data_struct *mach_o_data;
624           struct mach_o_fat_data_struct *mach_o_fat_data;
625           struct plugin_data_struct *plugin_data;
626           struct bfd_pef_data_struct *pef_data;
627           struct bfd_pef_xlib_data_struct *pef_xlib_data;
628           struct bfd_sym_data_struct *sym_data;
629           void *any;
630         }
631       tdata;
632
633       /* Used by the application to hold private data.  */
634       void *usrdata;
635
636       /* Where all the allocated stuff under this BFD goes.  This is a
637          struct objalloc *, but we use void * to avoid requiring the inclusion
638          of objalloc.h.  */
639       void *memory;
640
641       /* For input BFDs, the build ID, if the object has one. */
642       const struct bfd_build_id *build_id;
643     };
644
645     /* See note beside bfd_set_section_userdata.  */
646     static inline bfd_boolean
647     bfd_set_cacheable (bfd * abfd, bfd_boolean val)
648     {
649       abfd->cacheable = val;
650       return TRUE;
651     }
652
653
654
655File: bfd.info,  Node: Error reporting,  Next: Miscellaneous,  Prev: typedef bfd,  Up: BFD front end
656
6572.2 Error reporting
658===================
659
660Most BFD functions return nonzero on success (check their individual
661documentation for precise semantics).  On an error, they call
662'bfd_set_error' to set an error condition that callers can check by
663calling 'bfd_get_error'.  If that returns 'bfd_error_system_call', then
664check 'errno'.
665
666   The easiest way to report a BFD error to the user is to use
667'bfd_perror'.
668
6692.2.1 Type 'bfd_error_type'
670---------------------------
671
672The values returned by 'bfd_get_error' are defined by the enumerated
673type 'bfd_error_type'.
674
675
676     typedef enum bfd_error
677     {
678       bfd_error_no_error = 0,
679       bfd_error_system_call,
680       bfd_error_invalid_target,
681       bfd_error_wrong_format,
682       bfd_error_wrong_object_format,
683       bfd_error_invalid_operation,
684       bfd_error_no_memory,
685       bfd_error_no_symbols,
686       bfd_error_no_armap,
687       bfd_error_no_more_archived_files,
688       bfd_error_malformed_archive,
689       bfd_error_missing_dso,
690       bfd_error_file_not_recognized,
691       bfd_error_file_ambiguously_recognized,
692       bfd_error_no_contents,
693       bfd_error_nonrepresentable_section,
694       bfd_error_no_debug_section,
695       bfd_error_bad_value,
696       bfd_error_file_truncated,
697       bfd_error_file_too_big,
698       bfd_error_on_input,
699       bfd_error_invalid_error_code
700     }
701     bfd_error_type;
702
703
7042.2.1.1 'bfd_get_error'
705.......................
706
707*Synopsis*
708     bfd_error_type bfd_get_error (void);
709   *Description*
710Return the current BFD error condition.
711
7122.2.1.2 'bfd_set_error'
713.......................
714
715*Synopsis*
716     void bfd_set_error (bfd_error_type error_tag);
717   *Description*
718Set the BFD error condition to be ERROR_TAG.
719
720   ERROR_TAG must not be bfd_error_on_input.  Use bfd_set_input_error
721for input errors instead.
722
7232.2.1.3 'bfd_set_input_error'
724.............................
725
726*Synopsis*
727     void bfd_set_input_error (bfd *input, bfd_error_type error_tag);
728   *Description*
729Set the BFD error condition to be bfd_error_on_input.  INPUT is the
730input bfd where the error occurred, and ERROR_TAG the bfd_error_type
731error.
732
7332.2.1.4 'bfd_errmsg'
734....................
735
736*Synopsis*
737     const char *bfd_errmsg (bfd_error_type error_tag);
738   *Description*
739Return a string describing the error ERROR_TAG, or the system error if
740ERROR_TAG is 'bfd_error_system_call'.
741
7422.2.1.5 'bfd_perror'
743....................
744
745*Synopsis*
746     void bfd_perror (const char *message);
747   *Description*
748Print to the standard error stream a string describing the last BFD
749error that occurred, or the last system error if the last BFD error was
750a system call failure.  If MESSAGE is non-NULL and non-empty, the error
751string printed is preceded by MESSAGE, a colon, and a space.  It is
752followed by a newline.
753
7542.2.2 BFD error handler
755-----------------------
756
757Some BFD functions want to print messages describing the problem.  They
758call a BFD error handler function.  This function may be overridden by
759the program.
760
761   The BFD error handler acts like vprintf.
762
763
764     typedef void (*bfd_error_handler_type) (const char *, va_list);
765
766
7672.2.2.1 '_bfd_error_handler'
768............................
769
770*Synopsis*
771     void _bfd_error_handler (const char *fmt, ...) ATTRIBUTE_PRINTF_1;
772   *Description*
773This is the default routine to handle BFD error messages.  Like fprintf
774(stderr, ...), but also handles some extra format specifiers.
775
776   %pA section name from section.  For group components, prints group
777name too.  %pB file name from bfd.  For archive components, prints
778archive too.
779
780   Beware: Only supports a maximum of 9 format arguments.
781
7822.2.2.2 'bfd_set_error_handler'
783...............................
784
785*Synopsis*
786     bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type);
787   *Description*
788Set the BFD error handler function.  Returns the previous function.
789
7902.2.2.3 'bfd_set_error_program_name'
791....................................
792
793*Synopsis*
794     void bfd_set_error_program_name (const char *);
795   *Description*
796Set the program name to use when printing a BFD error.  This is printed
797before the error message followed by a colon and space.  The string must
798not be changed after it is passed to this function.
799
8002.2.3 BFD assert handler
801------------------------
802
803If BFD finds an internal inconsistency, the bfd assert handler is called
804with information on the BFD version, BFD source file and line.  If this
805happens, most programs linked against BFD are expected to want to exit
806with an error, or mark the current BFD operation as failed, so it is
807recommended to override the default handler, which just calls
808_bfd_error_handler and continues.
809
810
811     typedef void (*bfd_assert_handler_type) (const char *bfd_formatmsg,
812                                              const char *bfd_version,
813                                              const char *bfd_file,
814                                              int bfd_line);
815
816
8172.2.3.1 'bfd_set_assert_handler'
818................................
819
820*Synopsis*
821     bfd_assert_handler_type bfd_set_assert_handler (bfd_assert_handler_type);
822   *Description*
823Set the BFD assert handler function.  Returns the previous function.
824
825
826File: bfd.info,  Node: Miscellaneous,  Next: Memory Usage,  Prev: Error reporting,  Up: BFD front end
827
8282.3 Miscellaneous
829=================
830
8312.3.1 Miscellaneous functions
832-----------------------------
833
8342.3.1.1 'bfd_get_reloc_upper_bound'
835...................................
836
837*Synopsis*
838     long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect);
839   *Description*
840Return the number of bytes required to store the relocation information
841associated with section SECT attached to bfd ABFD.  If an error occurs,
842return -1.
843
8442.3.1.2 'bfd_canonicalize_reloc'
845................................
846
847*Synopsis*
848     long bfd_canonicalize_reloc
849        (bfd *abfd, asection *sec, arelent **loc, asymbol **syms);
850   *Description*
851Call the back end associated with the open BFD ABFD and translate the
852external form of the relocation information attached to SEC into the
853internal canonical form.  Place the table into memory at LOC, which has
854been preallocated, usually by a call to 'bfd_get_reloc_upper_bound'.
855Returns the number of relocs, or -1 on error.
856
857   The SYMS table is also needed for horrible internal magic reasons.
858
8592.3.1.3 'bfd_set_reloc'
860.......................
861
862*Synopsis*
863     void bfd_set_reloc
864        (bfd *abfd, asection *sec, arelent **rel, unsigned int count);
865   *Description*
866Set the relocation pointer and count within section SEC to the values
867REL and COUNT.  The argument ABFD is ignored.
868     #define bfd_set_reloc(abfd, asect, location, count) \
869            BFD_SEND (abfd, _bfd_set_reloc, (abfd, asect, location, count))
870
8712.3.1.4 'bfd_set_file_flags'
872............................
873
874*Synopsis*
875     bfd_boolean bfd_set_file_flags (bfd *abfd, flagword flags);
876   *Description*
877Set the flag word in the BFD ABFD to the value FLAGS.
878
879   Possible errors are:
880
881   * 'bfd_error_wrong_format' - The target bfd was not of object format.
882   * 'bfd_error_invalid_operation' - The target bfd was open for
883     reading.
884   * 'bfd_error_invalid_operation' - The flag word contained a bit which
885     was not applicable to the type of file.  E.g., an attempt was made
886     to set the 'D_PAGED' bit on a BFD format which does not support
887     demand paging.
888
8892.3.1.5 'bfd_get_arch_size'
890...........................
891
892*Synopsis*
893     int bfd_get_arch_size (bfd *abfd);
894   *Description*
895Returns the normalized architecture address size, in bits, as determined
896by the object file's format.  By normalized, we mean either 32 or 64.
897For ELF, this information is included in the header.  Use
898bfd_arch_bits_per_address for number of bits in the architecture
899address.
900
901   *Returns*
902Returns the arch size in bits if known, '-1' otherwise.
903
9042.3.1.6 'bfd_get_sign_extend_vma'
905.................................
906
907*Synopsis*
908     int bfd_get_sign_extend_vma (bfd *abfd);
909   *Description*
910Indicates if the target architecture "naturally" sign extends an
911address.  Some architectures implicitly sign extend address values when
912they are converted to types larger than the size of an address.  For
913instance, bfd_get_start_address() will return an address sign extended
914to fill a bfd_vma when this is the case.
915
916   *Returns*
917Returns '1' if the target architecture is known to sign extend
918addresses, '0' if the target architecture is known to not sign extend
919addresses, and '-1' otherwise.
920
9212.3.1.7 'bfd_set_start_address'
922...............................
923
924*Synopsis*
925     bfd_boolean bfd_set_start_address (bfd *abfd, bfd_vma vma);
926   *Description*
927Make VMA the entry point of output BFD ABFD.
928
929   *Returns*
930Returns 'TRUE' on success, 'FALSE' otherwise.
931
9322.3.1.8 'bfd_get_gp_size'
933.........................
934
935*Synopsis*
936     unsigned int bfd_get_gp_size (bfd *abfd);
937   *Description*
938Return the maximum size of objects to be optimized using the GP register
939under MIPS ECOFF. This is typically set by the '-G' argument to the
940compiler, assembler or linker.
941
9422.3.1.9 'bfd_set_gp_size'
943.........................
944
945*Synopsis*
946     void bfd_set_gp_size (bfd *abfd, unsigned int i);
947   *Description*
948Set the maximum size of objects to be optimized using the GP register
949under ECOFF or MIPS ELF. This is typically set by the '-G' argument to
950the compiler, assembler or linker.
951
9522.3.1.10 'bfd_scan_vma'
953.......................
954
955*Synopsis*
956     bfd_vma bfd_scan_vma (const char *string, const char **end, int base);
957   *Description*
958Convert, like 'strtoul', a numerical expression STRING into a 'bfd_vma'
959integer, and return that integer.  (Though without as many bells and
960whistles as 'strtoul'.)  The expression is assumed to be unsigned (i.e.,
961positive).  If given a BASE, it is used as the base for conversion.  A
962base of 0 causes the function to interpret the string in hex if a
963leading "0x" or "0X" is found, otherwise in octal if a leading zero is
964found, otherwise in decimal.
965
966   If the value would overflow, the maximum 'bfd_vma' value is returned.
967
9682.3.1.11 'bfd_copy_private_header_data'
969.......................................
970
971*Synopsis*
972     bfd_boolean bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
973   *Description*
974Copy private BFD header information from the BFD IBFD to the the BFD
975OBFD.  This copies information that may require sections to exist, but
976does not require symbol tables.  Return 'true' on success, 'false' on
977error.  Possible error returns are:
978
979   * 'bfd_error_no_memory' - Not enough memory exists to create private
980     data for OBFD.
981     #define bfd_copy_private_header_data(ibfd, obfd) \
982            BFD_SEND (obfd, _bfd_copy_private_header_data, \
983                      (ibfd, obfd))
984
9852.3.1.12 'bfd_copy_private_bfd_data'
986....................................
987
988*Synopsis*
989     bfd_boolean bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
990   *Description*
991Copy private BFD information from the BFD IBFD to the the BFD OBFD.
992Return 'TRUE' on success, 'FALSE' on error.  Possible error returns are:
993
994   * 'bfd_error_no_memory' - Not enough memory exists to create private
995     data for OBFD.
996     #define bfd_copy_private_bfd_data(ibfd, obfd) \
997            BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
998                      (ibfd, obfd))
999
10002.3.1.13 'bfd_set_private_flags'
1001................................
1002
1003*Synopsis*
1004     bfd_boolean bfd_set_private_flags (bfd *abfd, flagword flags);
1005   *Description*
1006Set private BFD flag information in the BFD ABFD.  Return 'TRUE' on
1007success, 'FALSE' on error.  Possible error returns are:
1008
1009   * 'bfd_error_no_memory' - Not enough memory exists to create private
1010     data for OBFD.
1011     #define bfd_set_private_flags(abfd, flags) \
1012            BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
1013
10142.3.1.14 'Other functions'
1015..........................
1016
1017*Description*
1018The following functions exist but have not yet been documented.
1019     #define bfd_sizeof_headers(abfd, info) \
1020            BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
1021
1022     #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
1023            BFD_SEND (abfd, _bfd_find_nearest_line, \
1024                      (abfd, syms, sec, off, file, func, line, NULL))
1025
1026     #define bfd_find_nearest_line_discriminator(abfd, sec, syms, off, file, func, \
1027                                                line, disc) \
1028            BFD_SEND (abfd, _bfd_find_nearest_line, \
1029                      (abfd, syms, sec, off, file, func, line, disc))
1030
1031     #define bfd_find_line(abfd, syms, sym, file, line) \
1032            BFD_SEND (abfd, _bfd_find_line, \
1033                      (abfd, syms, sym, file, line))
1034
1035     #define bfd_find_inliner_info(abfd, file, func, line) \
1036            BFD_SEND (abfd, _bfd_find_inliner_info, \
1037                      (abfd, file, func, line))
1038
1039     #define bfd_debug_info_start(abfd) \
1040            BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
1041
1042     #define bfd_debug_info_end(abfd) \
1043            BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
1044
1045     #define bfd_debug_info_accumulate(abfd, section) \
1046            BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
1047
1048     #define bfd_stat_arch_elt(abfd, stat) \
1049            BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
1050
1051     #define bfd_update_armap_timestamp(abfd) \
1052            BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
1053
1054     #define bfd_set_arch_mach(abfd, arch, mach)\
1055            BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
1056
1057     #define bfd_relax_section(abfd, section, link_info, again) \
1058            BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
1059
1060     #define bfd_gc_sections(abfd, link_info) \
1061            BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
1062
1063     #define bfd_lookup_section_flags(link_info, flag_info, section) \
1064            BFD_SEND (abfd, _bfd_lookup_section_flags, (link_info, flag_info, section))
1065
1066     #define bfd_merge_sections(abfd, link_info) \
1067            BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
1068
1069     #define bfd_is_group_section(abfd, sec) \
1070            BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
1071
1072     #define bfd_discard_group(abfd, sec) \
1073            BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
1074
1075     #define bfd_link_hash_table_create(abfd) \
1076            BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
1077
1078     #define bfd_link_add_symbols(abfd, info) \
1079            BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
1080
1081     #define bfd_link_just_syms(abfd, sec, info) \
1082            BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
1083
1084     #define bfd_final_link(abfd, info) \
1085            BFD_SEND (abfd, _bfd_final_link, (abfd, info))
1086
1087     #define bfd_free_cached_info(abfd) \
1088            BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
1089
1090     #define bfd_get_dynamic_symtab_upper_bound(abfd) \
1091            BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
1092
1093     #define bfd_print_private_bfd_data(abfd, file)\
1094            BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
1095
1096     #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
1097            BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
1098
1099     #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
1100            BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
1101                                                        dyncount, dynsyms, ret))
1102
1103     #define bfd_get_dynamic_reloc_upper_bound(abfd) \
1104            BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
1105
1106     #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
1107            BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
1108
1109     extern bfd_byte *bfd_get_relocated_section_contents
1110       (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
1111        bfd_boolean, asymbol **);
1112
1113
11142.3.1.15 'bfd_alt_mach_code'
1115............................
1116
1117*Synopsis*
1118     bfd_boolean bfd_alt_mach_code (bfd *abfd, int alternative);
1119   *Description*
1120When more than one machine code number is available for the same machine
1121type, this function can be used to switch between the preferred one
1122(alternative == 0) and any others.  Currently, only ELF supports this
1123feature, with up to two alternate machine codes.
1124
11252.3.1.16 'bfd_emul_get_maxpagesize'
1126...................................
1127
1128*Synopsis*
1129     bfd_vma bfd_emul_get_maxpagesize (const char *);
1130   *Description*
1131Returns the maximum page size, in bytes, as determined by emulation.
1132
1133   *Returns*
1134Returns the maximum page size in bytes for ELF, 0 otherwise.
1135
11362.3.1.17 'bfd_emul_set_maxpagesize'
1137...................................
1138
1139*Synopsis*
1140     void bfd_emul_set_maxpagesize (const char *, bfd_vma);
1141   *Description*
1142For ELF, set the maximum page size for the emulation.  It is a no-op for
1143other formats.
1144
11452.3.1.18 'bfd_emul_get_commonpagesize'
1146......................................
1147
1148*Synopsis*
1149     bfd_vma bfd_emul_get_commonpagesize (const char *, bfd_boolean);
1150   *Description*
1151Returns the common page size, in bytes, as determined by emulation.
1152
1153   *Returns*
1154Returns the common page size in bytes for ELF, 0 otherwise.
1155
11562.3.1.19 'bfd_emul_set_commonpagesize'
1157......................................
1158
1159*Synopsis*
1160     void bfd_emul_set_commonpagesize (const char *, bfd_vma);
1161   *Description*
1162For ELF, set the common page size for the emulation.  It is a no-op for
1163other formats.
1164
11652.3.1.20 'bfd_demangle'
1166.......................
1167
1168*Synopsis*
1169     char *bfd_demangle (bfd *, const char *, int);
1170   *Description*
1171Wrapper around cplus_demangle.  Strips leading underscores and other
1172such chars that would otherwise confuse the demangler.  If passed a g++
1173v3 ABI mangled name, returns a buffer allocated with malloc holding the
1174demangled name.  Returns NULL otherwise and on memory alloc failure.
1175
11762.3.1.21 'bfd_update_compression_header'
1177........................................
1178
1179*Synopsis*
1180     void bfd_update_compression_header
1181        (bfd *abfd, bfd_byte *contents, asection *sec);
1182   *Description*
1183Set the compression header at CONTENTS of SEC in ABFD and update
1184elf_section_flags for compression.
1185
11862.3.1.22 'bfd_check_compression_header'
1187.......................................
1188
1189*Synopsis*
1190     bfd_boolean bfd_check_compression_header
1191        (bfd *abfd, bfd_byte *contents, asection *sec,
1192         bfd_size_type *uncompressed_size);
1193   *Description*
1194Check the compression header at CONTENTS of SEC in ABFD and store the
1195uncompressed size in UNCOMPRESSED_SIZE if the compression header is
1196valid.
1197
1198   *Returns*
1199Return TRUE if the compression header is valid.
1200
12012.3.1.23 'bfd_get_compression_header_size'
1202..........................................
1203
1204*Synopsis*
1205     int bfd_get_compression_header_size (bfd *abfd, asection *sec);
1206   *Description*
1207Return the size of the compression header of SEC in ABFD.
1208
1209   *Returns*
1210Return the size of the compression header in bytes.
1211
12122.3.1.24 'bfd_convert_section_size'
1213...................................
1214
1215*Synopsis*
1216     bfd_size_type bfd_convert_section_size
1217        (bfd *ibfd, asection *isec, bfd *obfd, bfd_size_type size);
1218   *Description*
1219Convert the size SIZE of the section ISEC in input BFD IBFD to the
1220section size in output BFD OBFD.
1221
12222.3.1.25 'bfd_convert_section_contents'
1223.......................................
1224
1225*Synopsis*
1226     bfd_boolean bfd_convert_section_contents
1227        (bfd *ibfd, asection *isec, bfd *obfd,
1228         bfd_byte **ptr, bfd_size_type *ptr_size);
1229   *Description*
1230Convert the contents, stored in *PTR, of the section ISEC in input BFD
1231IBFD to output BFD OBFD if needed.  The original buffer pointed to by
1232*PTR may be freed and *PTR is returned with memory malloc'd by this
1233function, and the new size written to PTR_SIZE.
1234
12352.3.1.26 'struct bfd_iovec'
1236...........................
1237
1238*Description*
1239The 'struct bfd_iovec' contains the internal file I/O class.  Each 'BFD'
1240has an instance of this class and all file I/O is routed through it (it
1241is assumed that the instance implements all methods listed below).
1242     struct bfd_iovec
1243     {
1244       /* To avoid problems with macros, a "b" rather than "f"
1245          prefix is prepended to each method name.  */
1246       /* Attempt to read/write NBYTES on ABFD's IOSTREAM storing/fetching
1247          bytes starting at PTR.  Return the number of bytes actually
1248          transfered (a read past end-of-file returns less than NBYTES),
1249          or -1 (setting bfd_error) if an error occurs.  */
1250       file_ptr (*bread) (struct bfd *abfd, void *ptr, file_ptr nbytes);
1251       file_ptr (*bwrite) (struct bfd *abfd, const void *ptr,
1252                           file_ptr nbytes);
1253       /* Return the current IOSTREAM file offset, or -1 (setting bfd_error
1254          if an error occurs.  */
1255       file_ptr (*btell) (struct bfd *abfd);
1256       /* For the following, on successful completion a value of 0 is returned.
1257          Otherwise, a value of -1 is returned (and bfd_error is set).  */
1258       int (*bseek) (struct bfd *abfd, file_ptr offset, int whence);
1259       int (*bclose) (struct bfd *abfd);
1260       int (*bflush) (struct bfd *abfd);
1261       int (*bstat) (struct bfd *abfd, struct stat *sb);
1262       /* Mmap a part of the files. ADDR, LEN, PROT, FLAGS and OFFSET are the usual
1263          mmap parameter, except that LEN and OFFSET do not need to be page
1264          aligned.  Returns (void *)-1 on failure, mmapped address on success.
1265          Also write in MAP_ADDR the address of the page aligned buffer and in
1266          MAP_LEN the size mapped (a page multiple).  Use unmap with MAP_ADDR and
1267          MAP_LEN to unmap.  */
1268       void *(*bmmap) (struct bfd *abfd, void *addr, bfd_size_type len,
1269                       int prot, int flags, file_ptr offset,
1270                       void **map_addr, bfd_size_type *map_len);
1271     };
1272     extern const struct bfd_iovec _bfd_memory_iovec;
1273
12742.3.1.27 'bfd_get_mtime'
1275........................
1276
1277*Synopsis*
1278     long bfd_get_mtime (bfd *abfd);
1279   *Description*
1280Return the file modification time (as read from the file system, or from
1281the archive header for archive members).
1282
12832.3.1.28 'bfd_get_size'
1284.......................
1285
1286*Synopsis*
1287     ufile_ptr bfd_get_size (bfd *abfd);
1288   *Description*
1289Return the file size (as read from file system) for the file associated
1290with BFD ABFD.
1291
1292   The initial motivation for, and use of, this routine is not so we can
1293get the exact size of the object the BFD applies to, since that might
1294not be generally possible (archive members for example).  It would be
1295ideal if someone could eventually modify it so that such results were
1296guaranteed.
1297
1298   Instead, we want to ask questions like "is this NNN byte sized object
1299I'm about to try read from file offset YYY reasonable?"  As as example
1300of where we might do this, some object formats use string tables for
1301which the first 'sizeof (long)' bytes of the table contain the size of
1302the table itself, including the size bytes.  If an application tries to
1303read what it thinks is one of these string tables, without some way to
1304validate the size, and for some reason the size is wrong (byte swapping
1305error, wrong location for the string table, etc.), the only clue is
1306likely to be a read error when it tries to read the table, or a "virtual
1307memory exhausted" error when it tries to allocate 15 bazillon bytes of
1308space for the 15 bazillon byte table it is about to read.  This function
1309at least allows us to answer the question, "is the size reasonable?".
1310
13112.3.1.29 'bfd_get_file_size'
1312............................
1313
1314*Synopsis*
1315     ufile_ptr bfd_get_file_size (bfd *abfd);
1316   *Description*
1317Return the file size (as read from file system) for the file associated
1318with BFD ABFD.  It supports both normal files and archive elements.
1319
13202.3.1.30 'bfd_mmap'
1321...................
1322
1323*Synopsis*
1324     void *bfd_mmap (bfd *abfd, void *addr, bfd_size_type len,
1325         int prot, int flags, file_ptr offset,
1326         void **map_addr, bfd_size_type *map_len);
1327   *Description*
1328Return mmap()ed region of the file, if possible and implemented.  LEN
1329and OFFSET do not need to be page aligned.  The page aligned address and
1330length are written to MAP_ADDR and MAP_LEN.
1331
1332
1333File: bfd.info,  Node: Memory Usage,  Next: Initialization,  Prev: Miscellaneous,  Up: BFD front end
1334
13352.4 Memory Usage
1336================
1337
1338BFD keeps all of its internal structures in obstacks.  There is one
1339obstack per open BFD file, into which the current state is stored.  When
1340a BFD is closed, the obstack is deleted, and so everything which has
1341been allocated by BFD for the closing file is thrown away.
1342
1343   BFD does not free anything created by an application, but pointers
1344into 'bfd' structures become invalid on a 'bfd_close'; for example,
1345after a 'bfd_close' the vector passed to 'bfd_canonicalize_symtab' is
1346still around, since it has been allocated by the application, but the
1347data that it pointed to are lost.
1348
1349   The general rule is to not close a BFD until all operations dependent
1350upon data from the BFD have been completed, or all the data from within
1351the file has been copied.  To help with the management of memory, there
1352is a function ('bfd_alloc_size') which returns the number of bytes in
1353obstacks associated with the supplied BFD. This could be used to select
1354the greediest open BFD, close it to reclaim the memory, perform some
1355operation and reopen the BFD again, to get a fresh copy of the data
1356structures.
1357
1358
1359File: bfd.info,  Node: Initialization,  Next: Sections,  Prev: Memory Usage,  Up: BFD front end
1360
13612.5 Initialization
1362==================
1363
13642.5.1 Initialization functions
1365------------------------------
1366
1367These are the functions that handle initializing a BFD.
1368
13692.5.1.1 'bfd_init'
1370..................
1371
1372*Synopsis*
1373     void bfd_init (void);
1374   *Description*
1375This routine must be called before any other BFD function to initialize
1376magical internal data structures.
1377
1378
1379File: bfd.info,  Node: Sections,  Next: Symbols,  Prev: Initialization,  Up: BFD front end
1380
13812.6 Sections
1382============
1383
1384The raw data contained within a BFD is maintained through the section
1385abstraction.  A single BFD may have any number of sections.  It keeps
1386hold of them by pointing to the first; each one points to the next in
1387the list.
1388
1389   Sections are supported in BFD in 'section.c'.
1390
1391* Menu:
1392
1393* Section Input::
1394* Section Output::
1395* typedef asection::
1396* section prototypes::
1397
1398
1399File: bfd.info,  Node: Section Input,  Next: Section Output,  Prev: Sections,  Up: Sections
1400
14012.6.1 Section input
1402-------------------
1403
1404When a BFD is opened for reading, the section structures are created and
1405attached to the BFD.
1406
1407   Each section has a name which describes the section in the outside
1408world--for example, 'a.out' would contain at least three sections,
1409called '.text', '.data' and '.bss'.
1410
1411   Names need not be unique; for example a COFF file may have several
1412sections named '.data'.
1413
1414   Sometimes a BFD will contain more than the "natural" number of
1415sections.  A back end may attach other sections containing constructor
1416data, or an application may add a section (using 'bfd_make_section') to
1417the sections attached to an already open BFD. For example, the linker
1418creates an extra section 'COMMON' for each input file's BFD to hold
1419information about common storage.
1420
1421   The raw data is not necessarily read in when the section descriptor
1422is created.  Some targets may leave the data in place until a
1423'bfd_get_section_contents' call is made.  Other back ends may read in
1424all the data at once.  For example, an S-record file has to be read once
1425to determine the size of the data.
1426
1427
1428File: bfd.info,  Node: Section Output,  Next: typedef asection,  Prev: Section Input,  Up: Sections
1429
14302.6.2 Section output
1431--------------------
1432
1433To write a new object style BFD, the various sections to be written have
1434to be created.  They are attached to the BFD in the same way as input
1435sections; data is written to the sections using
1436'bfd_set_section_contents'.
1437
1438   Any program that creates or combines sections (e.g., the assembler
1439and linker) must use the 'asection' fields 'output_section' and
1440'output_offset' to indicate the file sections to which each section must
1441be written.  (If the section is being created from scratch,
1442'output_section' should probably point to the section itself and
1443'output_offset' should probably be zero.)
1444
1445   The data to be written comes from input sections attached (via
1446'output_section' pointers) to the output sections.  The output section
1447structure can be considered a filter for the input section: the output
1448section determines the vma of the output data and the name, but the
1449input section determines the offset into the output section of the data
1450to be written.
1451
1452   E.g., to create a section "O", starting at 0x100, 0x123 long,
1453containing two subsections, "A" at offset 0x0 (i.e., at vma 0x100) and
1454"B" at offset 0x20 (i.e., at vma 0x120) the 'asection' structures would
1455look like:
1456
1457        section name          "A"
1458          output_offset   0x00
1459          size            0x20
1460          output_section ----------->  section name    "O"
1461                                  |    vma             0x100
1462        section name          "B" |    size            0x123
1463          output_offset   0x20    |
1464          size            0x103   |
1465          output_section  --------|
1466
14672.6.3 Link orders
1468-----------------
1469
1470The data within a section is stored in a "link_order".  These are much
1471like the fixups in 'gas'.  The link_order abstraction allows a section
1472to grow and shrink within itself.
1473
1474   A link_order knows how big it is, and which is the next link_order
1475and where the raw data for it is; it also points to a list of
1476relocations which apply to it.
1477
1478   The link_order is used by the linker to perform relaxing on final
1479code.  The compiler creates code which is as big as necessary to make it
1480work without relaxing, and the user can select whether to relax.
1481Sometimes relaxing takes a lot of time.  The linker runs around the
1482relocations to see if any are attached to data which can be shrunk, if
1483so it does it on a link_order by link_order basis.
1484
1485
1486File: bfd.info,  Node: typedef asection,  Next: section prototypes,  Prev: Section Output,  Up: Sections
1487
14882.6.4 typedef asection
1489----------------------
1490
1491Here is the section structure:
1492
1493
1494     typedef struct bfd_section
1495     {
1496       /* The name of the section; the name isn't a copy, the pointer is
1497          the same as that passed to bfd_make_section.  */
1498       const char *name;
1499
1500       /* A unique sequence number.  */
1501       unsigned int id;
1502
1503       /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1504       unsigned int index;
1505
1506       /* The next section in the list belonging to the BFD, or NULL.  */
1507       struct bfd_section *next;
1508
1509       /* The previous section in the list belonging to the BFD, or NULL.  */
1510       struct bfd_section *prev;
1511
1512       /* The field flags contains attributes of the section. Some
1513          flags are read in from the object file, and some are
1514          synthesized from other information.  */
1515       flagword flags;
1516
1517     #define SEC_NO_FLAGS                      0x0
1518
1519       /* Tells the OS to allocate space for this section when loading.
1520          This is clear for a section containing debug information only.  */
1521     #define SEC_ALLOC                         0x1
1522
1523       /* Tells the OS to load the section from the file when loading.
1524          This is clear for a .bss section.  */
1525     #define SEC_LOAD                          0x2
1526
1527       /* The section contains data still to be relocated, so there is
1528          some relocation information too.  */
1529     #define SEC_RELOC                         0x4
1530
1531       /* A signal to the OS that the section contains read only data.  */
1532     #define SEC_READONLY                      0x8
1533
1534       /* The section contains code only.  */
1535     #define SEC_CODE                         0x10
1536
1537       /* The section contains data only.  */
1538     #define SEC_DATA                         0x20
1539
1540       /* The section will reside in ROM.  */
1541     #define SEC_ROM                          0x40
1542
1543       /* The section contains constructor information. This section
1544          type is used by the linker to create lists of constructors and
1545          destructors used by g++. When a back end sees a symbol
1546          which should be used in a constructor list, it creates a new
1547          section for the type of name (e.g., __CTOR_LIST__), attaches
1548          the symbol to it, and builds a relocation. To build the lists
1549          of constructors, all the linker has to do is catenate all the
1550          sections called __CTOR_LIST__ and relocate the data
1551          contained within - exactly the operations it would peform on
1552          standard data.  */
1553     #define SEC_CONSTRUCTOR                  0x80
1554
1555       /* The section has contents - a data section could be
1556          SEC_ALLOC | SEC_HAS_CONTENTS; a debug section could be
1557          SEC_HAS_CONTENTS  */
1558     #define SEC_HAS_CONTENTS                0x100
1559
1560       /* An instruction to the linker to not output the section
1561          even if it has information which would normally be written.  */
1562     #define SEC_NEVER_LOAD                  0x200
1563
1564       /* The section contains thread local data.  */
1565     #define SEC_THREAD_LOCAL                0x400
1566
1567       /* The section's size is fixed.  Generic linker code will not
1568          recalculate it and it is up to whoever has set this flag to
1569          get the size right.  */
1570     #define SEC_FIXED_SIZE                  0x800
1571
1572       /* The section contains common symbols (symbols may be defined
1573          multiple times, the value of a symbol is the amount of
1574          space it requires, and the largest symbol value is the one
1575          used).  Most targets have exactly one of these (which we
1576          translate to bfd_com_section_ptr), but ECOFF has two.  */
1577     #define SEC_IS_COMMON                  0x1000
1578
1579       /* The section contains only debugging information.  For
1580          example, this is set for ELF .debug and .stab sections.
1581          strip tests this flag to see if a section can be
1582          discarded.  */
1583     #define SEC_DEBUGGING                  0x2000
1584
1585       /* The contents of this section are held in memory pointed to
1586          by the contents field.  This is checked by bfd_get_section_contents,
1587          and the data is retrieved from memory if appropriate.  */
1588     #define SEC_IN_MEMORY                  0x4000
1589
1590       /* The contents of this section are to be excluded by the
1591          linker for executable and shared objects unless those
1592          objects are to be further relocated.  */
1593     #define SEC_EXCLUDE                    0x8000
1594
1595       /* The contents of this section are to be sorted based on the sum of
1596          the symbol and addend values specified by the associated relocation
1597          entries.  Entries without associated relocation entries will be
1598          appended to the end of the section in an unspecified order.  */
1599     #define SEC_SORT_ENTRIES              0x10000
1600
1601       /* When linking, duplicate sections of the same name should be
1602          discarded, rather than being combined into a single section as
1603          is usually done.  This is similar to how common symbols are
1604          handled.  See SEC_LINK_DUPLICATES below.  */
1605     #define SEC_LINK_ONCE                 0x20000
1606
1607       /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1608          should handle duplicate sections.  */
1609     #define SEC_LINK_DUPLICATES           0xc0000
1610
1611       /* This value for SEC_LINK_DUPLICATES means that duplicate
1612          sections with the same name should simply be discarded.  */
1613     #define SEC_LINK_DUPLICATES_DISCARD       0x0
1614
1615       /* This value for SEC_LINK_DUPLICATES means that the linker
1616          should warn if there are any duplicate sections, although
1617          it should still only link one copy.  */
1618     #define SEC_LINK_DUPLICATES_ONE_ONLY  0x40000
1619
1620       /* This value for SEC_LINK_DUPLICATES means that the linker
1621          should warn if any duplicate sections are a different size.  */
1622     #define SEC_LINK_DUPLICATES_SAME_SIZE 0x80000
1623
1624       /* This value for SEC_LINK_DUPLICATES means that the linker
1625          should warn if any duplicate sections contain different
1626          contents.  */
1627     #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1628       (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1629
1630       /* This section was created by the linker as part of dynamic
1631          relocation or other arcane processing.  It is skipped when
1632          going through the first-pass output, trusting that someone
1633          else up the line will take care of it later.  */
1634     #define SEC_LINKER_CREATED           0x100000
1635
1636       /* This section should not be subject to garbage collection.
1637          Also set to inform the linker that this section should not be
1638          listed in the link map as discarded.  */
1639     #define SEC_KEEP                     0x200000
1640
1641       /* This section contains "short" data, and should be placed
1642          "near" the GP.  */
1643     #define SEC_SMALL_DATA               0x400000
1644
1645       /* Attempt to merge identical entities in the section.
1646          Entity size is given in the entsize field.  */
1647     #define SEC_MERGE                    0x800000
1648
1649       /* If given with SEC_MERGE, entities to merge are zero terminated
1650          strings where entsize specifies character size instead of fixed
1651          size entries.  */
1652     #define SEC_STRINGS                 0x1000000
1653
1654       /* This section contains data about section groups.  */
1655     #define SEC_GROUP                   0x2000000
1656
1657       /* The section is a COFF shared library section.  This flag is
1658          only for the linker.  If this type of section appears in
1659          the input file, the linker must copy it to the output file
1660          without changing the vma or size.  FIXME: Although this
1661          was originally intended to be general, it really is COFF
1662          specific (and the flag was renamed to indicate this).  It
1663          might be cleaner to have some more general mechanism to
1664          allow the back end to control what the linker does with
1665          sections.  */
1666     #define SEC_COFF_SHARED_LIBRARY     0x4000000
1667
1668       /* This input section should be copied to output in reverse order
1669          as an array of pointers.  This is for ELF linker internal use
1670          only.  */
1671     #define SEC_ELF_REVERSE_COPY        0x4000000
1672
1673       /* This section contains data which may be shared with other
1674          executables or shared objects. This is for COFF only.  */
1675     #define SEC_COFF_SHARED             0x8000000
1676
1677       /* This section should be compressed.  This is for ELF linker
1678          internal use only.  */
1679     #define SEC_ELF_COMPRESS            0x8000000
1680
1681       /* When a section with this flag is being linked, then if the size of
1682          the input section is less than a page, it should not cross a page
1683          boundary.  If the size of the input section is one page or more,
1684          it should be aligned on a page boundary.  This is for TI
1685          TMS320C54X only.  */
1686     #define SEC_TIC54X_BLOCK           0x10000000
1687
1688       /* This section should be renamed.  This is for ELF linker
1689          internal use only.  */
1690     #define SEC_ELF_RENAME             0x10000000
1691
1692       /* Conditionally link this section; do not link if there are no
1693          references found to any symbol in the section.  This is for TI
1694          TMS320C54X only.  */
1695     #define SEC_TIC54X_CLINK           0x20000000
1696
1697       /* This section contains vliw code.  This is for Toshiba MeP only.  */
1698     #define SEC_MEP_VLIW               0x20000000
1699
1700       /* Indicate that section has the no read flag set. This happens
1701          when memory read flag isn't set. */
1702     #define SEC_COFF_NOREAD            0x40000000
1703
1704       /* Indicate that section has the purecode flag set.  */
1705     #define SEC_ELF_PURECODE           0x80000000
1706
1707       /*  End of section flags.  */
1708
1709       /* Some internal packed boolean fields.  */
1710
1711       /* See the vma field.  */
1712       unsigned int user_set_vma : 1;
1713
1714       /* A mark flag used by some of the linker backends.  */
1715       unsigned int linker_mark : 1;
1716
1717       /* Another mark flag used by some of the linker backends.  Set for
1718          output sections that have an input section.  */
1719       unsigned int linker_has_input : 1;
1720
1721       /* Mark flag used by some linker backends for garbage collection.  */
1722       unsigned int gc_mark : 1;
1723
1724       /* Section compression status.  */
1725       unsigned int compress_status : 2;
1726     #define COMPRESS_SECTION_NONE    0
1727     #define COMPRESS_SECTION_DONE    1
1728     #define DECOMPRESS_SECTION_SIZED 2
1729
1730       /* The following flags are used by the ELF linker. */
1731
1732       /* Mark sections which have been allocated to segments.  */
1733       unsigned int segment_mark : 1;
1734
1735       /* Type of sec_info information.  */
1736       unsigned int sec_info_type:3;
1737     #define SEC_INFO_TYPE_NONE      0
1738     #define SEC_INFO_TYPE_STABS     1
1739     #define SEC_INFO_TYPE_MERGE     2
1740     #define SEC_INFO_TYPE_EH_FRAME  3
1741     #define SEC_INFO_TYPE_JUST_SYMS 4
1742     #define SEC_INFO_TYPE_TARGET    5
1743     #define SEC_INFO_TYPE_EH_FRAME_ENTRY 6
1744
1745       /* Nonzero if this section uses RELA relocations, rather than REL.  */
1746       unsigned int use_rela_p:1;
1747
1748       /* Bits used by various backends.  The generic code doesn't touch
1749          these fields.  */
1750
1751       unsigned int sec_flg0:1;
1752       unsigned int sec_flg1:1;
1753       unsigned int sec_flg2:1;
1754       unsigned int sec_flg3:1;
1755       unsigned int sec_flg4:1;
1756       unsigned int sec_flg5:1;
1757
1758       /* End of internal packed boolean fields.  */
1759
1760       /*  The virtual memory address of the section - where it will be
1761           at run time.  The symbols are relocated against this.  The
1762           user_set_vma flag is maintained by bfd; if it's not set, the
1763           backend can assign addresses (for example, in a.out, where
1764           the default address for .data is dependent on the specific
1765           target and various flags).  */
1766       bfd_vma vma;
1767
1768       /*  The load address of the section - where it would be in a
1769           rom image; really only used for writing section header
1770           information.  */
1771       bfd_vma lma;
1772
1773       /* The size of the section in *octets*, as it will be output.
1774          Contains a value even if the section has no contents (e.g., the
1775          size of .bss).  */
1776       bfd_size_type size;
1777
1778       /* For input sections, the original size on disk of the section, in
1779          octets.  This field should be set for any section whose size is
1780          changed by linker relaxation.  It is required for sections where
1781          the linker relaxation scheme doesn't cache altered section and
1782          reloc contents (stabs, eh_frame, SEC_MERGE, some coff relaxing
1783          targets), and thus the original size needs to be kept to read the
1784          section multiple times.  For output sections, rawsize holds the
1785          section size calculated on a previous linker relaxation pass.  */
1786       bfd_size_type rawsize;
1787
1788       /* The compressed size of the section in octets.  */
1789       bfd_size_type compressed_size;
1790
1791       /* Relaxation table. */
1792       struct relax_table *relax;
1793
1794       /* Count of used relaxation table entries. */
1795       int relax_count;
1796
1797
1798       /* If this section is going to be output, then this value is the
1799          offset in *bytes* into the output section of the first byte in the
1800          input section (byte ==> smallest addressable unit on the
1801          target).  In most cases, if this was going to start at the
1802          100th octet (8-bit quantity) in the output section, this value
1803          would be 100.  However, if the target byte size is 16 bits
1804          (bfd_octets_per_byte is "2"), this value would be 50.  */
1805       bfd_vma output_offset;
1806
1807       /* The output section through which to map on output.  */
1808       struct bfd_section *output_section;
1809
1810       /* The alignment requirement of the section, as an exponent of 2 -
1811          e.g., 3 aligns to 2^3 (or 8).  */
1812       unsigned int alignment_power;
1813
1814       /* If an input section, a pointer to a vector of relocation
1815          records for the data in this section.  */
1816       struct reloc_cache_entry *relocation;
1817
1818       /* If an output section, a pointer to a vector of pointers to
1819          relocation records for the data in this section.  */
1820       struct reloc_cache_entry **orelocation;
1821
1822       /* The number of relocation records in one of the above.  */
1823       unsigned reloc_count;
1824
1825       /* Information below is back end specific - and not always used
1826          or updated.  */
1827
1828       /* File position of section data.  */
1829       file_ptr filepos;
1830
1831       /* File position of relocation info.  */
1832       file_ptr rel_filepos;
1833
1834       /* File position of line data.  */
1835       file_ptr line_filepos;
1836
1837       /* Pointer to data for applications.  */
1838       void *userdata;
1839
1840       /* If the SEC_IN_MEMORY flag is set, this points to the actual
1841          contents.  */
1842       unsigned char *contents;
1843
1844       /* Attached line number information.  */
1845       alent *lineno;
1846
1847       /* Number of line number records.  */
1848       unsigned int lineno_count;
1849
1850       /* Entity size for merging purposes.  */
1851       unsigned int entsize;
1852
1853       /* Points to the kept section if this section is a link-once section,
1854          and is discarded.  */
1855       struct bfd_section *kept_section;
1856
1857       /* When a section is being output, this value changes as more
1858          linenumbers are written out.  */
1859       file_ptr moving_line_filepos;
1860
1861       /* What the section number is in the target world.  */
1862       int target_index;
1863
1864       void *used_by_bfd;
1865
1866       /* If this is a constructor section then here is a list of the
1867          relocations created to relocate items within it.  */
1868       struct relent_chain *constructor_chain;
1869
1870       /* The BFD which owns the section.  */
1871       bfd *owner;
1872
1873       /* A symbol which points at this section only.  */
1874       struct bfd_symbol *symbol;
1875       struct bfd_symbol **symbol_ptr_ptr;
1876
1877       /* Early in the link process, map_head and map_tail are used to build
1878          a list of input sections attached to an output section.  Later,
1879          output sections use these fields for a list of bfd_link_order
1880          structs.  */
1881       union {
1882         struct bfd_link_order *link_order;
1883         struct bfd_section *s;
1884       } map_head, map_tail;
1885     } asection;
1886
1887     /* Relax table contains information about instructions which can
1888        be removed by relaxation -- replacing a long address with a
1889        short address.  */
1890     struct relax_table {
1891       /* Address where bytes may be deleted. */
1892       bfd_vma addr;
1893
1894       /* Number of bytes to be deleted.  */
1895       int size;
1896     };
1897
1898     /* Note: the following are provided as inline functions rather than macros
1899        because not all callers use the return value.  A macro implementation
1900        would use a comma expression, eg: "((ptr)->foo = val, TRUE)" and some
1901        compilers will complain about comma expressions that have no effect.  */
1902     static inline bfd_boolean
1903     bfd_set_section_userdata (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr,
1904                               void * val)
1905     {
1906       ptr->userdata = val;
1907       return TRUE;
1908     }
1909
1910     static inline bfd_boolean
1911     bfd_set_section_vma (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr, bfd_vma val)
1912     {
1913       ptr->vma = ptr->lma = val;
1914       ptr->user_set_vma = TRUE;
1915       return TRUE;
1916     }
1917
1918     static inline bfd_boolean
1919     bfd_set_section_alignment (bfd * abfd ATTRIBUTE_UNUSED, asection * ptr,
1920                                unsigned int val)
1921     {
1922       ptr->alignment_power = val;
1923       return TRUE;
1924     }
1925
1926     /* These sections are global, and are managed by BFD.  The application
1927        and target back end are not permitted to change the values in
1928        these sections.  */
1929     extern asection _bfd_std_section[4];
1930
1931     #define BFD_ABS_SECTION_NAME "*ABS*"
1932     #define BFD_UND_SECTION_NAME "*UND*"
1933     #define BFD_COM_SECTION_NAME "*COM*"
1934     #define BFD_IND_SECTION_NAME "*IND*"
1935
1936     /* Pointer to the common section.  */
1937     #define bfd_com_section_ptr (&_bfd_std_section[0])
1938     /* Pointer to the undefined section.  */
1939     #define bfd_und_section_ptr (&_bfd_std_section[1])
1940     /* Pointer to the absolute section.  */
1941     #define bfd_abs_section_ptr (&_bfd_std_section[2])
1942     /* Pointer to the indirect section.  */
1943     #define bfd_ind_section_ptr (&_bfd_std_section[3])
1944
1945     #define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
1946     #define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
1947     #define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
1948
1949     #define bfd_is_const_section(SEC)              \
1950      (   ((SEC) == bfd_abs_section_ptr)            \
1951       || ((SEC) == bfd_und_section_ptr)            \
1952       || ((SEC) == bfd_com_section_ptr)            \
1953       || ((SEC) == bfd_ind_section_ptr))
1954
1955     /* Macros to handle insertion and deletion of a bfd's sections.  These
1956        only handle the list pointers, ie. do not adjust section_count,
1957        target_index etc.  */
1958     #define bfd_section_list_remove(ABFD, S) \
1959       do                                                   \
1960         {                                                  \
1961           asection *_s = S;                                \
1962           asection *_next = _s->next;                      \
1963           asection *_prev = _s->prev;                      \
1964           if (_prev)                                       \
1965             _prev->next = _next;                           \
1966           else                                             \
1967             (ABFD)->sections = _next;                      \
1968           if (_next)                                       \
1969             _next->prev = _prev;                           \
1970           else                                             \
1971             (ABFD)->section_last = _prev;                  \
1972         }                                                  \
1973       while (0)
1974     #define bfd_section_list_append(ABFD, S) \
1975       do                                                   \
1976         {                                                  \
1977           asection *_s = S;                                \
1978           bfd *_abfd = ABFD;                               \
1979           _s->next = NULL;                                 \
1980           if (_abfd->section_last)                         \
1981             {                                              \
1982               _s->prev = _abfd->section_last;              \
1983               _abfd->section_last->next = _s;              \
1984             }                                              \
1985           else                                             \
1986             {                                              \
1987               _s->prev = NULL;                             \
1988               _abfd->sections = _s;                        \
1989             }                                              \
1990           _abfd->section_last = _s;                        \
1991         }                                                  \
1992       while (0)
1993     #define bfd_section_list_prepend(ABFD, S) \
1994       do                                                   \
1995         {                                                  \
1996           asection *_s = S;                                \
1997           bfd *_abfd = ABFD;                               \
1998           _s->prev = NULL;                                 \
1999           if (_abfd->sections)                             \
2000             {                                              \
2001               _s->next = _abfd->sections;                  \
2002               _abfd->sections->prev = _s;                  \
2003             }                                              \
2004           else                                             \
2005             {                                              \
2006               _s->next = NULL;                             \
2007               _abfd->section_last = _s;                    \
2008             }                                              \
2009           _abfd->sections = _s;                            \
2010         }                                                  \
2011       while (0)
2012     #define bfd_section_list_insert_after(ABFD, A, S) \
2013       do                                                   \
2014         {                                                  \
2015           asection *_a = A;                                \
2016           asection *_s = S;                                \
2017           asection *_next = _a->next;                      \
2018           _s->next = _next;                                \
2019           _s->prev = _a;                                   \
2020           _a->next = _s;                                   \
2021           if (_next)                                       \
2022             _next->prev = _s;                              \
2023           else                                             \
2024             (ABFD)->section_last = _s;                     \
2025         }                                                  \
2026       while (0)
2027     #define bfd_section_list_insert_before(ABFD, B, S) \
2028       do                                                   \
2029         {                                                  \
2030           asection *_b = B;                                \
2031           asection *_s = S;                                \
2032           asection *_prev = _b->prev;                      \
2033           _s->prev = _prev;                                \
2034           _s->next = _b;                                   \
2035           _b->prev = _s;                                   \
2036           if (_prev)                                       \
2037             _prev->next = _s;                              \
2038           else                                             \
2039             (ABFD)->sections = _s;                         \
2040         }                                                  \
2041       while (0)
2042     #define bfd_section_removed_from_list(ABFD, S) \
2043       ((S)->next == NULL ? (ABFD)->section_last != (S) : (S)->next->prev != (S))
2044
2045     #define BFD_FAKE_SECTION(SEC, SYM, NAME, IDX, FLAGS)                   \
2046       /* name, id,  index, next, prev, flags, user_set_vma,            */  \
2047       {  NAME, IDX, 0,     NULL, NULL, FLAGS, 0,                           \
2048                                                                            \
2049       /* linker_mark, linker_has_input, gc_mark, decompress_status,    */  \
2050          0,           0,                1,       0,                        \
2051                                                                            \
2052       /* segment_mark, sec_info_type, use_rela_p,                      */  \
2053          0,            0,             0,                                   \
2054                                                                            \
2055       /* sec_flg0, sec_flg1, sec_flg2, sec_flg3, sec_flg4, sec_flg5,   */  \
2056          0,        0,        0,        0,        0,        0,              \
2057                                                                            \
2058       /* vma, lma, size, rawsize, compressed_size, relax, relax_count, */  \
2059          0,   0,   0,    0,       0,               0,     0,               \
2060                                                                            \
2061       /* output_offset, output_section, alignment_power,               */  \
2062          0,             &SEC,           0,                                 \
2063                                                                            \
2064       /* relocation, orelocation, reloc_count, filepos, rel_filepos,   */  \
2065          NULL,       NULL,        0,           0,       0,                 \
2066                                                                            \
2067       /* line_filepos, userdata, contents, lineno, lineno_count,       */  \
2068          0,            NULL,     NULL,     NULL,   0,                      \
2069                                                                            \
2070       /* entsize, kept_section, moving_line_filepos,                    */ \
2071          0,       NULL,          0,                                        \
2072                                                                            \
2073       /* target_index, used_by_bfd, constructor_chain, owner,          */  \
2074          0,            NULL,        NULL,              NULL,               \
2075                                                                            \
2076       /* symbol,                    symbol_ptr_ptr,                    */  \
2077          (struct bfd_symbol *) SYM, &SEC.symbol,                           \
2078                                                                            \
2079       /* map_head, map_tail                                            */  \
2080          { NULL }, { NULL }                                                \
2081         }
2082
2083     /* We use a macro to initialize the static asymbol structures because
2084        traditional C does not permit us to initialize a union member while
2085        gcc warns if we don't initialize it.
2086        the_bfd, name, value, attr, section [, udata]  */
2087     #ifdef __STDC__
2088     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2089       { 0, NAME, 0, BSF_SECTION_SYM, SECTION, { 0 }}
2090     #else
2091     #define GLOBAL_SYM_INIT(NAME, SECTION) \
2092       { 0, NAME, 0, BSF_SECTION_SYM, SECTION }
2093     #endif
2094
2095
2096
2097File: bfd.info,  Node: section prototypes,  Prev: typedef asection,  Up: Sections
2098
20992.6.5 Section prototypes
2100------------------------
2101
2102These are the functions exported by the section handling part of BFD.
2103
21042.6.5.1 'bfd_section_list_clear'
2105................................
2106
2107*Synopsis*
2108     void bfd_section_list_clear (bfd *);
2109   *Description*
2110Clears the section list, and also resets the section count and hash
2111table entries.
2112
21132.6.5.2 'bfd_get_section_by_name'
2114.................................
2115
2116*Synopsis*
2117     asection *bfd_get_section_by_name (bfd *abfd, const char *name);
2118   *Description*
2119Return the most recently created section attached to ABFD named NAME.
2120Return NULL if no such section exists.
2121
21222.6.5.3 'bfd_get_next_section_by_name'
2123......................................
2124
2125*Synopsis*
2126     asection *bfd_get_next_section_by_name (bfd *ibfd, asection *sec);
2127   *Description*
2128Given SEC is a section returned by 'bfd_get_section_by_name', return the
2129next most recently created section attached to the same BFD with the
2130same name, or if no such section exists in the same BFD and IBFD is
2131non-NULL, the next section with the same name in any input BFD following
2132IBFD. Return NULL on finding no section.
2133
21342.6.5.4 'bfd_get_linker_section'
2135................................
2136
2137*Synopsis*
2138     asection *bfd_get_linker_section (bfd *abfd, const char *name);
2139   *Description*
2140Return the linker created section attached to ABFD named NAME.  Return
2141NULL if no such section exists.
2142
21432.6.5.5 'bfd_get_section_by_name_if'
2144....................................
2145
2146*Synopsis*
2147     asection *bfd_get_section_by_name_if
2148        (bfd *abfd,
2149         const char *name,
2150         bfd_boolean (*func) (bfd *abfd, asection *sect, void *obj),
2151         void *obj);
2152   *Description*
2153Call the provided function FUNC for each section attached to the BFD
2154ABFD whose name matches NAME, passing OBJ as an argument.  The function
2155will be called as if by
2156
2157            func (abfd, the_section, obj);
2158
2159   It returns the first section for which FUNC returns true, otherwise
2160'NULL'.
2161
21622.6.5.6 'bfd_get_unique_section_name'
2163.....................................
2164
2165*Synopsis*
2166     char *bfd_get_unique_section_name
2167        (bfd *abfd, const char *templat, int *count);
2168   *Description*
2169Invent a section name that is unique in ABFD by tacking a dot and a
2170digit suffix onto the original TEMPLAT.  If COUNT is non-NULL, then it
2171specifies the first number tried as a suffix to generate a unique name.
2172The value pointed to by COUNT will be incremented in this case.
2173
21742.6.5.7 'bfd_make_section_old_way'
2175..................................
2176
2177*Synopsis*
2178     asection *bfd_make_section_old_way (bfd *abfd, const char *name);
2179   *Description*
2180Create a new empty section called NAME and attach it to the end of the
2181chain of sections for the BFD ABFD.  An attempt to create a section with
2182a name which is already in use returns its pointer without changing the
2183section chain.
2184
2185   It has the funny name since this is the way it used to be before it
2186was rewritten....
2187
2188   Possible errors are:
2189
2190   * 'bfd_error_invalid_operation' - If output has already started for
2191     this BFD.
2192   * 'bfd_error_no_memory' - If memory allocation fails.
2193
21942.6.5.8 'bfd_make_section_anyway_with_flags'
2195............................................
2196
2197*Synopsis*
2198     asection *bfd_make_section_anyway_with_flags
2199        (bfd *abfd, const char *name, flagword flags);
2200   *Description*
2201Create a new empty section called NAME and attach it to the end of the
2202chain of sections for ABFD.  Create a new section even if there is
2203already a section with that name.  Also set the attributes of the new
2204section to the value FLAGS.
2205
2206   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2207
2208   * 'bfd_error_invalid_operation' - If output has already started for
2209     ABFD.
2210   * 'bfd_error_no_memory' - If memory allocation fails.
2211
22122.6.5.9 'bfd_make_section_anyway'
2213.................................
2214
2215*Synopsis*
2216     asection *bfd_make_section_anyway (bfd *abfd, const char *name);
2217   *Description*
2218Create a new empty section called NAME and attach it to the end of the
2219chain of sections for ABFD.  Create a new section even if there is
2220already a section with that name.
2221
2222   Return 'NULL' and set 'bfd_error' on error; possible errors are:
2223
2224   * 'bfd_error_invalid_operation' - If output has already started for
2225     ABFD.
2226   * 'bfd_error_no_memory' - If memory allocation fails.
2227
22282.6.5.10 'bfd_make_section_with_flags'
2229......................................
2230
2231*Synopsis*
2232     asection *bfd_make_section_with_flags
2233        (bfd *, const char *name, flagword flags);
2234   *Description*
2235Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2236bfd_set_error ()) without changing the section chain if there is already
2237a section named NAME.  Also set the attributes of the new section to the
2238value FLAGS.  If there is an error, return 'NULL' and set 'bfd_error'.
2239
22402.6.5.11 'bfd_make_section'
2241...........................
2242
2243*Synopsis*
2244     asection *bfd_make_section (bfd *, const char *name);
2245   *Description*
2246Like 'bfd_make_section_anyway', but return 'NULL' (without calling
2247bfd_set_error ()) without changing the section chain if there is already
2248a section named NAME.  If there is an error, return 'NULL' and set
2249'bfd_error'.
2250
22512.6.5.12 'bfd_set_section_flags'
2252................................
2253
2254*Synopsis*
2255     bfd_boolean bfd_set_section_flags
2256        (bfd *abfd, asection *sec, flagword flags);
2257   *Description*
2258Set the attributes of the section SEC in the BFD ABFD to the value
2259FLAGS.  Return 'TRUE' on success, 'FALSE' on error.  Possible error
2260returns are:
2261
2262   * 'bfd_error_invalid_operation' - The section cannot have one or more
2263     of the attributes requested.  For example, a .bss section in
2264     'a.out' may not have the 'SEC_HAS_CONTENTS' field set.
2265
22662.6.5.13 'bfd_rename_section'
2267.............................
2268
2269*Synopsis*
2270     void bfd_rename_section
2271        (bfd *abfd, asection *sec, const char *newname);
2272   *Description*
2273Rename section SEC in ABFD to NEWNAME.
2274
22752.6.5.14 'bfd_map_over_sections'
2276................................
2277
2278*Synopsis*
2279     void bfd_map_over_sections
2280        (bfd *abfd,
2281         void (*func) (bfd *abfd, asection *sect, void *obj),
2282         void *obj);
2283   *Description*
2284Call the provided function FUNC for each section attached to the BFD
2285ABFD, passing OBJ as an argument.  The function will be called as if by
2286
2287            func (abfd, the_section, obj);
2288
2289   This is the preferred method for iterating over sections; an
2290alternative would be to use a loop:
2291
2292               asection *p;
2293               for (p = abfd->sections; p != NULL; p = p->next)
2294                  func (abfd, p, ...)
2295
22962.6.5.15 'bfd_sections_find_if'
2297...............................
2298
2299*Synopsis*
2300     asection *bfd_sections_find_if
2301        (bfd *abfd,
2302         bfd_boolean (*operation) (bfd *abfd, asection *sect, void *obj),
2303         void *obj);
2304   *Description*
2305Call the provided function OPERATION for each section attached to the
2306BFD ABFD, passing OBJ as an argument.  The function will be called as if
2307by
2308
2309            operation (abfd, the_section, obj);
2310
2311   It returns the first section for which OPERATION returns true.
2312
23132.6.5.16 'bfd_set_section_size'
2314...............................
2315
2316*Synopsis*
2317     bfd_boolean bfd_set_section_size
2318        (bfd *abfd, asection *sec, bfd_size_type val);
2319   *Description*
2320Set SEC to the size VAL.  If the operation is ok, then 'TRUE' is
2321returned, else 'FALSE'.
2322
2323   Possible error returns:
2324
2325   * 'bfd_error_invalid_operation' - Writing has started to the BFD, so
2326     setting the size is invalid.
2327
23282.6.5.17 'bfd_set_section_contents'
2329...................................
2330
2331*Synopsis*
2332     bfd_boolean bfd_set_section_contents
2333        (bfd *abfd, asection *section, const void *data,
2334         file_ptr offset, bfd_size_type count);
2335   *Description*
2336Sets the contents of the section SECTION in BFD ABFD to the data
2337starting in memory at DATA.  The data is written to the output section
2338starting at offset OFFSET for COUNT octets.
2339
2340   Normally 'TRUE' is returned, else 'FALSE'.  Possible error returns
2341are:
2342
2343   * 'bfd_error_no_contents' - The output section does not have the
2344     'SEC_HAS_CONTENTS' attribute, so nothing can be written to it.
2345   * and some more too
2346   This routine is front end to the back end function
2347'_bfd_set_section_contents'.
2348
23492.6.5.18 'bfd_get_section_contents'
2350...................................
2351
2352*Synopsis*
2353     bfd_boolean bfd_get_section_contents
2354        (bfd *abfd, asection *section, void *location, file_ptr offset,
2355         bfd_size_type count);
2356   *Description*
2357Read data from SECTION in BFD ABFD into memory starting at LOCATION.
2358The data is read at an offset of OFFSET from the start of the input
2359section, and is read for COUNT bytes.
2360
2361   If the contents of a constructor with the 'SEC_CONSTRUCTOR' flag set
2362are requested or if the section does not have the 'SEC_HAS_CONTENTS'
2363flag set, then the LOCATION is filled with zeroes.  If no errors occur,
2364'TRUE' is returned, else 'FALSE'.
2365
23662.6.5.19 'bfd_malloc_and_get_section'
2367.....................................
2368
2369*Synopsis*
2370     bfd_boolean bfd_malloc_and_get_section
2371        (bfd *abfd, asection *section, bfd_byte **buf);
2372   *Description*
2373Read all data from SECTION in BFD ABFD into a buffer, *BUF, malloc'd by
2374this function.
2375
23762.6.5.20 'bfd_copy_private_section_data'
2377........................................
2378
2379*Synopsis*
2380     bfd_boolean bfd_copy_private_section_data
2381        (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
2382   *Description*
2383Copy private section information from ISEC in the BFD IBFD to the
2384section OSEC in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on
2385error.  Possible error returns are:
2386
2387   * 'bfd_error_no_memory' - Not enough memory exists to create private
2388     data for OSEC.
2389     #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
2390            BFD_SEND (obfd, _bfd_copy_private_section_data, \
2391                      (ibfd, isection, obfd, osection))
2392
23932.6.5.21 'bfd_generic_is_group_section'
2394.......................................
2395
2396*Synopsis*
2397     bfd_boolean bfd_generic_is_group_section (bfd *, const asection *sec);
2398   *Description*
2399Returns TRUE if SEC is a member of a group.
2400
24012.6.5.22 'bfd_generic_discard_group'
2402....................................
2403
2404*Synopsis*
2405     bfd_boolean bfd_generic_discard_group (bfd *abfd, asection *group);
2406   *Description*
2407Remove all members of GROUP from the output.
2408
2409
2410File: bfd.info,  Node: Symbols,  Next: Archives,  Prev: Sections,  Up: BFD front end
2411
24122.7 Symbols
2413===========
2414
2415BFD tries to maintain as much symbol information as it can when it moves
2416information from file to file.  BFD passes information to applications
2417though the 'asymbol' structure.  When the application requests the
2418symbol table, BFD reads the table in the native form and translates
2419parts of it into the internal format.  To maintain more than the
2420information passed to applications, some targets keep some information
2421"behind the scenes" in a structure only the particular back end knows
2422about.  For example, the coff back end keeps the original symbol table
2423structure as well as the canonical structure when a BFD is read in.  On
2424output, the coff back end can reconstruct the output symbol table so
2425that no information is lost, even information unique to coff which BFD
2426doesn't know or understand.  If a coff symbol table were read, but were
2427written through an a.out back end, all the coff specific information
2428would be lost.  The symbol table of a BFD is not necessarily read in
2429until a canonicalize request is made.  Then the BFD back end fills in a
2430table provided by the application with pointers to the canonical
2431information.  To output symbols, the application provides BFD with a
2432table of pointers to pointers to 'asymbol's.  This allows applications
2433like the linker to output a symbol as it was read, since the "behind the
2434scenes" information will be still available.
2435* Menu:
2436
2437* Reading Symbols::
2438* Writing Symbols::
2439* Mini Symbols::
2440* typedef asymbol::
2441* symbol handling functions::
2442
2443
2444File: bfd.info,  Node: Reading Symbols,  Next: Writing Symbols,  Prev: Symbols,  Up: Symbols
2445
24462.7.1 Reading symbols
2447---------------------
2448
2449There are two stages to reading a symbol table from a BFD: allocating
2450storage, and the actual reading process.  This is an excerpt from an
2451application which reads the symbol table:
2452
2453              long storage_needed;
2454              asymbol **symbol_table;
2455              long number_of_symbols;
2456              long i;
2457
2458              storage_needed = bfd_get_symtab_upper_bound (abfd);
2459
2460              if (storage_needed < 0)
2461                FAIL
2462
2463              if (storage_needed == 0)
2464                return;
2465
2466              symbol_table = xmalloc (storage_needed);
2467                ...
2468              number_of_symbols =
2469                 bfd_canonicalize_symtab (abfd, symbol_table);
2470
2471              if (number_of_symbols < 0)
2472                FAIL
2473
2474              for (i = 0; i < number_of_symbols; i++)
2475                process_symbol (symbol_table[i]);
2476
2477   All storage for the symbols themselves is in an objalloc connected to
2478the BFD; it is freed when the BFD is closed.
2479
2480
2481File: bfd.info,  Node: Writing Symbols,  Next: Mini Symbols,  Prev: Reading Symbols,  Up: Symbols
2482
24832.7.2 Writing symbols
2484---------------------
2485
2486Writing of a symbol table is automatic when a BFD open for writing is
2487closed.  The application attaches a vector of pointers to pointers to
2488symbols to the BFD being written, and fills in the symbol count.  The
2489close and cleanup code reads through the table provided and performs all
2490the necessary operations.  The BFD output code must always be provided
2491with an "owned" symbol: one which has come from another BFD, or one
2492which has been created using 'bfd_make_empty_symbol'.  Here is an
2493example showing the creation of a symbol table with only one element:
2494
2495            #include "sysdep.h"
2496            #include "bfd.h"
2497            int main (void)
2498            {
2499              bfd *abfd;
2500              asymbol *ptrs[2];
2501              asymbol *new;
2502
2503              abfd = bfd_openw ("foo","a.out-sunos-big");
2504              bfd_set_format (abfd, bfd_object);
2505              new = bfd_make_empty_symbol (abfd);
2506              new->name = "dummy_symbol";
2507              new->section = bfd_make_section_old_way (abfd, ".text");
2508              new->flags = BSF_GLOBAL;
2509              new->value = 0x12345;
2510
2511              ptrs[0] = new;
2512              ptrs[1] = 0;
2513
2514              bfd_set_symtab (abfd, ptrs, 1);
2515              bfd_close (abfd);
2516              return 0;
2517            }
2518
2519            ./makesym
2520            nm foo
2521            00012345 A dummy_symbol
2522
2523   Many formats cannot represent arbitrary symbol information; for
2524instance, the 'a.out' object format does not allow an arbitrary number
2525of sections.  A symbol pointing to a section which is not one of
2526'.text', '.data' or '.bss' cannot be described.
2527
2528
2529File: bfd.info,  Node: Mini Symbols,  Next: typedef asymbol,  Prev: Writing Symbols,  Up: Symbols
2530
25312.7.3 Mini Symbols
2532------------------
2533
2534Mini symbols provide read-only access to the symbol table.  They use
2535less memory space, but require more time to access.  They can be useful
2536for tools like nm or objdump, which may have to handle symbol tables of
2537extremely large executables.
2538
2539   The 'bfd_read_minisymbols' function will read the symbols into memory
2540in an internal form.  It will return a 'void *' pointer to a block of
2541memory, a symbol count, and the size of each symbol.  The pointer is
2542allocated using 'malloc', and should be freed by the caller when it is
2543no longer needed.
2544
2545   The function 'bfd_minisymbol_to_symbol' will take a pointer to a
2546minisymbol, and a pointer to a structure returned by
2547'bfd_make_empty_symbol', and return a 'asymbol' structure.  The return
2548value may or may not be the same as the value from
2549'bfd_make_empty_symbol' which was passed in.
2550
2551
2552File: bfd.info,  Node: typedef asymbol,  Next: symbol handling functions,  Prev: Mini Symbols,  Up: Symbols
2553
25542.7.4 typedef asymbol
2555---------------------
2556
2557An 'asymbol' has the form:
2558
2559
2560     typedef struct bfd_symbol
2561     {
2562       /* A pointer to the BFD which owns the symbol. This information
2563          is necessary so that a back end can work out what additional
2564          information (invisible to the application writer) is carried
2565          with the symbol.
2566
2567          This field is *almost* redundant, since you can use section->owner
2568          instead, except that some symbols point to the global sections
2569          bfd_{abs,com,und}_section.  This could be fixed by making
2570          these globals be per-bfd (or per-target-flavor).  FIXME.  */
2571       struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
2572
2573       /* The text of the symbol. The name is left alone, and not copied; the
2574          application may not alter it.  */
2575       const char *name;
2576
2577       /* The value of the symbol.  This really should be a union of a
2578          numeric value with a pointer, since some flags indicate that
2579          a pointer to another symbol is stored here.  */
2580       symvalue value;
2581
2582       /* Attributes of a symbol.  */
2583     #define BSF_NO_FLAGS            0
2584
2585       /* The symbol has local scope; static in C. The value
2586          is the offset into the section of the data.  */
2587     #define BSF_LOCAL               (1 << 0)
2588
2589       /* The symbol has global scope; initialized data in C. The
2590          value is the offset into the section of the data.  */
2591     #define BSF_GLOBAL              (1 << 1)
2592
2593       /* The symbol has global scope and is exported. The value is
2594          the offset into the section of the data.  */
2595     #define BSF_EXPORT              BSF_GLOBAL /* No real difference.  */
2596
2597       /* A normal C symbol would be one of:
2598          BSF_LOCAL, BSF_UNDEFINED or BSF_GLOBAL.  */
2599
2600       /* The symbol is a debugging record. The value has an arbitrary
2601          meaning, unless BSF_DEBUGGING_RELOC is also set.  */
2602     #define BSF_DEBUGGING           (1 << 2)
2603
2604       /* The symbol denotes a function entry point.  Used in ELF,
2605          perhaps others someday.  */
2606     #define BSF_FUNCTION            (1 << 3)
2607
2608       /* Used by the linker.  */
2609     #define BSF_KEEP                (1 << 5)
2610
2611       /* An ELF common symbol.  */
2612     #define BSF_ELF_COMMON          (1 << 6)
2613
2614       /* A weak global symbol, overridable without warnings by
2615          a regular global symbol of the same name.  */
2616     #define BSF_WEAK                (1 << 7)
2617
2618       /* This symbol was created to point to a section, e.g. ELF's
2619          STT_SECTION symbols.  */
2620     #define BSF_SECTION_SYM         (1 << 8)
2621
2622       /* The symbol used to be a common symbol, but now it is
2623          allocated.  */
2624     #define BSF_OLD_COMMON          (1 << 9)
2625
2626       /* In some files the type of a symbol sometimes alters its
2627          location in an output file - ie in coff a ISFCN symbol
2628          which is also C_EXT symbol appears where it was
2629          declared and not at the end of a section.  This bit is set
2630          by the target BFD part to convey this information.  */
2631     #define BSF_NOT_AT_END          (1 << 10)
2632
2633       /* Signal that the symbol is the label of constructor section.  */
2634     #define BSF_CONSTRUCTOR         (1 << 11)
2635
2636       /* Signal that the symbol is a warning symbol.  The name is a
2637          warning.  The name of the next symbol is the one to warn about;
2638          if a reference is made to a symbol with the same name as the next
2639          symbol, a warning is issued by the linker.  */
2640     #define BSF_WARNING             (1 << 12)
2641
2642       /* Signal that the symbol is indirect.  This symbol is an indirect
2643          pointer to the symbol with the same name as the next symbol.  */
2644     #define BSF_INDIRECT            (1 << 13)
2645
2646       /* BSF_FILE marks symbols that contain a file name.  This is used
2647          for ELF STT_FILE symbols.  */
2648     #define BSF_FILE                (1 << 14)
2649
2650       /* Symbol is from dynamic linking information.  */
2651     #define BSF_DYNAMIC             (1 << 15)
2652
2653       /* The symbol denotes a data object.  Used in ELF, and perhaps
2654          others someday.  */
2655     #define BSF_OBJECT              (1 << 16)
2656
2657       /* This symbol is a debugging symbol.  The value is the offset
2658          into the section of the data.  BSF_DEBUGGING should be set
2659          as well.  */
2660     #define BSF_DEBUGGING_RELOC     (1 << 17)
2661
2662       /* This symbol is thread local.  Used in ELF.  */
2663     #define BSF_THREAD_LOCAL        (1 << 18)
2664
2665       /* This symbol represents a complex relocation expression,
2666          with the expression tree serialized in the symbol name.  */
2667     #define BSF_RELC                (1 << 19)
2668
2669       /* This symbol represents a signed complex relocation expression,
2670          with the expression tree serialized in the symbol name.  */
2671     #define BSF_SRELC               (1 << 20)
2672
2673       /* This symbol was created by bfd_get_synthetic_symtab.  */
2674     #define BSF_SYNTHETIC           (1 << 21)
2675
2676       /* This symbol is an indirect code object.  Unrelated to BSF_INDIRECT.
2677          The dynamic linker will compute the value of this symbol by
2678          calling the function that it points to.  BSF_FUNCTION must
2679          also be also set.  */
2680     #define BSF_GNU_INDIRECT_FUNCTION (1 << 22)
2681       /* This symbol is a globally unique data object.  The dynamic linker
2682          will make sure that in the entire process there is just one symbol
2683          with this name and type in use.  BSF_OBJECT must also be set.  */
2684     #define BSF_GNU_UNIQUE          (1 << 23)
2685
2686       flagword flags;
2687
2688       /* A pointer to the section to which this symbol is
2689          relative.  This will always be non NULL, there are special
2690          sections for undefined and absolute symbols.  */
2691       struct bfd_section *section;
2692
2693       /* Back end special data.  */
2694       union
2695         {
2696           void *p;
2697           bfd_vma i;
2698         }
2699       udata;
2700     }
2701     asymbol;
2702
2703
2704
2705File: bfd.info,  Node: symbol handling functions,  Prev: typedef asymbol,  Up: Symbols
2706
27072.7.5 Symbol handling functions
2708-------------------------------
2709
27102.7.5.1 'bfd_get_symtab_upper_bound'
2711....................................
2712
2713*Description*
2714Return the number of bytes required to store a vector of pointers to
2715'asymbols' for all the symbols in the BFD ABFD, including a terminal
2716NULL pointer.  If there are no symbols in the BFD, then return 0.  If an
2717error occurs, return -1.
2718     #define bfd_get_symtab_upper_bound(abfd) \
2719            BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
2720
2721
27222.7.5.2 'bfd_is_local_label'
2723............................
2724
2725*Synopsis*
2726     bfd_boolean bfd_is_local_label (bfd *abfd, asymbol *sym);
2727   *Description*
2728Return TRUE if the given symbol SYM in the BFD ABFD is a compiler
2729generated local label, else return FALSE.
2730
27312.7.5.3 'bfd_is_local_label_name'
2732.................................
2733
2734*Synopsis*
2735     bfd_boolean bfd_is_local_label_name (bfd *abfd, const char *name);
2736   *Description*
2737Return TRUE if a symbol with the name NAME in the BFD ABFD is a compiler
2738generated local label, else return FALSE. This just checks whether the
2739name has the form of a local label.
2740     #define bfd_is_local_label_name(abfd, name) \
2741            BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
2742
2743
27442.7.5.4 'bfd_is_target_special_symbol'
2745......................................
2746
2747*Synopsis*
2748     bfd_boolean bfd_is_target_special_symbol (bfd *abfd, asymbol *sym);
2749   *Description*
2750Return TRUE iff a symbol SYM in the BFD ABFD is something special to the
2751particular target represented by the BFD. Such symbols should normally
2752not be mentioned to the user.
2753     #define bfd_is_target_special_symbol(abfd, sym) \
2754            BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
2755
2756
27572.7.5.5 'bfd_canonicalize_symtab'
2758.................................
2759
2760*Description*
2761Read the symbols from the BFD ABFD, and fills in the vector LOCATION
2762with pointers to the symbols and a trailing NULL. Return the actual
2763number of symbol pointers, not including the NULL.
2764     #define bfd_canonicalize_symtab(abfd, location) \
2765            BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
2766
2767
27682.7.5.6 'bfd_set_symtab'
2769........................
2770
2771*Synopsis*
2772     bfd_boolean bfd_set_symtab
2773        (bfd *abfd, asymbol **location, unsigned int count);
2774   *Description*
2775Arrange that when the output BFD ABFD is closed, the table LOCATION of
2776COUNT pointers to symbols will be written.
2777
27782.7.5.7 'bfd_print_symbol_vandf'
2779................................
2780
2781*Synopsis*
2782     void bfd_print_symbol_vandf (bfd *abfd, void *file, asymbol *symbol);
2783   *Description*
2784Print the value and flags of the SYMBOL supplied to the stream FILE.
2785
27862.7.5.8 'bfd_make_empty_symbol'
2787...............................
2788
2789*Description*
2790Create a new 'asymbol' structure for the BFD ABFD and return a pointer
2791to it.
2792
2793   This routine is necessary because each back end has private
2794information surrounding the 'asymbol'.  Building your own 'asymbol' and
2795pointing to it will not create the private information, and will cause
2796problems later on.
2797     #define bfd_make_empty_symbol(abfd) \
2798            BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
2799
2800
28012.7.5.9 '_bfd_generic_make_empty_symbol'
2802........................................
2803
2804*Synopsis*
2805     asymbol *_bfd_generic_make_empty_symbol (bfd *);
2806   *Description*
2807Create a new 'asymbol' structure for the BFD ABFD and return a pointer
2808to it.  Used by core file routines, binary back-end and anywhere else
2809where no private info is needed.
2810
28112.7.5.10 'bfd_make_debug_symbol'
2812................................
2813
2814*Description*
2815Create a new 'asymbol' structure for the BFD ABFD, to be used as a
2816debugging symbol.  Further details of its use have yet to be worked out.
2817     #define bfd_make_debug_symbol(abfd,ptr,size) \
2818            BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
2819
2820
28212.7.5.11 'bfd_decode_symclass'
2822..............................
2823
2824*Description*
2825Return a character corresponding to the symbol class of SYMBOL, or '?'
2826for an unknown class.
2827
2828   *Synopsis*
2829     int bfd_decode_symclass (asymbol *symbol);
2830
28312.7.5.12 'bfd_is_undefined_symclass'
2832....................................
2833
2834*Description*
2835Returns non-zero if the class symbol returned by bfd_decode_symclass
2836represents an undefined symbol.  Returns zero otherwise.
2837
2838   *Synopsis*
2839     bfd_boolean bfd_is_undefined_symclass (int symclass);
2840
28412.7.5.13 'bfd_symbol_info'
2842..........................
2843
2844*Description*
2845Fill in the basic info about symbol that nm needs.  Additional info may
2846be added by the back-ends after calling this function.
2847
2848   *Synopsis*
2849     void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
2850
28512.7.5.14 'bfd_copy_private_symbol_data'
2852.......................................
2853
2854*Synopsis*
2855     bfd_boolean bfd_copy_private_symbol_data
2856        (bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym);
2857   *Description*
2858Copy private symbol information from ISYM in the BFD IBFD to the symbol
2859OSYM in the BFD OBFD.  Return 'TRUE' on success, 'FALSE' on error.
2860Possible error returns are:
2861
2862   * 'bfd_error_no_memory' - Not enough memory exists to create private
2863     data for OSEC.
2864     #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
2865            BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
2866                      (ibfd, isymbol, obfd, osymbol))
2867
2868
2869
2870File: bfd.info,  Node: Archives,  Next: Formats,  Prev: Symbols,  Up: BFD front end
2871
28722.8 Archives
2873============
2874
2875*Description*
2876An archive (or library) is just another BFD. It has a symbol table,
2877although there's not much a user program will do with it.
2878
2879   The big difference between an archive BFD and an ordinary BFD is that
2880the archive doesn't have sections.  Instead it has a chain of BFDs that
2881are considered its contents.  These BFDs can be manipulated like any
2882other.  The BFDs contained in an archive opened for reading will all be
2883opened for reading.  You may put either input or output BFDs into an
2884archive opened for output; they will be handled correctly when the
2885archive is closed.
2886
2887   Use 'bfd_openr_next_archived_file' to step through the contents of an
2888archive opened for input.  You don't have to read the entire archive if
2889you don't want to!  Read it until you find what you want.
2890
2891   A BFD returned by 'bfd_openr_next_archived_file' can be closed
2892manually with 'bfd_close'.  If you do not close it, then a second
2893iteration through the members of an archive may return the same BFD. If
2894you close the archive BFD, then all the member BFDs will automatically
2895be closed as well.
2896
2897   Archive contents of output BFDs are chained through the
2898'archive_next' pointer in a BFD. The first one is findable through the
2899'archive_head' slot of the archive.  Set it with 'bfd_set_archive_head'
2900(q.v.).  A given BFD may be in only one open output archive at a time.
2901
2902   As expected, the BFD archive code is more general than the archive
2903code of any given environment.  BFD archives may contain files of
2904different formats (e.g., a.out and coff) and even different
2905architectures.  You may even place archives recursively into archives!
2906
2907   This can cause unexpected confusion, since some archive formats are
2908more expressive than others.  For instance, Intel COFF archives can
2909preserve long filenames; SunOS a.out archives cannot.  If you move a
2910file from the first to the second format and back again, the filename
2911may be truncated.  Likewise, different a.out environments have different
2912conventions as to how they truncate filenames, whether they preserve
2913directory names in filenames, etc.  When interoperating with native
2914tools, be sure your files are homogeneous.
2915
2916   Beware: most of these formats do not react well to the presence of
2917spaces in filenames.  We do the best we can, but can't always handle
2918this case due to restrictions in the format of archives.  Many Unix
2919utilities are braindead in regards to spaces and such in filenames
2920anyway, so this shouldn't be much of a restriction.
2921
2922   Archives are supported in BFD in 'archive.c'.
2923
29242.8.1 Archive functions
2925-----------------------
2926
29272.8.1.1 'bfd_get_next_mapent'
2928.............................
2929
2930*Synopsis*
2931     symindex bfd_get_next_mapent
2932        (bfd *abfd, symindex previous, carsym **sym);
2933   *Description*
2934Step through archive ABFD's symbol table (if it has one).  Successively
2935update SYM with the next symbol's information, returning that symbol's
2936(internal) index into the symbol table.
2937
2938   Supply 'BFD_NO_MORE_SYMBOLS' as the PREVIOUS entry to get the first
2939one; returns 'BFD_NO_MORE_SYMBOLS' when you've already got the last one.
2940
2941   A 'carsym' is a canonical archive symbol.  The only user-visible
2942element is its name, a null-terminated string.
2943
29442.8.1.2 'bfd_set_archive_head'
2945..............................
2946
2947*Synopsis*
2948     bfd_boolean bfd_set_archive_head (bfd *output, bfd *new_head);
2949   *Description*
2950Set the head of the chain of BFDs contained in the archive OUTPUT to
2951NEW_HEAD.
2952
29532.8.1.3 'bfd_openr_next_archived_file'
2954......................................
2955
2956*Synopsis*
2957     bfd *bfd_openr_next_archived_file (bfd *archive, bfd *previous);
2958   *Description*
2959Provided a BFD, ARCHIVE, containing an archive and NULL, open an input
2960BFD on the first contained element and returns that.  Subsequent calls
2961should pass the archive and the previous return value to return a
2962created BFD to the next contained element.  NULL is returned when there
2963are no more.  Note - if you want to process the bfd returned by this
2964call be sure to call bfd_check_format() on it first.
2965
2966
2967File: bfd.info,  Node: Formats,  Next: Relocations,  Prev: Archives,  Up: BFD front end
2968
29692.9 File formats
2970================
2971
2972A format is a BFD concept of high level file contents type.  The formats
2973supported by BFD are:
2974
2975   * 'bfd_object'
2976   The BFD may contain data, symbols, relocations and debug info.
2977
2978   * 'bfd_archive'
2979   The BFD contains other BFDs and an optional index.
2980
2981   * 'bfd_core'
2982   The BFD contains the result of an executable core dump.
2983
29842.9.1 File format functions
2985---------------------------
2986
29872.9.1.1 'bfd_check_format'
2988..........................
2989
2990*Synopsis*
2991     bfd_boolean bfd_check_format (bfd *abfd, bfd_format format);
2992   *Description*
2993Verify if the file attached to the BFD ABFD is compatible with the
2994format FORMAT (i.e., one of 'bfd_object', 'bfd_archive' or 'bfd_core').
2995
2996   If the BFD has been set to a specific target before the call, only
2997the named target and format combination is checked.  If the target has
2998not been set, or has been set to 'default', then all the known target
2999backends is interrogated to determine a match.  If the default target
3000matches, it is used.  If not, exactly one target must recognize the
3001file, or an error results.
3002
3003   The function returns 'TRUE' on success, otherwise 'FALSE' with one of
3004the following error codes:
3005
3006   * 'bfd_error_invalid_operation' - if 'format' is not one of
3007     'bfd_object', 'bfd_archive' or 'bfd_core'.
3008
3009   * 'bfd_error_system_call' - if an error occured during a read - even
3010     some file mismatches can cause bfd_error_system_calls.
3011
3012   * 'file_not_recognised' - none of the backends recognised the file
3013     format.
3014
3015   * 'bfd_error_file_ambiguously_recognized' - more than one backend
3016     recognised the file format.
3017
30182.9.1.2 'bfd_check_format_matches'
3019..................................
3020
3021*Synopsis*
3022     bfd_boolean bfd_check_format_matches
3023        (bfd *abfd, bfd_format format, char ***matching);
3024   *Description*
3025Like 'bfd_check_format', except when it returns FALSE with 'bfd_errno'
3026set to 'bfd_error_file_ambiguously_recognized'.  In that case, if
3027MATCHING is not NULL, it will be filled in with a NULL-terminated list
3028of the names of the formats that matched, allocated with 'malloc'.  Then
3029the user may choose a format and try again.
3030
3031   When done with the list that MATCHING points to, the caller should
3032free it.
3033
30342.9.1.3 'bfd_set_format'
3035........................
3036
3037*Synopsis*
3038     bfd_boolean bfd_set_format (bfd *abfd, bfd_format format);
3039   *Description*
3040This function sets the file format of the BFD ABFD to the format FORMAT.
3041If the target set in the BFD does not support the format requested, the
3042format is invalid, or the BFD is not open for writing, then an error
3043occurs.
3044
30452.9.1.4 'bfd_format_string'
3046...........................
3047
3048*Synopsis*
3049     const char *bfd_format_string (bfd_format format);
3050   *Description*
3051Return a pointer to a const string 'invalid', 'object', 'archive',
3052'core', or 'unknown', depending upon the value of FORMAT.
3053
3054
3055File: bfd.info,  Node: Relocations,  Next: Core Files,  Prev: Formats,  Up: BFD front end
3056
30572.10 Relocations
3058================
3059
3060BFD maintains relocations in much the same way it maintains symbols:
3061they are left alone until required, then read in en-masse and translated
3062into an internal form.  A common routine 'bfd_perform_relocation' acts
3063upon the canonical form to do the fixup.
3064
3065   Relocations are maintained on a per section basis, while symbols are
3066maintained on a per BFD basis.
3067
3068   All that a back end has to do to fit the BFD interface is to create a
3069'struct reloc_cache_entry' for each relocation in a particular section,
3070and fill in the right bits of the structures.
3071
3072* Menu:
3073
3074* typedef arelent::
3075* howto manager::
3076
3077
3078File: bfd.info,  Node: typedef arelent,  Next: howto manager,  Prev: Relocations,  Up: Relocations
3079
30802.10.1 typedef arelent
3081----------------------
3082
3083This is the structure of a relocation entry:
3084
3085
3086     typedef enum bfd_reloc_status
3087     {
3088       /* No errors detected.  Note - the value 2 is used so that it
3089          will not be mistaken for the boolean TRUE or FALSE values.  */
3090       bfd_reloc_ok = 2,
3091
3092       /* The relocation was performed, but there was an overflow.  */
3093       bfd_reloc_overflow,
3094
3095       /* The address to relocate was not within the section supplied.  */
3096       bfd_reloc_outofrange,
3097
3098       /* Used by special functions.  */
3099       bfd_reloc_continue,
3100
3101       /* Unsupported relocation size requested.  */
3102       bfd_reloc_notsupported,
3103
3104       /* Unused.  */
3105       bfd_reloc_other,
3106
3107       /* The symbol to relocate against was undefined.  */
3108       bfd_reloc_undefined,
3109
3110       /* The relocation was performed, but may not be ok.  If this type is
3111          returned, the error_message argument to bfd_perform_relocation
3112          will be set.  */
3113       bfd_reloc_dangerous
3114      }
3115      bfd_reloc_status_type;
3116
3117
3118     typedef struct reloc_cache_entry
3119     {
3120       /* A pointer into the canonical table of pointers.  */
3121       struct bfd_symbol **sym_ptr_ptr;
3122
3123       /* offset in section.  */
3124       bfd_size_type address;
3125
3126       /* addend for relocation value.  */
3127       bfd_vma addend;
3128
3129       /* Pointer to how to perform the required relocation.  */
3130       reloc_howto_type *howto;
3131
3132     }
3133     arelent;
3134
3135   *Description*
3136Here is a description of each of the fields within an 'arelent':
3137
3138   * 'sym_ptr_ptr'
3139   The symbol table pointer points to a pointer to the symbol associated
3140with the relocation request.  It is the pointer into the table returned
3141by the back end's 'canonicalize_symtab' action.  *Note Symbols::.  The
3142symbol is referenced through a pointer to a pointer so that tools like
3143the linker can fix up all the symbols of the same name by modifying only
3144one pointer.  The relocation routine looks in the symbol and uses the
3145base of the section the symbol is attached to and the value of the
3146symbol as the initial relocation offset.  If the symbol pointer is zero,
3147then the section provided is looked up.
3148
3149   * 'address'
3150   The 'address' field gives the offset in bytes from the base of the
3151section data which owns the relocation record to the first byte of
3152relocatable information.  The actual data relocated will be relative to
3153this point; for example, a relocation type which modifies the bottom two
3154bytes of a four byte word would not touch the first byte pointed to in a
3155big endian world.
3156
3157   * 'addend'
3158   The 'addend' is a value provided by the back end to be added (!)  to
3159the relocation offset.  Its interpretation is dependent upon the howto.
3160For example, on the 68k the code:
3161
3162             char foo[];
3163             main()
3164                     {
3165                     return foo[0x12345678];
3166                     }
3167
3168   Could be compiled into:
3169
3170             linkw fp,#-4
3171             moveb @#12345678,d0
3172             extbl d0
3173             unlk fp
3174             rts
3175
3176   This could create a reloc pointing to 'foo', but leave the offset in
3177the data, something like:
3178
3179     RELOCATION RECORDS FOR [.text]:
3180     offset   type      value
3181     00000006 32        _foo
3182
3183     00000000 4e56 fffc          ; linkw fp,#-4
3184     00000004 1039 1234 5678     ; moveb @#12345678,d0
3185     0000000a 49c0               ; extbl d0
3186     0000000c 4e5e               ; unlk fp
3187     0000000e 4e75               ; rts
3188
3189   Using coff and an 88k, some instructions don't have enough space in
3190them to represent the full address range, and pointers have to be loaded
3191in two parts.  So you'd get something like:
3192
3193             or.u     r13,r0,hi16(_foo+0x12345678)
3194             ld.b     r2,r13,lo16(_foo+0x12345678)
3195             jmp      r1
3196
3197   This should create two relocs, both pointing to '_foo', and with
31980x12340000 in their addend field.  The data would consist of:
3199
3200     RELOCATION RECORDS FOR [.text]:
3201     offset   type      value
3202     00000002 HVRT16    _foo+0x12340000
3203     00000006 LVRT16    _foo+0x12340000
3204
3205     00000000 5da05678           ; or.u r13,r0,0x5678
3206     00000004 1c4d5678           ; ld.b r2,r13,0x5678
3207     00000008 f400c001           ; jmp r1
3208
3209   The relocation routine digs out the value from the data, adds it to
3210the addend to get the original offset, and then adds the value of
3211'_foo'.  Note that all 32 bits have to be kept around somewhere, to cope
3212with carry from bit 15 to bit 16.
3213
3214   One further example is the sparc and the a.out format.  The sparc has
3215a similar problem to the 88k, in that some instructions don't have room
3216for an entire offset, but on the sparc the parts are created in odd
3217sized lumps.  The designers of the a.out format chose to not use the
3218data within the section for storing part of the offset; all the offset
3219is kept within the reloc.  Anything in the data should be ignored.
3220
3221             save %sp,-112,%sp
3222             sethi %hi(_foo+0x12345678),%g2
3223             ldsb [%g2+%lo(_foo+0x12345678)],%i0
3224             ret
3225             restore
3226
3227   Both relocs contain a pointer to 'foo', and the offsets contain junk.
3228
3229     RELOCATION RECORDS FOR [.text]:
3230     offset   type      value
3231     00000004 HI22      _foo+0x12345678
3232     00000008 LO10      _foo+0x12345678
3233
3234     00000000 9de3bf90     ; save %sp,-112,%sp
3235     00000004 05000000     ; sethi %hi(_foo+0),%g2
3236     00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
3237     0000000c 81c7e008     ; ret
3238     00000010 81e80000     ; restore
3239
3240   * 'howto'
3241   The 'howto' field can be imagined as a relocation instruction.  It is
3242a pointer to a structure which contains information on what to do with
3243all of the other information in the reloc record and data section.  A
3244back end would normally have a relocation instruction set and turn
3245relocations into pointers to the correct structure on input - but it
3246would be possible to create each howto field on demand.
3247
32482.10.1.1 'enum complain_overflow'
3249.................................
3250
3251Indicates what sort of overflow checking should be done when performing
3252a relocation.
3253
3254
3255     enum complain_overflow
3256     {
3257       /* Do not complain on overflow.  */
3258       complain_overflow_dont,
3259
3260       /* Complain if the value overflows when considered as a signed
3261          number one bit larger than the field.  ie. A bitfield of N bits
3262          is allowed to represent -2**n to 2**n-1.  */
3263       complain_overflow_bitfield,
3264
3265       /* Complain if the value overflows when considered as a signed
3266          number.  */
3267       complain_overflow_signed,
3268
3269       /* Complain if the value overflows when considered as an
3270          unsigned number.  */
3271       complain_overflow_unsigned
3272     };
3273
32742.10.1.2 'reloc_howto_type'
3275...........................
3276
3277The 'reloc_howto_type' is a structure which contains all the information
3278that libbfd needs to know to tie up a back end's data.
3279
3280     struct bfd_symbol;             /* Forward declaration.  */
3281
3282     struct reloc_howto_struct
3283     {
3284       /*  The type field has mainly a documentary use - the back end can
3285           do what it wants with it, though normally the back end's
3286           external idea of what a reloc number is stored
3287           in this field.  For example, a PC relative word relocation
3288           in a coff environment has the type 023 - because that's
3289           what the outside world calls a R_PCRWORD reloc.  */
3290       unsigned int type;
3291
3292       /*  The value the final relocation is shifted right by.  This drops
3293           unwanted data from the relocation.  */
3294       unsigned int rightshift;
3295
3296       /*  The size of the item to be relocated.  This is *not* a
3297           power-of-two measure.  To get the number of bytes operated
3298           on by a type of relocation, use bfd_get_reloc_size.  */
3299       int size;
3300
3301       /*  The number of bits in the item to be relocated.  This is used
3302           when doing overflow checking.  */
3303       unsigned int bitsize;
3304
3305       /*  The relocation is relative to the field being relocated.  */
3306       bfd_boolean pc_relative;
3307
3308       /*  The bit position of the reloc value in the destination.
3309           The relocated value is left shifted by this amount.  */
3310       unsigned int bitpos;
3311
3312       /* What type of overflow error should be checked for when
3313          relocating.  */
3314       enum complain_overflow complain_on_overflow;
3315
3316       /* If this field is non null, then the supplied function is
3317          called rather than the normal function.  This allows really
3318          strange relocation methods to be accommodated.  */
3319       bfd_reloc_status_type (*special_function)
3320         (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
3321          bfd *, char **);
3322
3323       /* The textual name of the relocation type.  */
3324       char *name;
3325
3326       /* Some formats record a relocation addend in the section contents
3327          rather than with the relocation.  For ELF formats this is the
3328          distinction between USE_REL and USE_RELA (though the code checks
3329          for USE_REL == 1/0).  The value of this field is TRUE if the
3330          addend is recorded with the section contents; when performing a
3331          partial link (ld -r) the section contents (the data) will be
3332          modified.  The value of this field is FALSE if addends are
3333          recorded with the relocation (in arelent.addend); when performing
3334          a partial link the relocation will be modified.
3335          All relocations for all ELF USE_RELA targets should set this field
3336          to FALSE (values of TRUE should be looked on with suspicion).
3337          However, the converse is not true: not all relocations of all ELF
3338          USE_REL targets set this field to TRUE.  Why this is so is peculiar
3339          to each particular target.  For relocs that aren't used in partial
3340          links (e.g. GOT stuff) it doesn't matter what this is set to.  */
3341       bfd_boolean partial_inplace;
3342
3343       /* src_mask selects the part of the instruction (or data) to be used
3344          in the relocation sum.  If the target relocations don't have an
3345          addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
3346          dst_mask to extract the addend from the section contents.  If
3347          relocations do have an addend in the reloc, eg. ELF USE_RELA, this
3348          field should be zero.  Non-zero values for ELF USE_RELA targets are
3349          bogus as in those cases the value in the dst_mask part of the
3350          section contents should be treated as garbage.  */
3351       bfd_vma src_mask;
3352
3353       /* dst_mask selects which parts of the instruction (or data) are
3354          replaced with a relocated value.  */
3355       bfd_vma dst_mask;
3356
3357       /* When some formats create PC relative instructions, they leave
3358          the value of the pc of the place being relocated in the offset
3359          slot of the instruction, so that a PC relative relocation can
3360          be made just by adding in an ordinary offset (e.g., sun3 a.out).
3361          Some formats leave the displacement part of an instruction
3362          empty (e.g., ELF); this flag signals the fact.  */
3363       bfd_boolean pcrel_offset;
3364     };
3365
3366
33672.10.1.3 'The HOWTO Macro'
3368..........................
3369
3370*Description*
3371The HOWTO define is horrible and will go away.
3372     #define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
3373       { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
3374
3375   *Description*
3376And will be replaced with the totally magic way.  But for the moment, we
3377are compatible, so do it this way.
3378     #define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
3379       HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
3380              NAME, FALSE, 0, 0, IN)
3381
3382
3383   *Description*
3384This is used to fill in an empty howto entry in an array.
3385     #define EMPTY_HOWTO(C) \
3386       HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
3387              NULL, FALSE, 0, 0, FALSE)
3388
3389
3390   *Description*
3391Helper routine to turn a symbol into a relocation value.
3392     #define HOWTO_PREPARE(relocation, symbol)              \
3393       {                                                    \
3394         if (symbol != NULL)                                \
3395           {                                                \
3396             if (bfd_is_com_section (symbol->section))      \
3397               {                                            \
3398                 relocation = 0;                            \
3399               }                                            \
3400             else                                           \
3401               {                                            \
3402                 relocation = symbol->value;                \
3403               }                                            \
3404           }                                                \
3405       }
3406
3407
34082.10.1.4 'bfd_get_reloc_size'
3409.............................
3410
3411*Synopsis*
3412     unsigned int bfd_get_reloc_size (reloc_howto_type *);
3413   *Description*
3414For a reloc_howto_type that operates on a fixed number of bytes, this
3415returns the number of bytes operated on.
3416
34172.10.1.5 'arelent_chain'
3418........................
3419
3420*Description*
3421How relocs are tied together in an 'asection':
3422     typedef struct relent_chain
3423     {
3424       arelent relent;
3425       struct relent_chain *next;
3426     }
3427     arelent_chain;
3428
3429
34302.10.1.6 'bfd_check_overflow'
3431.............................
3432
3433*Synopsis*
3434     bfd_reloc_status_type bfd_check_overflow
3435        (enum complain_overflow how,
3436         unsigned int bitsize,
3437         unsigned int rightshift,
3438         unsigned int addrsize,
3439         bfd_vma relocation);
3440   *Description*
3441Perform overflow checking on RELOCATION which has BITSIZE significant
3442bits and will be shifted right by RIGHTSHIFT bits, on a machine with
3443addresses containing ADDRSIZE significant bits.  The result is either of
3444'bfd_reloc_ok' or 'bfd_reloc_overflow'.
3445
34462.10.1.7 'bfd_reloc_offset_in_range'
3447....................................
3448
3449*Synopsis*
3450     bfd_boolean bfd_reloc_offset_in_range
3451        (reloc_howto_type *howto,
3452         bfd *abfd,
3453         asection *section,
3454         bfd_size_type offset);
3455   *Description*
3456Returns TRUE if the reloc described by HOWTO can be applied at OFFSET
3457octets in SECTION.
3458
34592.10.1.8 'bfd_perform_relocation'
3460.................................
3461
3462*Synopsis*
3463     bfd_reloc_status_type bfd_perform_relocation
3464        (bfd *abfd,
3465         arelent *reloc_entry,
3466         void *data,
3467         asection *input_section,
3468         bfd *output_bfd,
3469         char **error_message);
3470   *Description*
3471If OUTPUT_BFD is supplied to this function, the generated image will be
3472relocatable; the relocations are copied to the output file after they
3473have been changed to reflect the new state of the world.  There are two
3474ways of reflecting the results of partial linkage in an output file: by
3475modifying the output data in place, and by modifying the relocation
3476record.  Some native formats (e.g., basic a.out and basic coff) have no
3477way of specifying an addend in the relocation type, so the addend has to
3478go in the output data.  This is no big deal since in these formats the
3479output data slot will always be big enough for the addend.  Complex
3480reloc types with addends were invented to solve just this problem.  The
3481ERROR_MESSAGE argument is set to an error message if this return
3482'bfd_reloc_dangerous'.
3483
34842.10.1.9 'bfd_install_relocation'
3485.................................
3486
3487*Synopsis*
3488     bfd_reloc_status_type bfd_install_relocation
3489        (bfd *abfd,
3490         arelent *reloc_entry,
3491         void *data, bfd_vma data_start,
3492         asection *input_section,
3493         char **error_message);
3494   *Description*
3495This looks remarkably like 'bfd_perform_relocation', except it does not
3496expect that the section contents have been filled in.  I.e., it's
3497suitable for use when creating, rather than applying a relocation.
3498
3499   For now, this function should be considered reserved for the
3500assembler.
3501
3502
3503File: bfd.info,  Node: howto manager,  Prev: typedef arelent,  Up: Relocations
3504
35052.10.2 The howto manager
3506------------------------
3507
3508When an application wants to create a relocation, but doesn't know what
3509the target machine might call it, it can find out by using this bit of
3510code.
3511
35122.10.2.1 'bfd_reloc_code_type'
3513..............................
3514
3515*Description*
3516The insides of a reloc code.  The idea is that, eventually, there will
3517be one enumerator for every type of relocation we ever do.  Pass one of
3518these values to 'bfd_reloc_type_lookup', and it'll return a howto
3519pointer.
3520
3521   This does mean that the application must determine the correct
3522enumerator value; you can't get a howto pointer from a random set of
3523attributes.
3524
3525   Here are the possible values for 'enum bfd_reloc_code_real':
3526
3527 -- : BFD_RELOC_64
3528 -- : BFD_RELOC_32
3529 -- : BFD_RELOC_26
3530 -- : BFD_RELOC_24
3531 -- : BFD_RELOC_16
3532 -- : BFD_RELOC_14
3533 -- : BFD_RELOC_8
3534     Basic absolute relocations of N bits.
3535 -- : BFD_RELOC_64_PCREL
3536 -- : BFD_RELOC_32_PCREL
3537 -- : BFD_RELOC_24_PCREL
3538 -- : BFD_RELOC_16_PCREL
3539 -- : BFD_RELOC_12_PCREL
3540 -- : BFD_RELOC_8_PCREL
3541     PC-relative relocations.  Sometimes these are relative to the
3542     address of the relocation itself; sometimes they are relative to
3543     the start of the section containing the relocation.  It depends on
3544     the specific target.
3545 -- : BFD_RELOC_32_SECREL
3546     Section relative relocations.  Some targets need this for DWARF2.
3547 -- : BFD_RELOC_32_GOT_PCREL
3548 -- : BFD_RELOC_16_GOT_PCREL
3549 -- : BFD_RELOC_8_GOT_PCREL
3550 -- : BFD_RELOC_32_GOTOFF
3551 -- : BFD_RELOC_16_GOTOFF
3552 -- : BFD_RELOC_LO16_GOTOFF
3553 -- : BFD_RELOC_HI16_GOTOFF
3554 -- : BFD_RELOC_HI16_S_GOTOFF
3555 -- : BFD_RELOC_8_GOTOFF
3556 -- : BFD_RELOC_64_PLT_PCREL
3557 -- : BFD_RELOC_32_PLT_PCREL
3558 -- : BFD_RELOC_24_PLT_PCREL
3559 -- : BFD_RELOC_16_PLT_PCREL
3560 -- : BFD_RELOC_8_PLT_PCREL
3561 -- : BFD_RELOC_64_PLTOFF
3562 -- : BFD_RELOC_32_PLTOFF
3563 -- : BFD_RELOC_16_PLTOFF
3564 -- : BFD_RELOC_LO16_PLTOFF
3565 -- : BFD_RELOC_HI16_PLTOFF
3566 -- : BFD_RELOC_HI16_S_PLTOFF
3567 -- : BFD_RELOC_8_PLTOFF
3568     For ELF.
3569 -- : BFD_RELOC_SIZE32
3570 -- : BFD_RELOC_SIZE64
3571     Size relocations.
3572 -- : BFD_RELOC_68K_GLOB_DAT
3573 -- : BFD_RELOC_68K_JMP_SLOT
3574 -- : BFD_RELOC_68K_RELATIVE
3575 -- : BFD_RELOC_68K_TLS_GD32
3576 -- : BFD_RELOC_68K_TLS_GD16
3577 -- : BFD_RELOC_68K_TLS_GD8
3578 -- : BFD_RELOC_68K_TLS_LDM32
3579 -- : BFD_RELOC_68K_TLS_LDM16
3580 -- : BFD_RELOC_68K_TLS_LDM8
3581 -- : BFD_RELOC_68K_TLS_LDO32
3582 -- : BFD_RELOC_68K_TLS_LDO16
3583 -- : BFD_RELOC_68K_TLS_LDO8
3584 -- : BFD_RELOC_68K_TLS_IE32
3585 -- : BFD_RELOC_68K_TLS_IE16
3586 -- : BFD_RELOC_68K_TLS_IE8
3587 -- : BFD_RELOC_68K_TLS_LE32
3588 -- : BFD_RELOC_68K_TLS_LE16
3589 -- : BFD_RELOC_68K_TLS_LE8
3590     Relocations used by 68K ELF.
3591 -- : BFD_RELOC_32_BASEREL
3592 -- : BFD_RELOC_16_BASEREL
3593 -- : BFD_RELOC_LO16_BASEREL
3594 -- : BFD_RELOC_HI16_BASEREL
3595 -- : BFD_RELOC_HI16_S_BASEREL
3596 -- : BFD_RELOC_8_BASEREL
3597 -- : BFD_RELOC_RVA
3598     Linkage-table relative.
3599 -- : BFD_RELOC_8_FFnn
3600     Absolute 8-bit relocation, but used to form an address like 0xFFnn.
3601 -- : BFD_RELOC_32_PCREL_S2
3602 -- : BFD_RELOC_16_PCREL_S2
3603 -- : BFD_RELOC_23_PCREL_S2
3604     These PC-relative relocations are stored as word displacements -
3605     i.e., byte displacements shifted right two bits.  The 30-bit word
3606     displacement (<<32_PCREL_S2>> - 32 bits, shifted 2) is used on the
3607     SPARC. (SPARC tools generally refer to this as <<WDISP30>>.)  The
3608     signed 16-bit displacement is used on the MIPS, and the 23-bit
3609     displacement is used on the Alpha.
3610 -- : BFD_RELOC_HI22
3611 -- : BFD_RELOC_LO10
3612     High 22 bits and low 10 bits of 32-bit value, placed into lower
3613     bits of the target word.  These are used on the SPARC.
3614 -- : BFD_RELOC_GPREL16
3615 -- : BFD_RELOC_GPREL32
3616     For systems that allocate a Global Pointer register, these are
3617     displacements off that register.  These relocation types are
3618     handled specially, because the value the register will have is
3619     decided relatively late.
3620 -- : BFD_RELOC_NONE
3621 -- : BFD_RELOC_SPARC_WDISP22
3622 -- : BFD_RELOC_SPARC22
3623 -- : BFD_RELOC_SPARC13
3624 -- : BFD_RELOC_SPARC_GOT10
3625 -- : BFD_RELOC_SPARC_GOT13
3626 -- : BFD_RELOC_SPARC_GOT22
3627 -- : BFD_RELOC_SPARC_PC10
3628 -- : BFD_RELOC_SPARC_PC22
3629 -- : BFD_RELOC_SPARC_WPLT30
3630 -- : BFD_RELOC_SPARC_COPY
3631 -- : BFD_RELOC_SPARC_GLOB_DAT
3632 -- : BFD_RELOC_SPARC_JMP_SLOT
3633 -- : BFD_RELOC_SPARC_RELATIVE
3634 -- : BFD_RELOC_SPARC_UA16
3635 -- : BFD_RELOC_SPARC_UA32
3636 -- : BFD_RELOC_SPARC_UA64
3637 -- : BFD_RELOC_SPARC_GOTDATA_HIX22
3638 -- : BFD_RELOC_SPARC_GOTDATA_LOX10
3639 -- : BFD_RELOC_SPARC_GOTDATA_OP_HIX22
3640 -- : BFD_RELOC_SPARC_GOTDATA_OP_LOX10
3641 -- : BFD_RELOC_SPARC_GOTDATA_OP
3642 -- : BFD_RELOC_SPARC_JMP_IREL
3643 -- : BFD_RELOC_SPARC_IRELATIVE
3644     SPARC ELF relocations.  There is probably some overlap with other
3645     relocation types already defined.
3646 -- : BFD_RELOC_SPARC_BASE13
3647 -- : BFD_RELOC_SPARC_BASE22
3648     I think these are specific to SPARC a.out (e.g., Sun 4).
3649 -- : BFD_RELOC_SPARC_64
3650 -- : BFD_RELOC_SPARC_10
3651 -- : BFD_RELOC_SPARC_11
3652 -- : BFD_RELOC_SPARC_OLO10
3653 -- : BFD_RELOC_SPARC_HH22
3654 -- : BFD_RELOC_SPARC_HM10
3655 -- : BFD_RELOC_SPARC_LM22
3656 -- : BFD_RELOC_SPARC_PC_HH22
3657 -- : BFD_RELOC_SPARC_PC_HM10
3658 -- : BFD_RELOC_SPARC_PC_LM22
3659 -- : BFD_RELOC_SPARC_WDISP16
3660 -- : BFD_RELOC_SPARC_WDISP19
3661 -- : BFD_RELOC_SPARC_7
3662 -- : BFD_RELOC_SPARC_6
3663 -- : BFD_RELOC_SPARC_5
3664 -- : BFD_RELOC_SPARC_DISP64
3665 -- : BFD_RELOC_SPARC_PLT32
3666 -- : BFD_RELOC_SPARC_PLT64
3667 -- : BFD_RELOC_SPARC_HIX22
3668 -- : BFD_RELOC_SPARC_LOX10
3669 -- : BFD_RELOC_SPARC_H44
3670 -- : BFD_RELOC_SPARC_M44
3671 -- : BFD_RELOC_SPARC_L44
3672 -- : BFD_RELOC_SPARC_REGISTER
3673 -- : BFD_RELOC_SPARC_H34
3674 -- : BFD_RELOC_SPARC_SIZE32
3675 -- : BFD_RELOC_SPARC_SIZE64
3676 -- : BFD_RELOC_SPARC_WDISP10
3677     SPARC64 relocations
3678 -- : BFD_RELOC_SPARC_REV32
3679     SPARC little endian relocation
3680 -- : BFD_RELOC_SPARC_TLS_GD_HI22
3681 -- : BFD_RELOC_SPARC_TLS_GD_LO10
3682 -- : BFD_RELOC_SPARC_TLS_GD_ADD
3683 -- : BFD_RELOC_SPARC_TLS_GD_CALL
3684 -- : BFD_RELOC_SPARC_TLS_LDM_HI22
3685 -- : BFD_RELOC_SPARC_TLS_LDM_LO10
3686 -- : BFD_RELOC_SPARC_TLS_LDM_ADD
3687 -- : BFD_RELOC_SPARC_TLS_LDM_CALL
3688 -- : BFD_RELOC_SPARC_TLS_LDO_HIX22
3689 -- : BFD_RELOC_SPARC_TLS_LDO_LOX10
3690 -- : BFD_RELOC_SPARC_TLS_LDO_ADD
3691 -- : BFD_RELOC_SPARC_TLS_IE_HI22
3692 -- : BFD_RELOC_SPARC_TLS_IE_LO10
3693 -- : BFD_RELOC_SPARC_TLS_IE_LD
3694 -- : BFD_RELOC_SPARC_TLS_IE_LDX
3695 -- : BFD_RELOC_SPARC_TLS_IE_ADD
3696 -- : BFD_RELOC_SPARC_TLS_LE_HIX22
3697 -- : BFD_RELOC_SPARC_TLS_LE_LOX10
3698 -- : BFD_RELOC_SPARC_TLS_DTPMOD32
3699 -- : BFD_RELOC_SPARC_TLS_DTPMOD64
3700 -- : BFD_RELOC_SPARC_TLS_DTPOFF32
3701 -- : BFD_RELOC_SPARC_TLS_DTPOFF64
3702 -- : BFD_RELOC_SPARC_TLS_TPOFF32
3703 -- : BFD_RELOC_SPARC_TLS_TPOFF64
3704     SPARC TLS relocations
3705 -- : BFD_RELOC_SPU_IMM7
3706 -- : BFD_RELOC_SPU_IMM8
3707 -- : BFD_RELOC_SPU_IMM10
3708 -- : BFD_RELOC_SPU_IMM10W
3709 -- : BFD_RELOC_SPU_IMM16
3710 -- : BFD_RELOC_SPU_IMM16W
3711 -- : BFD_RELOC_SPU_IMM18
3712 -- : BFD_RELOC_SPU_PCREL9a
3713 -- : BFD_RELOC_SPU_PCREL9b
3714 -- : BFD_RELOC_SPU_PCREL16
3715 -- : BFD_RELOC_SPU_LO16
3716 -- : BFD_RELOC_SPU_HI16
3717 -- : BFD_RELOC_SPU_PPU32
3718 -- : BFD_RELOC_SPU_PPU64
3719 -- : BFD_RELOC_SPU_ADD_PIC
3720     SPU Relocations.
3721 -- : BFD_RELOC_ALPHA_GPDISP_HI16
3722     Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
3723     "addend" in some special way.  For GPDISP_HI16 ("gpdisp")
3724     relocations, the symbol is ignored when writing; when reading, it
3725     will be the absolute section symbol.  The addend is the
3726     displacement in bytes of the "lda" instruction from the "ldah"
3727     instruction (which is at the address of this reloc).
3728 -- : BFD_RELOC_ALPHA_GPDISP_LO16
3729     For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
3730     with GPDISP_HI16 relocs.  The addend is ignored when writing the
3731     relocations out, and is filled in with the file's GP value on
3732     reading, for convenience.
3733 -- : BFD_RELOC_ALPHA_GPDISP
3734     The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
3735     relocation except that there is no accompanying GPDISP_LO16
3736     relocation.
3737 -- : BFD_RELOC_ALPHA_LITERAL
3738 -- : BFD_RELOC_ALPHA_ELF_LITERAL
3739 -- : BFD_RELOC_ALPHA_LITUSE
3740     The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
3741     the assembler turns it into a LDQ instruction to load the address
3742     of the symbol, and then fills in a register in the real
3743     instruction.
3744
3745     The LITERAL reloc, at the LDQ instruction, refers to the .lita
3746     section symbol.  The addend is ignored when writing, but is filled
3747     in with the file's GP value on reading, for convenience, as with
3748     the GPDISP_LO16 reloc.
3749
3750     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and
3751     GPDISP_LO16.  It should refer to the symbol to be referenced, as
3752     with 16_GOTOFF, but it generates output not based on the position
3753     within the .got section, but relative to the GP value chosen for
3754     the file during the final link stage.
3755
3756     The LITUSE reloc, on the instruction using the loaded address,
3757     gives information to the linker that it might be able to use to
3758     optimize away some literal section references.  The symbol is
3759     ignored (read as the absolute section symbol), and the "addend"
3760     indicates the type of instruction using the register: 1 - "memory"
3761     fmt insn 2 - byte-manipulation (byte offset reg) 3 - jsr (target of
3762     branch)
3763 -- : BFD_RELOC_ALPHA_HINT
3764     The HINT relocation indicates a value that should be filled into
3765     the "hint" field of a jmp/jsr/ret instruction, for possible branch-
3766     prediction logic which may be provided on some processors.
3767 -- : BFD_RELOC_ALPHA_LINKAGE
3768     The LINKAGE relocation outputs a linkage pair in the object file,
3769     which is filled by the linker.
3770 -- : BFD_RELOC_ALPHA_CODEADDR
3771     The CODEADDR relocation outputs a STO_CA in the object file, which
3772     is filled by the linker.
3773 -- : BFD_RELOC_ALPHA_GPREL_HI16
3774 -- : BFD_RELOC_ALPHA_GPREL_LO16
3775     The GPREL_HI/LO relocations together form a 32-bit offset from the
3776     GP register.
3777 -- : BFD_RELOC_ALPHA_BRSGP
3778     Like BFD_RELOC_23_PCREL_S2, except that the source and target must
3779     share a common GP, and the target address is adjusted for
3780     STO_ALPHA_STD_GPLOAD.
3781 -- : BFD_RELOC_ALPHA_NOP
3782     The NOP relocation outputs a NOP if the longword displacement
3783     between two procedure entry points is < 2^21.
3784 -- : BFD_RELOC_ALPHA_BSR
3785     The BSR relocation outputs a BSR if the longword displacement
3786     between two procedure entry points is < 2^21.
3787 -- : BFD_RELOC_ALPHA_LDA
3788     The LDA relocation outputs a LDA if the longword displacement
3789     between two procedure entry points is < 2^16.
3790 -- : BFD_RELOC_ALPHA_BOH
3791     The BOH relocation outputs a BSR if the longword displacement
3792     between two procedure entry points is < 2^21, or else a hint.
3793 -- : BFD_RELOC_ALPHA_TLSGD
3794 -- : BFD_RELOC_ALPHA_TLSLDM
3795 -- : BFD_RELOC_ALPHA_DTPMOD64
3796 -- : BFD_RELOC_ALPHA_GOTDTPREL16
3797 -- : BFD_RELOC_ALPHA_DTPREL64
3798 -- : BFD_RELOC_ALPHA_DTPREL_HI16
3799 -- : BFD_RELOC_ALPHA_DTPREL_LO16
3800 -- : BFD_RELOC_ALPHA_DTPREL16
3801 -- : BFD_RELOC_ALPHA_GOTTPREL16
3802 -- : BFD_RELOC_ALPHA_TPREL64
3803 -- : BFD_RELOC_ALPHA_TPREL_HI16
3804 -- : BFD_RELOC_ALPHA_TPREL_LO16
3805 -- : BFD_RELOC_ALPHA_TPREL16
3806     Alpha thread-local storage relocations.
3807 -- : BFD_RELOC_MIPS_JMP
3808 -- : BFD_RELOC_MICROMIPS_JMP
3809     The MIPS jump instruction.
3810 -- : BFD_RELOC_MIPS16_JMP
3811     The MIPS16 jump instruction.
3812 -- : BFD_RELOC_MIPS16_GPREL
3813     MIPS16 GP relative reloc.
3814 -- : BFD_RELOC_HI16
3815     High 16 bits of 32-bit value; simple reloc.
3816 -- : BFD_RELOC_HI16_S
3817     High 16 bits of 32-bit value but the low 16 bits will be sign
3818     extended and added to form the final result.  If the low 16 bits
3819     form a negative number, we need to add one to the high value to
3820     compensate for the borrow when the low bits are added.
3821 -- : BFD_RELOC_LO16
3822     Low 16 bits.
3823 -- : BFD_RELOC_HI16_PCREL
3824     High 16 bits of 32-bit pc-relative value
3825 -- : BFD_RELOC_HI16_S_PCREL
3826     High 16 bits of 32-bit pc-relative value, adjusted
3827 -- : BFD_RELOC_LO16_PCREL
3828     Low 16 bits of pc-relative value
3829 -- : BFD_RELOC_MIPS16_GOT16
3830 -- : BFD_RELOC_MIPS16_CALL16
3831     Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
3832     16-bit immediate fields
3833 -- : BFD_RELOC_MIPS16_HI16
3834     MIPS16 high 16 bits of 32-bit value.
3835 -- : BFD_RELOC_MIPS16_HI16_S
3836     MIPS16 high 16 bits of 32-bit value but the low 16 bits will be
3837     sign extended and added to form the final result.  If the low 16
3838     bits form a negative number, we need to add one to the high value
3839     to compensate for the borrow when the low bits are added.
3840 -- : BFD_RELOC_MIPS16_LO16
3841     MIPS16 low 16 bits.
3842 -- : BFD_RELOC_MIPS16_TLS_GD
3843 -- : BFD_RELOC_MIPS16_TLS_LDM
3844 -- : BFD_RELOC_MIPS16_TLS_DTPREL_HI16
3845 -- : BFD_RELOC_MIPS16_TLS_DTPREL_LO16
3846 -- : BFD_RELOC_MIPS16_TLS_GOTTPREL
3847 -- : BFD_RELOC_MIPS16_TLS_TPREL_HI16
3848 -- : BFD_RELOC_MIPS16_TLS_TPREL_LO16
3849     MIPS16 TLS relocations
3850 -- : BFD_RELOC_MIPS_LITERAL
3851 -- : BFD_RELOC_MICROMIPS_LITERAL
3852     Relocation against a MIPS literal section.
3853 -- : BFD_RELOC_MICROMIPS_7_PCREL_S1
3854 -- : BFD_RELOC_MICROMIPS_10_PCREL_S1
3855 -- : BFD_RELOC_MICROMIPS_16_PCREL_S1
3856     microMIPS PC-relative relocations.
3857 -- : BFD_RELOC_MIPS16_16_PCREL_S1
3858     MIPS16 PC-relative relocation.
3859 -- : BFD_RELOC_MIPS_21_PCREL_S2
3860 -- : BFD_RELOC_MIPS_26_PCREL_S2
3861 -- : BFD_RELOC_MIPS_18_PCREL_S3
3862 -- : BFD_RELOC_MIPS_19_PCREL_S2
3863     MIPS PC-relative relocations.
3864 -- : BFD_RELOC_MICROMIPS_GPREL16
3865 -- : BFD_RELOC_MICROMIPS_HI16
3866 -- : BFD_RELOC_MICROMIPS_HI16_S
3867 -- : BFD_RELOC_MICROMIPS_LO16
3868     microMIPS versions of generic BFD relocs.
3869 -- : BFD_RELOC_MIPS_GOT16
3870 -- : BFD_RELOC_MICROMIPS_GOT16
3871 -- : BFD_RELOC_MIPS_CALL16
3872 -- : BFD_RELOC_MICROMIPS_CALL16
3873 -- : BFD_RELOC_MIPS_GOT_HI16
3874 -- : BFD_RELOC_MICROMIPS_GOT_HI16
3875 -- : BFD_RELOC_MIPS_GOT_LO16
3876 -- : BFD_RELOC_MICROMIPS_GOT_LO16
3877 -- : BFD_RELOC_MIPS_CALL_HI16
3878 -- : BFD_RELOC_MICROMIPS_CALL_HI16
3879 -- : BFD_RELOC_MIPS_CALL_LO16
3880 -- : BFD_RELOC_MICROMIPS_CALL_LO16
3881 -- : BFD_RELOC_MIPS_SUB
3882 -- : BFD_RELOC_MICROMIPS_SUB
3883 -- : BFD_RELOC_MIPS_GOT_PAGE
3884 -- : BFD_RELOC_MICROMIPS_GOT_PAGE
3885 -- : BFD_RELOC_MIPS_GOT_OFST
3886 -- : BFD_RELOC_MICROMIPS_GOT_OFST
3887 -- : BFD_RELOC_MIPS_GOT_DISP
3888 -- : BFD_RELOC_MICROMIPS_GOT_DISP
3889 -- : BFD_RELOC_MIPS_SHIFT5
3890 -- : BFD_RELOC_MIPS_SHIFT6
3891 -- : BFD_RELOC_MIPS_INSERT_A
3892 -- : BFD_RELOC_MIPS_INSERT_B
3893 -- : BFD_RELOC_MIPS_DELETE
3894 -- : BFD_RELOC_MIPS_HIGHEST
3895 -- : BFD_RELOC_MICROMIPS_HIGHEST
3896 -- : BFD_RELOC_MIPS_HIGHER
3897 -- : BFD_RELOC_MICROMIPS_HIGHER
3898 -- : BFD_RELOC_MIPS_SCN_DISP
3899 -- : BFD_RELOC_MICROMIPS_SCN_DISP
3900 -- : BFD_RELOC_MIPS_REL16
3901 -- : BFD_RELOC_MIPS_RELGOT
3902 -- : BFD_RELOC_MIPS_JALR
3903 -- : BFD_RELOC_MICROMIPS_JALR
3904 -- : BFD_RELOC_MIPS_TLS_DTPMOD32
3905 -- : BFD_RELOC_MIPS_TLS_DTPREL32
3906 -- : BFD_RELOC_MIPS_TLS_DTPMOD64
3907 -- : BFD_RELOC_MIPS_TLS_DTPREL64
3908 -- : BFD_RELOC_MIPS_TLS_GD
3909 -- : BFD_RELOC_MICROMIPS_TLS_GD
3910 -- : BFD_RELOC_MIPS_TLS_LDM
3911 -- : BFD_RELOC_MICROMIPS_TLS_LDM
3912 -- : BFD_RELOC_MIPS_TLS_DTPREL_HI16
3913 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16
3914 -- : BFD_RELOC_MIPS_TLS_DTPREL_LO16
3915 -- : BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16
3916 -- : BFD_RELOC_MIPS_TLS_GOTTPREL
3917 -- : BFD_RELOC_MICROMIPS_TLS_GOTTPREL
3918 -- : BFD_RELOC_MIPS_TLS_TPREL32
3919 -- : BFD_RELOC_MIPS_TLS_TPREL64
3920 -- : BFD_RELOC_MIPS_TLS_TPREL_HI16
3921 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_HI16
3922 -- : BFD_RELOC_MIPS_TLS_TPREL_LO16
3923 -- : BFD_RELOC_MICROMIPS_TLS_TPREL_LO16
3924 -- : BFD_RELOC_MIPS_EH
3925     MIPS ELF relocations.
3926 -- : BFD_RELOC_MIPS_COPY
3927 -- : BFD_RELOC_MIPS_JUMP_SLOT
3928     MIPS ELF relocations (VxWorks and PLT extensions).
3929 -- : BFD_RELOC_MOXIE_10_PCREL
3930     Moxie ELF relocations.
3931 -- : BFD_RELOC_FT32_10
3932 -- : BFD_RELOC_FT32_20
3933 -- : BFD_RELOC_FT32_17
3934 -- : BFD_RELOC_FT32_18
3935 -- : BFD_RELOC_FT32_RELAX
3936 -- : BFD_RELOC_FT32_SC0
3937 -- : BFD_RELOC_FT32_SC1
3938 -- : BFD_RELOC_FT32_15
3939 -- : BFD_RELOC_FT32_DIFF32
3940     FT32 ELF relocations.
3941 -- : BFD_RELOC_FRV_LABEL16
3942 -- : BFD_RELOC_FRV_LABEL24
3943 -- : BFD_RELOC_FRV_LO16
3944 -- : BFD_RELOC_FRV_HI16
3945 -- : BFD_RELOC_FRV_GPREL12
3946 -- : BFD_RELOC_FRV_GPRELU12
3947 -- : BFD_RELOC_FRV_GPREL32
3948 -- : BFD_RELOC_FRV_GPRELHI
3949 -- : BFD_RELOC_FRV_GPRELLO
3950 -- : BFD_RELOC_FRV_GOT12
3951 -- : BFD_RELOC_FRV_GOTHI
3952 -- : BFD_RELOC_FRV_GOTLO
3953 -- : BFD_RELOC_FRV_FUNCDESC
3954 -- : BFD_RELOC_FRV_FUNCDESC_GOT12
3955 -- : BFD_RELOC_FRV_FUNCDESC_GOTHI
3956 -- : BFD_RELOC_FRV_FUNCDESC_GOTLO
3957 -- : BFD_RELOC_FRV_FUNCDESC_VALUE
3958 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFF12
3959 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFHI
3960 -- : BFD_RELOC_FRV_FUNCDESC_GOTOFFLO
3961 -- : BFD_RELOC_FRV_GOTOFF12
3962 -- : BFD_RELOC_FRV_GOTOFFHI
3963 -- : BFD_RELOC_FRV_GOTOFFLO
3964 -- : BFD_RELOC_FRV_GETTLSOFF
3965 -- : BFD_RELOC_FRV_TLSDESC_VALUE
3966 -- : BFD_RELOC_FRV_GOTTLSDESC12
3967 -- : BFD_RELOC_FRV_GOTTLSDESCHI
3968 -- : BFD_RELOC_FRV_GOTTLSDESCLO
3969 -- : BFD_RELOC_FRV_TLSMOFF12
3970 -- : BFD_RELOC_FRV_TLSMOFFHI
3971 -- : BFD_RELOC_FRV_TLSMOFFLO
3972 -- : BFD_RELOC_FRV_GOTTLSOFF12
3973 -- : BFD_RELOC_FRV_GOTTLSOFFHI
3974 -- : BFD_RELOC_FRV_GOTTLSOFFLO
3975 -- : BFD_RELOC_FRV_TLSOFF
3976 -- : BFD_RELOC_FRV_TLSDESC_RELAX
3977 -- : BFD_RELOC_FRV_GETTLSOFF_RELAX
3978 -- : BFD_RELOC_FRV_TLSOFF_RELAX
3979 -- : BFD_RELOC_FRV_TLSMOFF
3980     Fujitsu Frv Relocations.
3981 -- : BFD_RELOC_MN10300_GOTOFF24
3982     This is a 24bit GOT-relative reloc for the mn10300.
3983 -- : BFD_RELOC_MN10300_GOT32
3984     This is a 32bit GOT-relative reloc for the mn10300, offset by two
3985     bytes in the instruction.
3986 -- : BFD_RELOC_MN10300_GOT24
3987     This is a 24bit GOT-relative reloc for the mn10300, offset by two
3988     bytes in the instruction.
3989 -- : BFD_RELOC_MN10300_GOT16
3990     This is a 16bit GOT-relative reloc for the mn10300, offset by two
3991     bytes in the instruction.
3992 -- : BFD_RELOC_MN10300_COPY
3993     Copy symbol at runtime.
3994 -- : BFD_RELOC_MN10300_GLOB_DAT
3995     Create GOT entry.
3996 -- : BFD_RELOC_MN10300_JMP_SLOT
3997     Create PLT entry.
3998 -- : BFD_RELOC_MN10300_RELATIVE
3999     Adjust by program base.
4000 -- : BFD_RELOC_MN10300_SYM_DIFF
4001     Together with another reloc targeted at the same location, allows
4002     for a value that is the difference of two symbols in the same
4003     section.
4004 -- : BFD_RELOC_MN10300_ALIGN
4005     The addend of this reloc is an alignment power that must be
4006     honoured at the offset's location, regardless of linker relaxation.
4007 -- : BFD_RELOC_MN10300_TLS_GD
4008 -- : BFD_RELOC_MN10300_TLS_LD
4009 -- : BFD_RELOC_MN10300_TLS_LDO
4010 -- : BFD_RELOC_MN10300_TLS_GOTIE
4011 -- : BFD_RELOC_MN10300_TLS_IE
4012 -- : BFD_RELOC_MN10300_TLS_LE
4013 -- : BFD_RELOC_MN10300_TLS_DTPMOD
4014 -- : BFD_RELOC_MN10300_TLS_DTPOFF
4015 -- : BFD_RELOC_MN10300_TLS_TPOFF
4016     Various TLS-related relocations.
4017 -- : BFD_RELOC_MN10300_32_PCREL
4018     This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
4019     the instruction.
4020 -- : BFD_RELOC_MN10300_16_PCREL
4021     This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
4022     the instruction.
4023 -- : BFD_RELOC_386_GOT32
4024 -- : BFD_RELOC_386_PLT32
4025 -- : BFD_RELOC_386_COPY
4026 -- : BFD_RELOC_386_GLOB_DAT
4027 -- : BFD_RELOC_386_JUMP_SLOT
4028 -- : BFD_RELOC_386_RELATIVE
4029 -- : BFD_RELOC_386_GOTOFF
4030 -- : BFD_RELOC_386_GOTPC
4031 -- : BFD_RELOC_386_TLS_TPOFF
4032 -- : BFD_RELOC_386_TLS_IE
4033 -- : BFD_RELOC_386_TLS_GOTIE
4034 -- : BFD_RELOC_386_TLS_LE
4035 -- : BFD_RELOC_386_TLS_GD
4036 -- : BFD_RELOC_386_TLS_LDM
4037 -- : BFD_RELOC_386_TLS_LDO_32
4038 -- : BFD_RELOC_386_TLS_IE_32
4039 -- : BFD_RELOC_386_TLS_LE_32
4040 -- : BFD_RELOC_386_TLS_DTPMOD32
4041 -- : BFD_RELOC_386_TLS_DTPOFF32
4042 -- : BFD_RELOC_386_TLS_TPOFF32
4043 -- : BFD_RELOC_386_TLS_GOTDESC
4044 -- : BFD_RELOC_386_TLS_DESC_CALL
4045 -- : BFD_RELOC_386_TLS_DESC
4046 -- : BFD_RELOC_386_IRELATIVE
4047 -- : BFD_RELOC_386_GOT32X
4048     i386/elf relocations
4049 -- : BFD_RELOC_X86_64_GOT32
4050 -- : BFD_RELOC_X86_64_PLT32
4051 -- : BFD_RELOC_X86_64_COPY
4052 -- : BFD_RELOC_X86_64_GLOB_DAT
4053 -- : BFD_RELOC_X86_64_JUMP_SLOT
4054 -- : BFD_RELOC_X86_64_RELATIVE
4055 -- : BFD_RELOC_X86_64_GOTPCREL
4056 -- : BFD_RELOC_X86_64_32S
4057 -- : BFD_RELOC_X86_64_DTPMOD64
4058 -- : BFD_RELOC_X86_64_DTPOFF64
4059 -- : BFD_RELOC_X86_64_TPOFF64
4060 -- : BFD_RELOC_X86_64_TLSGD
4061 -- : BFD_RELOC_X86_64_TLSLD
4062 -- : BFD_RELOC_X86_64_DTPOFF32
4063 -- : BFD_RELOC_X86_64_GOTTPOFF
4064 -- : BFD_RELOC_X86_64_TPOFF32
4065 -- : BFD_RELOC_X86_64_GOTOFF64
4066 -- : BFD_RELOC_X86_64_GOTPC32
4067 -- : BFD_RELOC_X86_64_GOT64
4068 -- : BFD_RELOC_X86_64_GOTPCREL64
4069 -- : BFD_RELOC_X86_64_GOTPC64
4070 -- : BFD_RELOC_X86_64_GOTPLT64
4071 -- : BFD_RELOC_X86_64_PLTOFF64
4072 -- : BFD_RELOC_X86_64_GOTPC32_TLSDESC
4073 -- : BFD_RELOC_X86_64_TLSDESC_CALL
4074 -- : BFD_RELOC_X86_64_TLSDESC
4075 -- : BFD_RELOC_X86_64_IRELATIVE
4076 -- : BFD_RELOC_X86_64_PC32_BND
4077 -- : BFD_RELOC_X86_64_PLT32_BND
4078 -- : BFD_RELOC_X86_64_GOTPCRELX
4079 -- : BFD_RELOC_X86_64_REX_GOTPCRELX
4080     x86-64/elf relocations
4081 -- : BFD_RELOC_NS32K_IMM_8
4082 -- : BFD_RELOC_NS32K_IMM_16
4083 -- : BFD_RELOC_NS32K_IMM_32
4084 -- : BFD_RELOC_NS32K_IMM_8_PCREL
4085 -- : BFD_RELOC_NS32K_IMM_16_PCREL
4086 -- : BFD_RELOC_NS32K_IMM_32_PCREL
4087 -- : BFD_RELOC_NS32K_DISP_8
4088 -- : BFD_RELOC_NS32K_DISP_16
4089 -- : BFD_RELOC_NS32K_DISP_32
4090 -- : BFD_RELOC_NS32K_DISP_8_PCREL
4091 -- : BFD_RELOC_NS32K_DISP_16_PCREL
4092 -- : BFD_RELOC_NS32K_DISP_32_PCREL
4093     ns32k relocations
4094 -- : BFD_RELOC_PDP11_DISP_8_PCREL
4095 -- : BFD_RELOC_PDP11_DISP_6_PCREL
4096     PDP11 relocations
4097 -- : BFD_RELOC_PJ_CODE_HI16
4098 -- : BFD_RELOC_PJ_CODE_LO16
4099 -- : BFD_RELOC_PJ_CODE_DIR16
4100 -- : BFD_RELOC_PJ_CODE_DIR32
4101 -- : BFD_RELOC_PJ_CODE_REL16
4102 -- : BFD_RELOC_PJ_CODE_REL32
4103     Picojava relocs.  Not all of these appear in object files.
4104 -- : BFD_RELOC_PPC_B26
4105 -- : BFD_RELOC_PPC_BA26
4106 -- : BFD_RELOC_PPC_TOC16
4107 -- : BFD_RELOC_PPC_B16
4108 -- : BFD_RELOC_PPC_B16_BRTAKEN
4109 -- : BFD_RELOC_PPC_B16_BRNTAKEN
4110 -- : BFD_RELOC_PPC_BA16
4111 -- : BFD_RELOC_PPC_BA16_BRTAKEN
4112 -- : BFD_RELOC_PPC_BA16_BRNTAKEN
4113 -- : BFD_RELOC_PPC_COPY
4114 -- : BFD_RELOC_PPC_GLOB_DAT
4115 -- : BFD_RELOC_PPC_JMP_SLOT
4116 -- : BFD_RELOC_PPC_RELATIVE
4117 -- : BFD_RELOC_PPC_LOCAL24PC
4118 -- : BFD_RELOC_PPC_EMB_NADDR32
4119 -- : BFD_RELOC_PPC_EMB_NADDR16
4120 -- : BFD_RELOC_PPC_EMB_NADDR16_LO
4121 -- : BFD_RELOC_PPC_EMB_NADDR16_HI
4122 -- : BFD_RELOC_PPC_EMB_NADDR16_HA
4123 -- : BFD_RELOC_PPC_EMB_SDAI16
4124 -- : BFD_RELOC_PPC_EMB_SDA2I16
4125 -- : BFD_RELOC_PPC_EMB_SDA2REL
4126 -- : BFD_RELOC_PPC_EMB_SDA21
4127 -- : BFD_RELOC_PPC_EMB_MRKREF
4128 -- : BFD_RELOC_PPC_EMB_RELSEC16
4129 -- : BFD_RELOC_PPC_EMB_RELST_LO
4130 -- : BFD_RELOC_PPC_EMB_RELST_HI
4131 -- : BFD_RELOC_PPC_EMB_RELST_HA
4132 -- : BFD_RELOC_PPC_EMB_BIT_FLD
4133 -- : BFD_RELOC_PPC_EMB_RELSDA
4134 -- : BFD_RELOC_PPC_VLE_REL8
4135 -- : BFD_RELOC_PPC_VLE_REL15
4136 -- : BFD_RELOC_PPC_VLE_REL24
4137 -- : BFD_RELOC_PPC_VLE_LO16A
4138 -- : BFD_RELOC_PPC_VLE_LO16D
4139 -- : BFD_RELOC_PPC_VLE_HI16A
4140 -- : BFD_RELOC_PPC_VLE_HI16D
4141 -- : BFD_RELOC_PPC_VLE_HA16A
4142 -- : BFD_RELOC_PPC_VLE_HA16D
4143 -- : BFD_RELOC_PPC_VLE_SDA21
4144 -- : BFD_RELOC_PPC_VLE_SDA21_LO
4145 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16A
4146 -- : BFD_RELOC_PPC_VLE_SDAREL_LO16D
4147 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16A
4148 -- : BFD_RELOC_PPC_VLE_SDAREL_HI16D
4149 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16A
4150 -- : BFD_RELOC_PPC_VLE_SDAREL_HA16D
4151 -- : BFD_RELOC_PPC_16DX_HA
4152 -- : BFD_RELOC_PPC_REL16DX_HA
4153 -- : BFD_RELOC_PPC64_HIGHER
4154 -- : BFD_RELOC_PPC64_HIGHER_S
4155 -- : BFD_RELOC_PPC64_HIGHEST
4156 -- : BFD_RELOC_PPC64_HIGHEST_S
4157 -- : BFD_RELOC_PPC64_TOC16_LO
4158 -- : BFD_RELOC_PPC64_TOC16_HI
4159 -- : BFD_RELOC_PPC64_TOC16_HA
4160 -- : BFD_RELOC_PPC64_TOC
4161 -- : BFD_RELOC_PPC64_PLTGOT16
4162 -- : BFD_RELOC_PPC64_PLTGOT16_LO
4163 -- : BFD_RELOC_PPC64_PLTGOT16_HI
4164 -- : BFD_RELOC_PPC64_PLTGOT16_HA
4165 -- : BFD_RELOC_PPC64_ADDR16_DS
4166 -- : BFD_RELOC_PPC64_ADDR16_LO_DS
4167 -- : BFD_RELOC_PPC64_GOT16_DS
4168 -- : BFD_RELOC_PPC64_GOT16_LO_DS
4169 -- : BFD_RELOC_PPC64_PLT16_LO_DS
4170 -- : BFD_RELOC_PPC64_SECTOFF_DS
4171 -- : BFD_RELOC_PPC64_SECTOFF_LO_DS
4172 -- : BFD_RELOC_PPC64_TOC16_DS
4173 -- : BFD_RELOC_PPC64_TOC16_LO_DS
4174 -- : BFD_RELOC_PPC64_PLTGOT16_DS
4175 -- : BFD_RELOC_PPC64_PLTGOT16_LO_DS
4176 -- : BFD_RELOC_PPC64_ADDR16_HIGH
4177 -- : BFD_RELOC_PPC64_ADDR16_HIGHA
4178 -- : BFD_RELOC_PPC64_ADDR64_LOCAL
4179 -- : BFD_RELOC_PPC64_ENTRY
4180     Power(rs6000) and PowerPC relocations.
4181 -- : BFD_RELOC_PPC_TLS
4182 -- : BFD_RELOC_PPC_TLSGD
4183 -- : BFD_RELOC_PPC_TLSLD
4184 -- : BFD_RELOC_PPC_DTPMOD
4185 -- : BFD_RELOC_PPC_TPREL16
4186 -- : BFD_RELOC_PPC_TPREL16_LO
4187 -- : BFD_RELOC_PPC_TPREL16_HI
4188 -- : BFD_RELOC_PPC_TPREL16_HA
4189 -- : BFD_RELOC_PPC_TPREL
4190 -- : BFD_RELOC_PPC_DTPREL16
4191 -- : BFD_RELOC_PPC_DTPREL16_LO
4192 -- : BFD_RELOC_PPC_DTPREL16_HI
4193 -- : BFD_RELOC_PPC_DTPREL16_HA
4194 -- : BFD_RELOC_PPC_DTPREL
4195 -- : BFD_RELOC_PPC_GOT_TLSGD16
4196 -- : BFD_RELOC_PPC_GOT_TLSGD16_LO
4197 -- : BFD_RELOC_PPC_GOT_TLSGD16_HI
4198 -- : BFD_RELOC_PPC_GOT_TLSGD16_HA
4199 -- : BFD_RELOC_PPC_GOT_TLSLD16
4200 -- : BFD_RELOC_PPC_GOT_TLSLD16_LO
4201 -- : BFD_RELOC_PPC_GOT_TLSLD16_HI
4202 -- : BFD_RELOC_PPC_GOT_TLSLD16_HA
4203 -- : BFD_RELOC_PPC_GOT_TPREL16
4204 -- : BFD_RELOC_PPC_GOT_TPREL16_LO
4205 -- : BFD_RELOC_PPC_GOT_TPREL16_HI
4206 -- : BFD_RELOC_PPC_GOT_TPREL16_HA
4207 -- : BFD_RELOC_PPC_GOT_DTPREL16
4208 -- : BFD_RELOC_PPC_GOT_DTPREL16_LO
4209 -- : BFD_RELOC_PPC_GOT_DTPREL16_HI
4210 -- : BFD_RELOC_PPC_GOT_DTPREL16_HA
4211 -- : BFD_RELOC_PPC64_TPREL16_DS
4212 -- : BFD_RELOC_PPC64_TPREL16_LO_DS
4213 -- : BFD_RELOC_PPC64_TPREL16_HIGHER
4214 -- : BFD_RELOC_PPC64_TPREL16_HIGHERA
4215 -- : BFD_RELOC_PPC64_TPREL16_HIGHEST
4216 -- : BFD_RELOC_PPC64_TPREL16_HIGHESTA
4217 -- : BFD_RELOC_PPC64_DTPREL16_DS
4218 -- : BFD_RELOC_PPC64_DTPREL16_LO_DS
4219 -- : BFD_RELOC_PPC64_DTPREL16_HIGHER
4220 -- : BFD_RELOC_PPC64_DTPREL16_HIGHERA
4221 -- : BFD_RELOC_PPC64_DTPREL16_HIGHEST
4222 -- : BFD_RELOC_PPC64_DTPREL16_HIGHESTA
4223 -- : BFD_RELOC_PPC64_TPREL16_HIGH
4224 -- : BFD_RELOC_PPC64_TPREL16_HIGHA
4225 -- : BFD_RELOC_PPC64_DTPREL16_HIGH
4226 -- : BFD_RELOC_PPC64_DTPREL16_HIGHA
4227     PowerPC and PowerPC64 thread-local storage relocations.
4228 -- : BFD_RELOC_I370_D12
4229     IBM 370/390 relocations
4230 -- : BFD_RELOC_CTOR
4231     The type of reloc used to build a constructor table - at the moment
4232     probably a 32 bit wide absolute relocation, but the target can
4233     choose.  It generally does map to one of the other relocation
4234     types.
4235 -- : BFD_RELOC_ARM_PCREL_BRANCH
4236     ARM 26 bit pc-relative branch.  The lowest two bits must be zero
4237     and are not stored in the instruction.
4238 -- : BFD_RELOC_ARM_PCREL_BLX
4239     ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
4240     not stored in the instruction.  The 2nd lowest bit comes from a 1
4241     bit field in the instruction.
4242 -- : BFD_RELOC_THUMB_PCREL_BLX
4243     Thumb 22 bit pc-relative branch.  The lowest bit must be zero and
4244     is not stored in the instruction.  The 2nd lowest bit comes from a
4245     1 bit field in the instruction.
4246 -- : BFD_RELOC_ARM_PCREL_CALL
4247     ARM 26-bit pc-relative branch for an unconditional BL or BLX
4248     instruction.
4249 -- : BFD_RELOC_ARM_PCREL_JUMP
4250     ARM 26-bit pc-relative branch for B or conditional BL instruction.
4251 -- : BFD_RELOC_THUMB_PCREL_BRANCH7
4252 -- : BFD_RELOC_THUMB_PCREL_BRANCH9
4253 -- : BFD_RELOC_THUMB_PCREL_BRANCH12
4254 -- : BFD_RELOC_THUMB_PCREL_BRANCH20
4255 -- : BFD_RELOC_THUMB_PCREL_BRANCH23
4256 -- : BFD_RELOC_THUMB_PCREL_BRANCH25
4257     Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.  The
4258     lowest bit must be zero and is not stored in the instruction.  Note
4259     that the corresponding ELF R_ARM_THM_JUMPnn constant has an "nn"
4260     one smaller in all cases.  Note further that BRANCH23 corresponds
4261     to R_ARM_THM_CALL.
4262 -- : BFD_RELOC_ARM_OFFSET_IMM
4263     12-bit immediate offset, used in ARM-format ldr and str
4264     instructions.
4265 -- : BFD_RELOC_ARM_THUMB_OFFSET
4266     5-bit immediate offset, used in Thumb-format ldr and str
4267     instructions.
4268 -- : BFD_RELOC_ARM_TARGET1
4269     Pc-relative or absolute relocation depending on target.  Used for
4270     entries in .init_array sections.
4271 -- : BFD_RELOC_ARM_ROSEGREL32
4272     Read-only segment base relative address.
4273 -- : BFD_RELOC_ARM_SBREL32
4274     Data segment base relative address.
4275 -- : BFD_RELOC_ARM_TARGET2
4276     This reloc is used for references to RTTI data from exception
4277     handling tables.  The actual definition depends on the target.  It
4278     may be a pc-relative or some form of GOT-indirect relocation.
4279 -- : BFD_RELOC_ARM_PREL31
4280     31-bit PC relative address.
4281 -- : BFD_RELOC_ARM_MOVW
4282 -- : BFD_RELOC_ARM_MOVT
4283 -- : BFD_RELOC_ARM_MOVW_PCREL
4284 -- : BFD_RELOC_ARM_MOVT_PCREL
4285 -- : BFD_RELOC_ARM_THUMB_MOVW
4286 -- : BFD_RELOC_ARM_THUMB_MOVT
4287 -- : BFD_RELOC_ARM_THUMB_MOVW_PCREL
4288 -- : BFD_RELOC_ARM_THUMB_MOVT_PCREL
4289     Low and High halfword relocations for MOVW and MOVT instructions.
4290 -- : BFD_RELOC_ARM_GOTFUNCDESC
4291 -- : BFD_RELOC_ARM_GOTOFFFUNCDESC
4292 -- : BFD_RELOC_ARM_FUNCDESC
4293 -- : BFD_RELOC_ARM_FUNCDESC_VALUE
4294 -- : BFD_RELOC_ARM_TLS_GD32_FDPIC
4295 -- : BFD_RELOC_ARM_TLS_LDM32_FDPIC
4296 -- : BFD_RELOC_ARM_TLS_IE32_FDPIC
4297     ARM FDPIC specific relocations.
4298 -- : BFD_RELOC_ARM_JUMP_SLOT
4299 -- : BFD_RELOC_ARM_GLOB_DAT
4300 -- : BFD_RELOC_ARM_GOT32
4301 -- : BFD_RELOC_ARM_PLT32
4302 -- : BFD_RELOC_ARM_RELATIVE
4303 -- : BFD_RELOC_ARM_GOTOFF
4304 -- : BFD_RELOC_ARM_GOTPC
4305 -- : BFD_RELOC_ARM_GOT_PREL
4306     Relocations for setting up GOTs and PLTs for shared libraries.
4307 -- : BFD_RELOC_ARM_TLS_GD32
4308 -- : BFD_RELOC_ARM_TLS_LDO32
4309 -- : BFD_RELOC_ARM_TLS_LDM32
4310 -- : BFD_RELOC_ARM_TLS_DTPOFF32
4311 -- : BFD_RELOC_ARM_TLS_DTPMOD32
4312 -- : BFD_RELOC_ARM_TLS_TPOFF32
4313 -- : BFD_RELOC_ARM_TLS_IE32
4314 -- : BFD_RELOC_ARM_TLS_LE32
4315 -- : BFD_RELOC_ARM_TLS_GOTDESC
4316 -- : BFD_RELOC_ARM_TLS_CALL
4317 -- : BFD_RELOC_ARM_THM_TLS_CALL
4318 -- : BFD_RELOC_ARM_TLS_DESCSEQ
4319 -- : BFD_RELOC_ARM_THM_TLS_DESCSEQ
4320 -- : BFD_RELOC_ARM_TLS_DESC
4321     ARM thread-local storage relocations.
4322 -- : BFD_RELOC_ARM_ALU_PC_G0_NC
4323 -- : BFD_RELOC_ARM_ALU_PC_G0
4324 -- : BFD_RELOC_ARM_ALU_PC_G1_NC
4325 -- : BFD_RELOC_ARM_ALU_PC_G1
4326 -- : BFD_RELOC_ARM_ALU_PC_G2
4327 -- : BFD_RELOC_ARM_LDR_PC_G0
4328 -- : BFD_RELOC_ARM_LDR_PC_G1
4329 -- : BFD_RELOC_ARM_LDR_PC_G2
4330 -- : BFD_RELOC_ARM_LDRS_PC_G0
4331 -- : BFD_RELOC_ARM_LDRS_PC_G1
4332 -- : BFD_RELOC_ARM_LDRS_PC_G2
4333 -- : BFD_RELOC_ARM_LDC_PC_G0
4334 -- : BFD_RELOC_ARM_LDC_PC_G1
4335 -- : BFD_RELOC_ARM_LDC_PC_G2
4336 -- : BFD_RELOC_ARM_ALU_SB_G0_NC
4337 -- : BFD_RELOC_ARM_ALU_SB_G0
4338 -- : BFD_RELOC_ARM_ALU_SB_G1_NC
4339 -- : BFD_RELOC_ARM_ALU_SB_G1
4340 -- : BFD_RELOC_ARM_ALU_SB_G2
4341 -- : BFD_RELOC_ARM_LDR_SB_G0
4342 -- : BFD_RELOC_ARM_LDR_SB_G1
4343 -- : BFD_RELOC_ARM_LDR_SB_G2
4344 -- : BFD_RELOC_ARM_LDRS_SB_G0
4345 -- : BFD_RELOC_ARM_LDRS_SB_G1
4346 -- : BFD_RELOC_ARM_LDRS_SB_G2
4347 -- : BFD_RELOC_ARM_LDC_SB_G0
4348 -- : BFD_RELOC_ARM_LDC_SB_G1
4349 -- : BFD_RELOC_ARM_LDC_SB_G2
4350     ARM group relocations.
4351 -- : BFD_RELOC_ARM_V4BX
4352     Annotation of BX instructions.
4353 -- : BFD_RELOC_ARM_IRELATIVE
4354     ARM support for STT_GNU_IFUNC.
4355 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC
4356 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC
4357 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC
4358 -- : BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC
4359     Thumb1 relocations to support execute-only code.
4360 -- : BFD_RELOC_ARM_IMMEDIATE
4361 -- : BFD_RELOC_ARM_ADRL_IMMEDIATE
4362 -- : BFD_RELOC_ARM_T32_IMMEDIATE
4363 -- : BFD_RELOC_ARM_T32_ADD_IMM
4364 -- : BFD_RELOC_ARM_T32_IMM12
4365 -- : BFD_RELOC_ARM_T32_ADD_PC12
4366 -- : BFD_RELOC_ARM_SHIFT_IMM
4367 -- : BFD_RELOC_ARM_SMC
4368 -- : BFD_RELOC_ARM_HVC
4369 -- : BFD_RELOC_ARM_SWI
4370 -- : BFD_RELOC_ARM_MULTI
4371 -- : BFD_RELOC_ARM_CP_OFF_IMM
4372 -- : BFD_RELOC_ARM_CP_OFF_IMM_S2
4373 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM
4374 -- : BFD_RELOC_ARM_T32_CP_OFF_IMM_S2
4375 -- : BFD_RELOC_ARM_ADR_IMM
4376 -- : BFD_RELOC_ARM_LDR_IMM
4377 -- : BFD_RELOC_ARM_LITERAL
4378 -- : BFD_RELOC_ARM_IN_POOL
4379 -- : BFD_RELOC_ARM_OFFSET_IMM8
4380 -- : BFD_RELOC_ARM_T32_OFFSET_U8
4381 -- : BFD_RELOC_ARM_T32_OFFSET_IMM
4382 -- : BFD_RELOC_ARM_HWLITERAL
4383 -- : BFD_RELOC_ARM_THUMB_ADD
4384 -- : BFD_RELOC_ARM_THUMB_IMM
4385 -- : BFD_RELOC_ARM_THUMB_SHIFT
4386     These relocs are only used within the ARM assembler.  They are not
4387     (at present) written to any object files.
4388 -- : BFD_RELOC_SH_PCDISP8BY2
4389 -- : BFD_RELOC_SH_PCDISP12BY2
4390 -- : BFD_RELOC_SH_IMM3
4391 -- : BFD_RELOC_SH_IMM3U
4392 -- : BFD_RELOC_SH_DISP12
4393 -- : BFD_RELOC_SH_DISP12BY2
4394 -- : BFD_RELOC_SH_DISP12BY4
4395 -- : BFD_RELOC_SH_DISP12BY8
4396 -- : BFD_RELOC_SH_DISP20
4397 -- : BFD_RELOC_SH_DISP20BY8
4398 -- : BFD_RELOC_SH_IMM4
4399 -- : BFD_RELOC_SH_IMM4BY2
4400 -- : BFD_RELOC_SH_IMM4BY4
4401 -- : BFD_RELOC_SH_IMM8
4402 -- : BFD_RELOC_SH_IMM8BY2
4403 -- : BFD_RELOC_SH_IMM8BY4
4404 -- : BFD_RELOC_SH_PCRELIMM8BY2
4405 -- : BFD_RELOC_SH_PCRELIMM8BY4
4406 -- : BFD_RELOC_SH_SWITCH16
4407 -- : BFD_RELOC_SH_SWITCH32
4408 -- : BFD_RELOC_SH_USES
4409 -- : BFD_RELOC_SH_COUNT
4410 -- : BFD_RELOC_SH_ALIGN
4411 -- : BFD_RELOC_SH_CODE
4412 -- : BFD_RELOC_SH_DATA
4413 -- : BFD_RELOC_SH_LABEL
4414 -- : BFD_RELOC_SH_LOOP_START
4415 -- : BFD_RELOC_SH_LOOP_END
4416 -- : BFD_RELOC_SH_COPY
4417 -- : BFD_RELOC_SH_GLOB_DAT
4418 -- : BFD_RELOC_SH_JMP_SLOT
4419 -- : BFD_RELOC_SH_RELATIVE
4420 -- : BFD_RELOC_SH_GOTPC
4421 -- : BFD_RELOC_SH_GOT_LOW16
4422 -- : BFD_RELOC_SH_GOT_MEDLOW16
4423 -- : BFD_RELOC_SH_GOT_MEDHI16
4424 -- : BFD_RELOC_SH_GOT_HI16
4425 -- : BFD_RELOC_SH_GOTPLT_LOW16
4426 -- : BFD_RELOC_SH_GOTPLT_MEDLOW16
4427 -- : BFD_RELOC_SH_GOTPLT_MEDHI16
4428 -- : BFD_RELOC_SH_GOTPLT_HI16
4429 -- : BFD_RELOC_SH_PLT_LOW16
4430 -- : BFD_RELOC_SH_PLT_MEDLOW16
4431 -- : BFD_RELOC_SH_PLT_MEDHI16
4432 -- : BFD_RELOC_SH_PLT_HI16
4433 -- : BFD_RELOC_SH_GOTOFF_LOW16
4434 -- : BFD_RELOC_SH_GOTOFF_MEDLOW16
4435 -- : BFD_RELOC_SH_GOTOFF_MEDHI16
4436 -- : BFD_RELOC_SH_GOTOFF_HI16
4437 -- : BFD_RELOC_SH_GOTPC_LOW16
4438 -- : BFD_RELOC_SH_GOTPC_MEDLOW16
4439 -- : BFD_RELOC_SH_GOTPC_MEDHI16
4440 -- : BFD_RELOC_SH_GOTPC_HI16
4441 -- : BFD_RELOC_SH_COPY64
4442 -- : BFD_RELOC_SH_GLOB_DAT64
4443 -- : BFD_RELOC_SH_JMP_SLOT64
4444 -- : BFD_RELOC_SH_RELATIVE64
4445 -- : BFD_RELOC_SH_GOT10BY4
4446 -- : BFD_RELOC_SH_GOT10BY8
4447 -- : BFD_RELOC_SH_GOTPLT10BY4
4448 -- : BFD_RELOC_SH_GOTPLT10BY8
4449 -- : BFD_RELOC_SH_GOTPLT32
4450 -- : BFD_RELOC_SH_SHMEDIA_CODE
4451 -- : BFD_RELOC_SH_IMMU5
4452 -- : BFD_RELOC_SH_IMMS6
4453 -- : BFD_RELOC_SH_IMMS6BY32
4454 -- : BFD_RELOC_SH_IMMU6
4455 -- : BFD_RELOC_SH_IMMS10
4456 -- : BFD_RELOC_SH_IMMS10BY2
4457 -- : BFD_RELOC_SH_IMMS10BY4
4458 -- : BFD_RELOC_SH_IMMS10BY8
4459 -- : BFD_RELOC_SH_IMMS16
4460 -- : BFD_RELOC_SH_IMMU16
4461 -- : BFD_RELOC_SH_IMM_LOW16
4462 -- : BFD_RELOC_SH_IMM_LOW16_PCREL
4463 -- : BFD_RELOC_SH_IMM_MEDLOW16
4464 -- : BFD_RELOC_SH_IMM_MEDLOW16_PCREL
4465 -- : BFD_RELOC_SH_IMM_MEDHI16
4466 -- : BFD_RELOC_SH_IMM_MEDHI16_PCREL
4467 -- : BFD_RELOC_SH_IMM_HI16
4468 -- : BFD_RELOC_SH_IMM_HI16_PCREL
4469 -- : BFD_RELOC_SH_PT_16
4470 -- : BFD_RELOC_SH_TLS_GD_32
4471 -- : BFD_RELOC_SH_TLS_LD_32
4472 -- : BFD_RELOC_SH_TLS_LDO_32
4473 -- : BFD_RELOC_SH_TLS_IE_32
4474 -- : BFD_RELOC_SH_TLS_LE_32
4475 -- : BFD_RELOC_SH_TLS_DTPMOD32
4476 -- : BFD_RELOC_SH_TLS_DTPOFF32
4477 -- : BFD_RELOC_SH_TLS_TPOFF32
4478 -- : BFD_RELOC_SH_GOT20
4479 -- : BFD_RELOC_SH_GOTOFF20
4480 -- : BFD_RELOC_SH_GOTFUNCDESC
4481 -- : BFD_RELOC_SH_GOTFUNCDESC20
4482 -- : BFD_RELOC_SH_GOTOFFFUNCDESC
4483 -- : BFD_RELOC_SH_GOTOFFFUNCDESC20
4484 -- : BFD_RELOC_SH_FUNCDESC
4485     Renesas / SuperH SH relocs.  Not all of these appear in object
4486     files.
4487 -- : BFD_RELOC_ARC_NONE
4488 -- : BFD_RELOC_ARC_8
4489 -- : BFD_RELOC_ARC_16
4490 -- : BFD_RELOC_ARC_24
4491 -- : BFD_RELOC_ARC_32
4492 -- : BFD_RELOC_ARC_N8
4493 -- : BFD_RELOC_ARC_N16
4494 -- : BFD_RELOC_ARC_N24
4495 -- : BFD_RELOC_ARC_N32
4496 -- : BFD_RELOC_ARC_SDA
4497 -- : BFD_RELOC_ARC_SECTOFF
4498 -- : BFD_RELOC_ARC_S21H_PCREL
4499 -- : BFD_RELOC_ARC_S21W_PCREL
4500 -- : BFD_RELOC_ARC_S25H_PCREL
4501 -- : BFD_RELOC_ARC_S25W_PCREL
4502 -- : BFD_RELOC_ARC_SDA32
4503 -- : BFD_RELOC_ARC_SDA_LDST
4504 -- : BFD_RELOC_ARC_SDA_LDST1
4505 -- : BFD_RELOC_ARC_SDA_LDST2
4506 -- : BFD_RELOC_ARC_SDA16_LD
4507 -- : BFD_RELOC_ARC_SDA16_LD1
4508 -- : BFD_RELOC_ARC_SDA16_LD2
4509 -- : BFD_RELOC_ARC_S13_PCREL
4510 -- : BFD_RELOC_ARC_W
4511 -- : BFD_RELOC_ARC_32_ME
4512 -- : BFD_RELOC_ARC_32_ME_S
4513 -- : BFD_RELOC_ARC_N32_ME
4514 -- : BFD_RELOC_ARC_SECTOFF_ME
4515 -- : BFD_RELOC_ARC_SDA32_ME
4516 -- : BFD_RELOC_ARC_W_ME
4517 -- : BFD_RELOC_AC_SECTOFF_U8
4518 -- : BFD_RELOC_AC_SECTOFF_U8_1
4519 -- : BFD_RELOC_AC_SECTOFF_U8_2
4520 -- : BFD_RELOC_AC_SECTOFF_S9
4521 -- : BFD_RELOC_AC_SECTOFF_S9_1
4522 -- : BFD_RELOC_AC_SECTOFF_S9_2
4523 -- : BFD_RELOC_ARC_SECTOFF_ME_1
4524 -- : BFD_RELOC_ARC_SECTOFF_ME_2
4525 -- : BFD_RELOC_ARC_SECTOFF_1
4526 -- : BFD_RELOC_ARC_SECTOFF_2
4527 -- : BFD_RELOC_ARC_SDA_12
4528 -- : BFD_RELOC_ARC_SDA16_ST2
4529 -- : BFD_RELOC_ARC_32_PCREL
4530 -- : BFD_RELOC_ARC_PC32
4531 -- : BFD_RELOC_ARC_GOT32
4532 -- : BFD_RELOC_ARC_GOTPC32
4533 -- : BFD_RELOC_ARC_PLT32
4534 -- : BFD_RELOC_ARC_COPY
4535 -- : BFD_RELOC_ARC_GLOB_DAT
4536 -- : BFD_RELOC_ARC_JMP_SLOT
4537 -- : BFD_RELOC_ARC_RELATIVE
4538 -- : BFD_RELOC_ARC_GOTOFF
4539 -- : BFD_RELOC_ARC_GOTPC
4540 -- : BFD_RELOC_ARC_S21W_PCREL_PLT
4541 -- : BFD_RELOC_ARC_S25H_PCREL_PLT
4542 -- : BFD_RELOC_ARC_TLS_DTPMOD
4543 -- : BFD_RELOC_ARC_TLS_TPOFF
4544 -- : BFD_RELOC_ARC_TLS_GD_GOT
4545 -- : BFD_RELOC_ARC_TLS_GD_LD
4546 -- : BFD_RELOC_ARC_TLS_GD_CALL
4547 -- : BFD_RELOC_ARC_TLS_IE_GOT
4548 -- : BFD_RELOC_ARC_TLS_DTPOFF
4549 -- : BFD_RELOC_ARC_TLS_DTPOFF_S9
4550 -- : BFD_RELOC_ARC_TLS_LE_S9
4551 -- : BFD_RELOC_ARC_TLS_LE_32
4552 -- : BFD_RELOC_ARC_S25W_PCREL_PLT
4553 -- : BFD_RELOC_ARC_S21H_PCREL_PLT
4554 -- : BFD_RELOC_ARC_NPS_CMEM16
4555 -- : BFD_RELOC_ARC_JLI_SECTOFF
4556     ARC relocs.
4557 -- : BFD_RELOC_BFIN_16_IMM
4558     ADI Blackfin 16 bit immediate absolute reloc.
4559 -- : BFD_RELOC_BFIN_16_HIGH
4560     ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.
4561 -- : BFD_RELOC_BFIN_4_PCREL
4562     ADI Blackfin 'a' part of LSETUP.
4563 -- : BFD_RELOC_BFIN_5_PCREL
4564     ADI Blackfin.
4565 -- : BFD_RELOC_BFIN_16_LOW
4566     ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.
4567 -- : BFD_RELOC_BFIN_10_PCREL
4568     ADI Blackfin.
4569 -- : BFD_RELOC_BFIN_11_PCREL
4570     ADI Blackfin 'b' part of LSETUP.
4571 -- : BFD_RELOC_BFIN_12_PCREL_JUMP
4572     ADI Blackfin.
4573 -- : BFD_RELOC_BFIN_12_PCREL_JUMP_S
4574     ADI Blackfin Short jump, pcrel.
4575 -- : BFD_RELOC_BFIN_24_PCREL_CALL_X
4576     ADI Blackfin Call.x not implemented.
4577 -- : BFD_RELOC_BFIN_24_PCREL_JUMP_L
4578     ADI Blackfin Long Jump pcrel.
4579 -- : BFD_RELOC_BFIN_GOT17M4
4580 -- : BFD_RELOC_BFIN_GOTHI
4581 -- : BFD_RELOC_BFIN_GOTLO
4582 -- : BFD_RELOC_BFIN_FUNCDESC
4583 -- : BFD_RELOC_BFIN_FUNCDESC_GOT17M4
4584 -- : BFD_RELOC_BFIN_FUNCDESC_GOTHI
4585 -- : BFD_RELOC_BFIN_FUNCDESC_GOTLO
4586 -- : BFD_RELOC_BFIN_FUNCDESC_VALUE
4587 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4
4588 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI
4589 -- : BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO
4590 -- : BFD_RELOC_BFIN_GOTOFF17M4
4591 -- : BFD_RELOC_BFIN_GOTOFFHI
4592 -- : BFD_RELOC_BFIN_GOTOFFLO
4593     ADI Blackfin FD-PIC relocations.
4594 -- : BFD_RELOC_BFIN_GOT
4595     ADI Blackfin GOT relocation.
4596 -- : BFD_RELOC_BFIN_PLTPC
4597     ADI Blackfin PLTPC relocation.
4598 -- : BFD_ARELOC_BFIN_PUSH
4599     ADI Blackfin arithmetic relocation.
4600 -- : BFD_ARELOC_BFIN_CONST
4601     ADI Blackfin arithmetic relocation.
4602 -- : BFD_ARELOC_BFIN_ADD
4603     ADI Blackfin arithmetic relocation.
4604 -- : BFD_ARELOC_BFIN_SUB
4605     ADI Blackfin arithmetic relocation.
4606 -- : BFD_ARELOC_BFIN_MULT
4607     ADI Blackfin arithmetic relocation.
4608 -- : BFD_ARELOC_BFIN_DIV
4609     ADI Blackfin arithmetic relocation.
4610 -- : BFD_ARELOC_BFIN_MOD
4611     ADI Blackfin arithmetic relocation.
4612 -- : BFD_ARELOC_BFIN_LSHIFT
4613     ADI Blackfin arithmetic relocation.
4614 -- : BFD_ARELOC_BFIN_RSHIFT
4615     ADI Blackfin arithmetic relocation.
4616 -- : BFD_ARELOC_BFIN_AND
4617     ADI Blackfin arithmetic relocation.
4618 -- : BFD_ARELOC_BFIN_OR
4619     ADI Blackfin arithmetic relocation.
4620 -- : BFD_ARELOC_BFIN_XOR
4621     ADI Blackfin arithmetic relocation.
4622 -- : BFD_ARELOC_BFIN_LAND
4623     ADI Blackfin arithmetic relocation.
4624 -- : BFD_ARELOC_BFIN_LOR
4625     ADI Blackfin arithmetic relocation.
4626 -- : BFD_ARELOC_BFIN_LEN
4627     ADI Blackfin arithmetic relocation.
4628 -- : BFD_ARELOC_BFIN_NEG
4629     ADI Blackfin arithmetic relocation.
4630 -- : BFD_ARELOC_BFIN_COMP
4631     ADI Blackfin arithmetic relocation.
4632 -- : BFD_ARELOC_BFIN_PAGE
4633     ADI Blackfin arithmetic relocation.
4634 -- : BFD_ARELOC_BFIN_HWPAGE
4635     ADI Blackfin arithmetic relocation.
4636 -- : BFD_ARELOC_BFIN_ADDR
4637     ADI Blackfin arithmetic relocation.
4638 -- : BFD_RELOC_D10V_10_PCREL_R
4639     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4640     bits assumed to be 0.
4641 -- : BFD_RELOC_D10V_10_PCREL_L
4642     Mitsubishi D10V relocs.  This is a 10-bit reloc with the right 2
4643     bits assumed to be 0.  This is the same as the previous reloc
4644     except it is in the left container, i.e., shifted left 15 bits.
4645 -- : BFD_RELOC_D10V_18
4646     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4647 -- : BFD_RELOC_D10V_18_PCREL
4648     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4649 -- : BFD_RELOC_D30V_6
4650     Mitsubishi D30V relocs.  This is a 6-bit absolute reloc.
4651 -- : BFD_RELOC_D30V_9_PCREL
4652     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4653     be 0.
4654 -- : BFD_RELOC_D30V_9_PCREL_R
4655     This is a 6-bit pc-relative reloc with the right 3 bits assumed to
4656     be 0.  Same as the previous reloc but on the right side of the
4657     container.
4658 -- : BFD_RELOC_D30V_15
4659     This is a 12-bit absolute reloc with the right 3 bitsassumed to be
4660     0.
4661 -- : BFD_RELOC_D30V_15_PCREL
4662     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4663     be 0.
4664 -- : BFD_RELOC_D30V_15_PCREL_R
4665     This is a 12-bit pc-relative reloc with the right 3 bits assumed to
4666     be 0.  Same as the previous reloc but on the right side of the
4667     container.
4668 -- : BFD_RELOC_D30V_21
4669     This is an 18-bit absolute reloc with the right 3 bits assumed to
4670     be 0.
4671 -- : BFD_RELOC_D30V_21_PCREL
4672     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4673     to be 0.
4674 -- : BFD_RELOC_D30V_21_PCREL_R
4675     This is an 18-bit pc-relative reloc with the right 3 bits assumed
4676     to be 0.  Same as the previous reloc but on the right side of the
4677     container.
4678 -- : BFD_RELOC_D30V_32
4679     This is a 32-bit absolute reloc.
4680 -- : BFD_RELOC_D30V_32_PCREL
4681     This is a 32-bit pc-relative reloc.
4682 -- : BFD_RELOC_DLX_HI16_S
4683     DLX relocs
4684 -- : BFD_RELOC_DLX_LO16
4685     DLX relocs
4686 -- : BFD_RELOC_DLX_JMP26
4687     DLX relocs
4688 -- : BFD_RELOC_M32C_HI8
4689 -- : BFD_RELOC_M32C_RL_JUMP
4690 -- : BFD_RELOC_M32C_RL_1ADDR
4691 -- : BFD_RELOC_M32C_RL_2ADDR
4692     Renesas M16C/M32C Relocations.
4693 -- : BFD_RELOC_M32R_24
4694     Renesas M32R (formerly Mitsubishi M32R) relocs.  This is a 24 bit
4695     absolute address.
4696 -- : BFD_RELOC_M32R_10_PCREL
4697     This is a 10-bit pc-relative reloc with the right 2 bits assumed to
4698     be 0.
4699 -- : BFD_RELOC_M32R_18_PCREL
4700     This is an 18-bit reloc with the right 2 bits assumed to be 0.
4701 -- : BFD_RELOC_M32R_26_PCREL
4702     This is a 26-bit reloc with the right 2 bits assumed to be 0.
4703 -- : BFD_RELOC_M32R_HI16_ULO
4704     This is a 16-bit reloc containing the high 16 bits of an address
4705     used when the lower 16 bits are treated as unsigned.
4706 -- : BFD_RELOC_M32R_HI16_SLO
4707     This is a 16-bit reloc containing the high 16 bits of an address
4708     used when the lower 16 bits are treated as signed.
4709 -- : BFD_RELOC_M32R_LO16
4710     This is a 16-bit reloc containing the lower 16 bits of an address.
4711 -- : BFD_RELOC_M32R_SDA16
4712     This is a 16-bit reloc containing the small data area offset for
4713     use in add3, load, and store instructions.
4714 -- : BFD_RELOC_M32R_GOT24
4715 -- : BFD_RELOC_M32R_26_PLTREL
4716 -- : BFD_RELOC_M32R_COPY
4717 -- : BFD_RELOC_M32R_GLOB_DAT
4718 -- : BFD_RELOC_M32R_JMP_SLOT
4719 -- : BFD_RELOC_M32R_RELATIVE
4720 -- : BFD_RELOC_M32R_GOTOFF
4721 -- : BFD_RELOC_M32R_GOTOFF_HI_ULO
4722 -- : BFD_RELOC_M32R_GOTOFF_HI_SLO
4723 -- : BFD_RELOC_M32R_GOTOFF_LO
4724 -- : BFD_RELOC_M32R_GOTPC24
4725 -- : BFD_RELOC_M32R_GOT16_HI_ULO
4726 -- : BFD_RELOC_M32R_GOT16_HI_SLO
4727 -- : BFD_RELOC_M32R_GOT16_LO
4728 -- : BFD_RELOC_M32R_GOTPC_HI_ULO
4729 -- : BFD_RELOC_M32R_GOTPC_HI_SLO
4730 -- : BFD_RELOC_M32R_GOTPC_LO
4731     For PIC.
4732 -- : BFD_RELOC_NDS32_20
4733     NDS32 relocs.  This is a 20 bit absolute address.
4734 -- : BFD_RELOC_NDS32_9_PCREL
4735     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4736     be 0.
4737 -- : BFD_RELOC_NDS32_WORD_9_PCREL
4738     This is a 9-bit pc-relative reloc with the right 1 bit assumed to
4739     be 0.
4740 -- : BFD_RELOC_NDS32_15_PCREL
4741     This is an 15-bit reloc with the right 1 bit assumed to be 0.
4742 -- : BFD_RELOC_NDS32_17_PCREL
4743     This is an 17-bit reloc with the right 1 bit assumed to be 0.
4744 -- : BFD_RELOC_NDS32_25_PCREL
4745     This is a 25-bit reloc with the right 1 bit assumed to be 0.
4746 -- : BFD_RELOC_NDS32_HI20
4747     This is a 20-bit reloc containing the high 20 bits of an address
4748     used with the lower 12 bits
4749 -- : BFD_RELOC_NDS32_LO12S3
4750     This is a 12-bit reloc containing the lower 12 bits of an address
4751     then shift right by 3.  This is used with ldi,sdi...
4752 -- : BFD_RELOC_NDS32_LO12S2
4753     This is a 12-bit reloc containing the lower 12 bits of an address
4754     then shift left by 2.  This is used with lwi,swi...
4755 -- : BFD_RELOC_NDS32_LO12S1
4756     This is a 12-bit reloc containing the lower 12 bits of an address
4757     then shift left by 1.  This is used with lhi,shi...
4758 -- : BFD_RELOC_NDS32_LO12S0
4759     This is a 12-bit reloc containing the lower 12 bits of an address
4760     then shift left by 0.  This is used with lbisbi...
4761 -- : BFD_RELOC_NDS32_LO12S0_ORI
4762     This is a 12-bit reloc containing the lower 12 bits of an address
4763     then shift left by 0.  This is only used with branch relaxations
4764 -- : BFD_RELOC_NDS32_SDA15S3
4765     This is a 15-bit reloc containing the small data area 18-bit signed
4766     offset and shift left by 3 for use in ldi, sdi...
4767 -- : BFD_RELOC_NDS32_SDA15S2
4768     This is a 15-bit reloc containing the small data area 17-bit signed
4769     offset and shift left by 2 for use in lwi, swi...
4770 -- : BFD_RELOC_NDS32_SDA15S1
4771     This is a 15-bit reloc containing the small data area 16-bit signed
4772     offset and shift left by 1 for use in lhi, shi...
4773 -- : BFD_RELOC_NDS32_SDA15S0
4774     This is a 15-bit reloc containing the small data area 15-bit signed
4775     offset and shift left by 0 for use in lbi, sbi...
4776 -- : BFD_RELOC_NDS32_SDA16S3
4777     This is a 16-bit reloc containing the small data area 16-bit signed
4778     offset and shift left by 3
4779 -- : BFD_RELOC_NDS32_SDA17S2
4780     This is a 17-bit reloc containing the small data area 17-bit signed
4781     offset and shift left by 2 for use in lwi.gp, swi.gp...
4782 -- : BFD_RELOC_NDS32_SDA18S1
4783     This is a 18-bit reloc containing the small data area 18-bit signed
4784     offset and shift left by 1 for use in lhi.gp, shi.gp...
4785 -- : BFD_RELOC_NDS32_SDA19S0
4786     This is a 19-bit reloc containing the small data area 19-bit signed
4787     offset and shift left by 0 for use in lbi.gp, sbi.gp...
4788 -- : BFD_RELOC_NDS32_GOT20
4789 -- : BFD_RELOC_NDS32_9_PLTREL
4790 -- : BFD_RELOC_NDS32_25_PLTREL
4791 -- : BFD_RELOC_NDS32_COPY
4792 -- : BFD_RELOC_NDS32_GLOB_DAT
4793 -- : BFD_RELOC_NDS32_JMP_SLOT
4794 -- : BFD_RELOC_NDS32_RELATIVE
4795 -- : BFD_RELOC_NDS32_GOTOFF
4796 -- : BFD_RELOC_NDS32_GOTOFF_HI20
4797 -- : BFD_RELOC_NDS32_GOTOFF_LO12
4798 -- : BFD_RELOC_NDS32_GOTPC20
4799 -- : BFD_RELOC_NDS32_GOT_HI20
4800 -- : BFD_RELOC_NDS32_GOT_LO12
4801 -- : BFD_RELOC_NDS32_GOTPC_HI20
4802 -- : BFD_RELOC_NDS32_GOTPC_LO12
4803     for PIC
4804 -- : BFD_RELOC_NDS32_INSN16
4805 -- : BFD_RELOC_NDS32_LABEL
4806 -- : BFD_RELOC_NDS32_LONGCALL1
4807 -- : BFD_RELOC_NDS32_LONGCALL2
4808 -- : BFD_RELOC_NDS32_LONGCALL3
4809 -- : BFD_RELOC_NDS32_LONGJUMP1
4810 -- : BFD_RELOC_NDS32_LONGJUMP2
4811 -- : BFD_RELOC_NDS32_LONGJUMP3
4812 -- : BFD_RELOC_NDS32_LOADSTORE
4813 -- : BFD_RELOC_NDS32_9_FIXED
4814 -- : BFD_RELOC_NDS32_15_FIXED
4815 -- : BFD_RELOC_NDS32_17_FIXED
4816 -- : BFD_RELOC_NDS32_25_FIXED
4817 -- : BFD_RELOC_NDS32_LONGCALL4
4818 -- : BFD_RELOC_NDS32_LONGCALL5
4819 -- : BFD_RELOC_NDS32_LONGCALL6
4820 -- : BFD_RELOC_NDS32_LONGJUMP4
4821 -- : BFD_RELOC_NDS32_LONGJUMP5
4822 -- : BFD_RELOC_NDS32_LONGJUMP6
4823 -- : BFD_RELOC_NDS32_LONGJUMP7
4824     for relax
4825 -- : BFD_RELOC_NDS32_PLTREL_HI20
4826 -- : BFD_RELOC_NDS32_PLTREL_LO12
4827 -- : BFD_RELOC_NDS32_PLT_GOTREL_HI20
4828 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO12
4829     for PIC
4830 -- : BFD_RELOC_NDS32_SDA12S2_DP
4831 -- : BFD_RELOC_NDS32_SDA12S2_SP
4832 -- : BFD_RELOC_NDS32_LO12S2_DP
4833 -- : BFD_RELOC_NDS32_LO12S2_SP
4834     for floating point
4835 -- : BFD_RELOC_NDS32_DWARF2_OP1
4836 -- : BFD_RELOC_NDS32_DWARF2_OP2
4837 -- : BFD_RELOC_NDS32_DWARF2_LEB
4838     for dwarf2 debug_line.
4839 -- : BFD_RELOC_NDS32_UPDATE_TA
4840     for eliminate 16-bit instructions
4841 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO20
4842 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO15
4843 -- : BFD_RELOC_NDS32_PLT_GOTREL_LO19
4844 -- : BFD_RELOC_NDS32_GOT_LO15
4845 -- : BFD_RELOC_NDS32_GOT_LO19
4846 -- : BFD_RELOC_NDS32_GOTOFF_LO15
4847 -- : BFD_RELOC_NDS32_GOTOFF_LO19
4848 -- : BFD_RELOC_NDS32_GOT15S2
4849 -- : BFD_RELOC_NDS32_GOT17S2
4850     for PIC object relaxation
4851 -- : BFD_RELOC_NDS32_5
4852     NDS32 relocs.  This is a 5 bit absolute address.
4853 -- : BFD_RELOC_NDS32_10_UPCREL
4854     This is a 10-bit unsigned pc-relative reloc with the right 1 bit
4855     assumed to be 0.
4856 -- : BFD_RELOC_NDS32_SDA_FP7U2_RELA
4857     If fp were omitted, fp can used as another gp.
4858 -- : BFD_RELOC_NDS32_RELAX_ENTRY
4859 -- : BFD_RELOC_NDS32_GOT_SUFF
4860 -- : BFD_RELOC_NDS32_GOTOFF_SUFF
4861 -- : BFD_RELOC_NDS32_PLT_GOT_SUFF
4862 -- : BFD_RELOC_NDS32_MULCALL_SUFF
4863 -- : BFD_RELOC_NDS32_PTR
4864 -- : BFD_RELOC_NDS32_PTR_COUNT
4865 -- : BFD_RELOC_NDS32_PTR_RESOLVED
4866 -- : BFD_RELOC_NDS32_PLTBLOCK
4867 -- : BFD_RELOC_NDS32_RELAX_REGION_BEGIN
4868 -- : BFD_RELOC_NDS32_RELAX_REGION_END
4869 -- : BFD_RELOC_NDS32_MINUEND
4870 -- : BFD_RELOC_NDS32_SUBTRAHEND
4871 -- : BFD_RELOC_NDS32_DIFF8
4872 -- : BFD_RELOC_NDS32_DIFF16
4873 -- : BFD_RELOC_NDS32_DIFF32
4874 -- : BFD_RELOC_NDS32_DIFF_ULEB128
4875 -- : BFD_RELOC_NDS32_EMPTY
4876     relaxation relative relocation types
4877 -- : BFD_RELOC_NDS32_25_ABS
4878     This is a 25 bit absolute address.
4879 -- : BFD_RELOC_NDS32_DATA
4880 -- : BFD_RELOC_NDS32_TRAN
4881 -- : BFD_RELOC_NDS32_17IFC_PCREL
4882 -- : BFD_RELOC_NDS32_10IFCU_PCREL
4883     For ex9 and ifc using.
4884 -- : BFD_RELOC_NDS32_TPOFF
4885 -- : BFD_RELOC_NDS32_TLS_LE_HI20
4886 -- : BFD_RELOC_NDS32_TLS_LE_LO12
4887 -- : BFD_RELOC_NDS32_TLS_LE_ADD
4888 -- : BFD_RELOC_NDS32_TLS_LE_LS
4889 -- : BFD_RELOC_NDS32_GOTTPOFF
4890 -- : BFD_RELOC_NDS32_TLS_IE_HI20
4891 -- : BFD_RELOC_NDS32_TLS_IE_LO12S2
4892 -- : BFD_RELOC_NDS32_TLS_TPOFF
4893 -- : BFD_RELOC_NDS32_TLS_LE_20
4894 -- : BFD_RELOC_NDS32_TLS_LE_15S0
4895 -- : BFD_RELOC_NDS32_TLS_LE_15S1
4896 -- : BFD_RELOC_NDS32_TLS_LE_15S2
4897     For TLS.
4898 -- : BFD_RELOC_V850_9_PCREL
4899     This is a 9-bit reloc
4900 -- : BFD_RELOC_V850_22_PCREL
4901     This is a 22-bit reloc
4902 -- : BFD_RELOC_V850_SDA_16_16_OFFSET
4903     This is a 16 bit offset from the short data area pointer.
4904 -- : BFD_RELOC_V850_SDA_15_16_OFFSET
4905     This is a 16 bit offset (of which only 15 bits are used) from the
4906     short data area pointer.
4907 -- : BFD_RELOC_V850_ZDA_16_16_OFFSET
4908     This is a 16 bit offset from the zero data area pointer.
4909 -- : BFD_RELOC_V850_ZDA_15_16_OFFSET
4910     This is a 16 bit offset (of which only 15 bits are used) from the
4911     zero data area pointer.
4912 -- : BFD_RELOC_V850_TDA_6_8_OFFSET
4913     This is an 8 bit offset (of which only 6 bits are used) from the
4914     tiny data area pointer.
4915 -- : BFD_RELOC_V850_TDA_7_8_OFFSET
4916     This is an 8bit offset (of which only 7 bits are used) from the
4917     tiny data area pointer.
4918 -- : BFD_RELOC_V850_TDA_7_7_OFFSET
4919     This is a 7 bit offset from the tiny data area pointer.
4920 -- : BFD_RELOC_V850_TDA_16_16_OFFSET
4921     This is a 16 bit offset from the tiny data area pointer.
4922 -- : BFD_RELOC_V850_TDA_4_5_OFFSET
4923     This is a 5 bit offset (of which only 4 bits are used) from the
4924     tiny data area pointer.
4925 -- : BFD_RELOC_V850_TDA_4_4_OFFSET
4926     This is a 4 bit offset from the tiny data area pointer.
4927 -- : BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET
4928     This is a 16 bit offset from the short data area pointer, with the
4929     bits placed non-contiguously in the instruction.
4930 -- : BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET
4931     This is a 16 bit offset from the zero data area pointer, with the
4932     bits placed non-contiguously in the instruction.
4933 -- : BFD_RELOC_V850_CALLT_6_7_OFFSET
4934     This is a 6 bit offset from the call table base pointer.
4935 -- : BFD_RELOC_V850_CALLT_16_16_OFFSET
4936     This is a 16 bit offset from the call table base pointer.
4937 -- : BFD_RELOC_V850_LONGCALL
4938     Used for relaxing indirect function calls.
4939 -- : BFD_RELOC_V850_LONGJUMP
4940     Used for relaxing indirect jumps.
4941 -- : BFD_RELOC_V850_ALIGN
4942     Used to maintain alignment whilst relaxing.
4943 -- : BFD_RELOC_V850_LO16_SPLIT_OFFSET
4944     This is a variation of BFD_RELOC_LO16 that can be used in v850e
4945     ld.bu instructions.
4946 -- : BFD_RELOC_V850_16_PCREL
4947     This is a 16-bit reloc.
4948 -- : BFD_RELOC_V850_17_PCREL
4949     This is a 17-bit reloc.
4950 -- : BFD_RELOC_V850_23
4951     This is a 23-bit reloc.
4952 -- : BFD_RELOC_V850_32_PCREL
4953     This is a 32-bit reloc.
4954 -- : BFD_RELOC_V850_32_ABS
4955     This is a 32-bit reloc.
4956 -- : BFD_RELOC_V850_16_SPLIT_OFFSET
4957     This is a 16-bit reloc.
4958 -- : BFD_RELOC_V850_16_S1
4959     This is a 16-bit reloc.
4960 -- : BFD_RELOC_V850_LO16_S1
4961     Low 16 bits.  16 bit shifted by 1.
4962 -- : BFD_RELOC_V850_CALLT_15_16_OFFSET
4963     This is a 16 bit offset from the call table base pointer.
4964 -- : BFD_RELOC_V850_32_GOTPCREL
4965     DSO relocations.
4966 -- : BFD_RELOC_V850_16_GOT
4967     DSO relocations.
4968 -- : BFD_RELOC_V850_32_GOT
4969     DSO relocations.
4970 -- : BFD_RELOC_V850_22_PLT_PCREL
4971     DSO relocations.
4972 -- : BFD_RELOC_V850_32_PLT_PCREL
4973     DSO relocations.
4974 -- : BFD_RELOC_V850_COPY
4975     DSO relocations.
4976 -- : BFD_RELOC_V850_GLOB_DAT
4977     DSO relocations.
4978 -- : BFD_RELOC_V850_JMP_SLOT
4979     DSO relocations.
4980 -- : BFD_RELOC_V850_RELATIVE
4981     DSO relocations.
4982 -- : BFD_RELOC_V850_16_GOTOFF
4983     DSO relocations.
4984 -- : BFD_RELOC_V850_32_GOTOFF
4985     DSO relocations.
4986 -- : BFD_RELOC_V850_CODE
4987     start code.
4988 -- : BFD_RELOC_V850_DATA
4989     start data in text.
4990 -- : BFD_RELOC_TIC30_LDP
4991     This is a 8bit DP reloc for the tms320c30, where the most
4992     significant 8 bits of a 24 bit word are placed into the least
4993     significant 8 bits of the opcode.
4994 -- : BFD_RELOC_TIC54X_PARTLS7
4995     This is a 7bit reloc for the tms320c54x, where the least
4996     significant 7 bits of a 16 bit word are placed into the least
4997     significant 7 bits of the opcode.
4998 -- : BFD_RELOC_TIC54X_PARTMS9
4999     This is a 9bit DP reloc for the tms320c54x, where the most
5000     significant 9 bits of a 16 bit word are placed into the least
5001     significant 9 bits of the opcode.
5002 -- : BFD_RELOC_TIC54X_23
5003     This is an extended address 23-bit reloc for the tms320c54x.
5004 -- : BFD_RELOC_TIC54X_16_OF_23
5005     This is a 16-bit reloc for the tms320c54x, where the least
5006     significant 16 bits of a 23-bit extended address are placed into
5007     the opcode.
5008 -- : BFD_RELOC_TIC54X_MS7_OF_23
5009     This is a reloc for the tms320c54x, where the most significant 7
5010     bits of a 23-bit extended address are placed into the opcode.
5011 -- : BFD_RELOC_C6000_PCR_S21
5012 -- : BFD_RELOC_C6000_PCR_S12
5013 -- : BFD_RELOC_C6000_PCR_S10
5014 -- : BFD_RELOC_C6000_PCR_S7
5015 -- : BFD_RELOC_C6000_ABS_S16
5016 -- : BFD_RELOC_C6000_ABS_L16
5017 -- : BFD_RELOC_C6000_ABS_H16
5018 -- : BFD_RELOC_C6000_SBR_U15_B
5019 -- : BFD_RELOC_C6000_SBR_U15_H
5020 -- : BFD_RELOC_C6000_SBR_U15_W
5021 -- : BFD_RELOC_C6000_SBR_S16
5022 -- : BFD_RELOC_C6000_SBR_L16_B
5023 -- : BFD_RELOC_C6000_SBR_L16_H
5024 -- : BFD_RELOC_C6000_SBR_L16_W
5025 -- : BFD_RELOC_C6000_SBR_H16_B
5026 -- : BFD_RELOC_C6000_SBR_H16_H
5027 -- : BFD_RELOC_C6000_SBR_H16_W
5028 -- : BFD_RELOC_C6000_SBR_GOT_U15_W
5029 -- : BFD_RELOC_C6000_SBR_GOT_L16_W
5030 -- : BFD_RELOC_C6000_SBR_GOT_H16_W
5031 -- : BFD_RELOC_C6000_DSBT_INDEX
5032 -- : BFD_RELOC_C6000_PREL31
5033 -- : BFD_RELOC_C6000_COPY
5034 -- : BFD_RELOC_C6000_JUMP_SLOT
5035 -- : BFD_RELOC_C6000_EHTYPE
5036 -- : BFD_RELOC_C6000_PCR_H16
5037 -- : BFD_RELOC_C6000_PCR_L16
5038 -- : BFD_RELOC_C6000_ALIGN
5039 -- : BFD_RELOC_C6000_FPHEAD
5040 -- : BFD_RELOC_C6000_NOCMP
5041     TMS320C6000 relocations.
5042 -- : BFD_RELOC_FR30_48
5043     This is a 48 bit reloc for the FR30 that stores 32 bits.
5044 -- : BFD_RELOC_FR30_20
5045     This is a 32 bit reloc for the FR30 that stores 20 bits split up
5046     into two sections.
5047 -- : BFD_RELOC_FR30_6_IN_4
5048     This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
5049     in 4 bits.
5050 -- : BFD_RELOC_FR30_8_IN_8
5051     This is a 16 bit reloc for the FR30 that stores an 8 bit byte
5052     offset into 8 bits.
5053 -- : BFD_RELOC_FR30_9_IN_8
5054     This is a 16 bit reloc for the FR30 that stores a 9 bit short
5055     offset into 8 bits.
5056 -- : BFD_RELOC_FR30_10_IN_8
5057     This is a 16 bit reloc for the FR30 that stores a 10 bit word
5058     offset into 8 bits.
5059 -- : BFD_RELOC_FR30_9_PCREL
5060     This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
5061     short offset into 8 bits.
5062 -- : BFD_RELOC_FR30_12_PCREL
5063     This is a 16 bit reloc for the FR30 that stores a 12 bit pc
5064     relative short offset into 11 bits.
5065 -- : BFD_RELOC_MCORE_PCREL_IMM8BY4
5066 -- : BFD_RELOC_MCORE_PCREL_IMM11BY2
5067 -- : BFD_RELOC_MCORE_PCREL_IMM4BY2
5068 -- : BFD_RELOC_MCORE_PCREL_32
5069 -- : BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2
5070 -- : BFD_RELOC_MCORE_RVA
5071     Motorola Mcore relocations.
5072 -- : BFD_RELOC_MEP_8
5073 -- : BFD_RELOC_MEP_16
5074 -- : BFD_RELOC_MEP_32
5075 -- : BFD_RELOC_MEP_PCREL8A2
5076 -- : BFD_RELOC_MEP_PCREL12A2
5077 -- : BFD_RELOC_MEP_PCREL17A2
5078 -- : BFD_RELOC_MEP_PCREL24A2
5079 -- : BFD_RELOC_MEP_PCABS24A2
5080 -- : BFD_RELOC_MEP_LOW16
5081 -- : BFD_RELOC_MEP_HI16U
5082 -- : BFD_RELOC_MEP_HI16S
5083 -- : BFD_RELOC_MEP_GPREL
5084 -- : BFD_RELOC_MEP_TPREL
5085 -- : BFD_RELOC_MEP_TPREL7
5086 -- : BFD_RELOC_MEP_TPREL7A2
5087 -- : BFD_RELOC_MEP_TPREL7A4
5088 -- : BFD_RELOC_MEP_UIMM24
5089 -- : BFD_RELOC_MEP_ADDR24A4
5090 -- : BFD_RELOC_MEP_GNU_VTINHERIT
5091 -- : BFD_RELOC_MEP_GNU_VTENTRY
5092     Toshiba Media Processor Relocations.
5093 -- : BFD_RELOC_METAG_HIADDR16
5094 -- : BFD_RELOC_METAG_LOADDR16
5095 -- : BFD_RELOC_METAG_RELBRANCH
5096 -- : BFD_RELOC_METAG_GETSETOFF
5097 -- : BFD_RELOC_METAG_HIOG
5098 -- : BFD_RELOC_METAG_LOOG
5099 -- : BFD_RELOC_METAG_REL8
5100 -- : BFD_RELOC_METAG_REL16
5101 -- : BFD_RELOC_METAG_HI16_GOTOFF
5102 -- : BFD_RELOC_METAG_LO16_GOTOFF
5103 -- : BFD_RELOC_METAG_GETSET_GOTOFF
5104 -- : BFD_RELOC_METAG_GETSET_GOT
5105 -- : BFD_RELOC_METAG_HI16_GOTPC
5106 -- : BFD_RELOC_METAG_LO16_GOTPC
5107 -- : BFD_RELOC_METAG_HI16_PLT
5108 -- : BFD_RELOC_METAG_LO16_PLT
5109 -- : BFD_RELOC_METAG_RELBRANCH_PLT
5110 -- : BFD_RELOC_METAG_GOTOFF
5111 -- : BFD_RELOC_METAG_PLT
5112 -- : BFD_RELOC_METAG_COPY
5113 -- : BFD_RELOC_METAG_JMP_SLOT
5114 -- : BFD_RELOC_METAG_RELATIVE
5115 -- : BFD_RELOC_METAG_GLOB_DAT
5116 -- : BFD_RELOC_METAG_TLS_GD
5117 -- : BFD_RELOC_METAG_TLS_LDM
5118 -- : BFD_RELOC_METAG_TLS_LDO_HI16
5119 -- : BFD_RELOC_METAG_TLS_LDO_LO16
5120 -- : BFD_RELOC_METAG_TLS_LDO
5121 -- : BFD_RELOC_METAG_TLS_IE
5122 -- : BFD_RELOC_METAG_TLS_IENONPIC
5123 -- : BFD_RELOC_METAG_TLS_IENONPIC_HI16
5124 -- : BFD_RELOC_METAG_TLS_IENONPIC_LO16
5125 -- : BFD_RELOC_METAG_TLS_TPOFF
5126 -- : BFD_RELOC_METAG_TLS_DTPMOD
5127 -- : BFD_RELOC_METAG_TLS_DTPOFF
5128 -- : BFD_RELOC_METAG_TLS_LE
5129 -- : BFD_RELOC_METAG_TLS_LE_HI16
5130 -- : BFD_RELOC_METAG_TLS_LE_LO16
5131     Imagination Technologies Meta relocations.
5132 -- : BFD_RELOC_MMIX_GETA
5133 -- : BFD_RELOC_MMIX_GETA_1
5134 -- : BFD_RELOC_MMIX_GETA_2
5135 -- : BFD_RELOC_MMIX_GETA_3
5136     These are relocations for the GETA instruction.
5137 -- : BFD_RELOC_MMIX_CBRANCH
5138 -- : BFD_RELOC_MMIX_CBRANCH_J
5139 -- : BFD_RELOC_MMIX_CBRANCH_1
5140 -- : BFD_RELOC_MMIX_CBRANCH_2
5141 -- : BFD_RELOC_MMIX_CBRANCH_3
5142     These are relocations for a conditional branch instruction.
5143 -- : BFD_RELOC_MMIX_PUSHJ
5144 -- : BFD_RELOC_MMIX_PUSHJ_1
5145 -- : BFD_RELOC_MMIX_PUSHJ_2
5146 -- : BFD_RELOC_MMIX_PUSHJ_3
5147 -- : BFD_RELOC_MMIX_PUSHJ_STUBBABLE
5148     These are relocations for the PUSHJ instruction.
5149 -- : BFD_RELOC_MMIX_JMP
5150 -- : BFD_RELOC_MMIX_JMP_1
5151 -- : BFD_RELOC_MMIX_JMP_2
5152 -- : BFD_RELOC_MMIX_JMP_3
5153     These are relocations for the JMP instruction.
5154 -- : BFD_RELOC_MMIX_ADDR19
5155     This is a relocation for a relative address as in a GETA
5156     instruction or a branch.
5157 -- : BFD_RELOC_MMIX_ADDR27
5158     This is a relocation for a relative address as in a JMP
5159     instruction.
5160 -- : BFD_RELOC_MMIX_REG_OR_BYTE
5161     This is a relocation for an instruction field that may be a general
5162     register or a value 0..255.
5163 -- : BFD_RELOC_MMIX_REG
5164     This is a relocation for an instruction field that may be a general
5165     register.
5166 -- : BFD_RELOC_MMIX_BASE_PLUS_OFFSET
5167     This is a relocation for two instruction fields holding a register
5168     and an offset, the equivalent of the relocation.
5169 -- : BFD_RELOC_MMIX_LOCAL
5170     This relocation is an assertion that the expression is not
5171     allocated as a global register.  It does not modify contents.
5172 -- : BFD_RELOC_AVR_7_PCREL
5173     This is a 16 bit reloc for the AVR that stores 8 bit pc relative
5174     short offset into 7 bits.
5175 -- : BFD_RELOC_AVR_13_PCREL
5176     This is a 16 bit reloc for the AVR that stores 13 bit pc relative
5177     short offset into 12 bits.
5178 -- : BFD_RELOC_AVR_16_PM
5179     This is a 16 bit reloc for the AVR that stores 17 bit value
5180     (usually program memory address) into 16 bits.
5181 -- : BFD_RELOC_AVR_LO8_LDI
5182     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5183     data memory address) into 8 bit immediate value of LDI insn.
5184 -- : BFD_RELOC_AVR_HI8_LDI
5185     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5186     bit of data memory address) into 8 bit immediate value of LDI insn.
5187 -- : BFD_RELOC_AVR_HH8_LDI
5188     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5189     high 8 bit of program memory address) into 8 bit immediate value of
5190     LDI insn.
5191 -- : BFD_RELOC_AVR_MS8_LDI
5192     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5193     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.
5194 -- : BFD_RELOC_AVR_LO8_LDI_NEG
5195     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5196     (usually data memory address) into 8 bit immediate value of SUBI
5197     insn.
5198 -- : BFD_RELOC_AVR_HI8_LDI_NEG
5199     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5200     (high 8 bit of data memory address) into 8 bit immediate value of
5201     SUBI insn.
5202 -- : BFD_RELOC_AVR_HH8_LDI_NEG
5203     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5204     (most high 8 bit of program memory address) into 8 bit immediate
5205     value of LDI or SUBI insn.
5206 -- : BFD_RELOC_AVR_MS8_LDI_NEG
5207     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5208     (msb of 32 bit value) into 8 bit immediate value of LDI insn.
5209 -- : BFD_RELOC_AVR_LO8_LDI_PM
5210     This is a 16 bit reloc for the AVR that stores 8 bit value (usually
5211     command address) into 8 bit immediate value of LDI insn.
5212 -- : BFD_RELOC_AVR_LO8_LDI_GS
5213     This is a 16 bit reloc for the AVR that stores 8 bit value (command
5214     address) into 8 bit immediate value of LDI insn.  If the address is
5215     beyond the 128k boundary, the linker inserts a jump stub for this
5216     reloc in the lower 128k.
5217 -- : BFD_RELOC_AVR_HI8_LDI_PM
5218     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5219     bit of command address) into 8 bit immediate value of LDI insn.
5220 -- : BFD_RELOC_AVR_HI8_LDI_GS
5221     This is a 16 bit reloc for the AVR that stores 8 bit value (high 8
5222     bit of command address) into 8 bit immediate value of LDI insn.  If
5223     the address is beyond the 128k boundary, the linker inserts a jump
5224     stub for this reloc below 128k.
5225 -- : BFD_RELOC_AVR_HH8_LDI_PM
5226     This is a 16 bit reloc for the AVR that stores 8 bit value (most
5227     high 8 bit of command address) into 8 bit immediate value of LDI
5228     insn.
5229 -- : BFD_RELOC_AVR_LO8_LDI_PM_NEG
5230     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5231     (usually command address) into 8 bit immediate value of SUBI insn.
5232 -- : BFD_RELOC_AVR_HI8_LDI_PM_NEG
5233     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5234     (high 8 bit of 16 bit command address) into 8 bit immediate value
5235     of SUBI insn.
5236 -- : BFD_RELOC_AVR_HH8_LDI_PM_NEG
5237     This is a 16 bit reloc for the AVR that stores negated 8 bit value
5238     (high 6 bit of 22 bit command address) into 8 bit immediate value
5239     of SUBI insn.
5240 -- : BFD_RELOC_AVR_CALL
5241     This is a 32 bit reloc for the AVR that stores 23 bit value into 22
5242     bits.
5243 -- : BFD_RELOC_AVR_LDI
5244     This is a 16 bit reloc for the AVR that stores all needed bits for
5245     absolute addressing with ldi with overflow check to linktime
5246 -- : BFD_RELOC_AVR_6
5247     This is a 6 bit reloc for the AVR that stores offset for ldd/std
5248     instructions
5249 -- : BFD_RELOC_AVR_6_ADIW
5250     This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
5251     instructions
5252 -- : BFD_RELOC_AVR_8_LO
5253     This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
5254     in .byte lo8(symbol)
5255 -- : BFD_RELOC_AVR_8_HI
5256     This is a 8 bit reloc for the AVR that stores bits 8..15 of a
5257     symbol in .byte hi8(symbol)
5258 -- : BFD_RELOC_AVR_8_HLO
5259     This is a 8 bit reloc for the AVR that stores bits 16..23 of a
5260     symbol in .byte hlo8(symbol)
5261 -- : BFD_RELOC_AVR_DIFF8
5262 -- : BFD_RELOC_AVR_DIFF16
5263 -- : BFD_RELOC_AVR_DIFF32
5264     AVR relocations to mark the difference of two local symbols.  These
5265     are only needed to support linker relaxation and can be ignored
5266     when not relaxing.  The field is set to the value of the difference
5267     assuming no relaxation.  The relocation encodes the position of the
5268     second symbol so the linker can determine whether to adjust the
5269     field value.
5270 -- : BFD_RELOC_AVR_LDS_STS_16
5271     This is a 7 bit reloc for the AVR that stores SRAM address for
5272     16bit lds and sts instructions supported only tiny core.
5273 -- : BFD_RELOC_AVR_PORT6
5274     This is a 6 bit reloc for the AVR that stores an I/O register
5275     number for the IN and OUT instructions
5276 -- : BFD_RELOC_AVR_PORT5
5277     This is a 5 bit reloc for the AVR that stores an I/O register
5278     number for the SBIC, SBIS, SBI and CBI instructions
5279 -- : BFD_RELOC_RISCV_HI20
5280 -- : BFD_RELOC_RISCV_PCREL_HI20
5281 -- : BFD_RELOC_RISCV_PCREL_LO12_I
5282 -- : BFD_RELOC_RISCV_PCREL_LO12_S
5283 -- : BFD_RELOC_RISCV_LO12_I
5284 -- : BFD_RELOC_RISCV_LO12_S
5285 -- : BFD_RELOC_RISCV_GPREL12_I
5286 -- : BFD_RELOC_RISCV_GPREL12_S
5287 -- : BFD_RELOC_RISCV_TPREL_HI20
5288 -- : BFD_RELOC_RISCV_TPREL_LO12_I
5289 -- : BFD_RELOC_RISCV_TPREL_LO12_S
5290 -- : BFD_RELOC_RISCV_TPREL_ADD
5291 -- : BFD_RELOC_RISCV_CALL
5292 -- : BFD_RELOC_RISCV_CALL_PLT
5293 -- : BFD_RELOC_RISCV_ADD8
5294 -- : BFD_RELOC_RISCV_ADD16
5295 -- : BFD_RELOC_RISCV_ADD32
5296 -- : BFD_RELOC_RISCV_ADD64
5297 -- : BFD_RELOC_RISCV_SUB8
5298 -- : BFD_RELOC_RISCV_SUB16
5299 -- : BFD_RELOC_RISCV_SUB32
5300 -- : BFD_RELOC_RISCV_SUB64
5301 -- : BFD_RELOC_RISCV_GOT_HI20
5302 -- : BFD_RELOC_RISCV_TLS_GOT_HI20
5303 -- : BFD_RELOC_RISCV_TLS_GD_HI20
5304 -- : BFD_RELOC_RISCV_JMP
5305 -- : BFD_RELOC_RISCV_TLS_DTPMOD32
5306 -- : BFD_RELOC_RISCV_TLS_DTPREL32
5307 -- : BFD_RELOC_RISCV_TLS_DTPMOD64
5308 -- : BFD_RELOC_RISCV_TLS_DTPREL64
5309 -- : BFD_RELOC_RISCV_TLS_TPREL32
5310 -- : BFD_RELOC_RISCV_TLS_TPREL64
5311 -- : BFD_RELOC_RISCV_ALIGN
5312 -- : BFD_RELOC_RISCV_RVC_BRANCH
5313 -- : BFD_RELOC_RISCV_RVC_JUMP
5314 -- : BFD_RELOC_RISCV_RVC_LUI
5315 -- : BFD_RELOC_RISCV_GPREL_I
5316 -- : BFD_RELOC_RISCV_GPREL_S
5317 -- : BFD_RELOC_RISCV_TPREL_I
5318 -- : BFD_RELOC_RISCV_TPREL_S
5319 -- : BFD_RELOC_RISCV_RELAX
5320 -- : BFD_RELOC_RISCV_CFA
5321 -- : BFD_RELOC_RISCV_SUB6
5322 -- : BFD_RELOC_RISCV_SET6
5323 -- : BFD_RELOC_RISCV_SET8
5324 -- : BFD_RELOC_RISCV_SET16
5325 -- : BFD_RELOC_RISCV_SET32
5326 -- : BFD_RELOC_RISCV_32_PCREL
5327     RISC-V relocations.
5328 -- : BFD_RELOC_RL78_NEG8
5329 -- : BFD_RELOC_RL78_NEG16
5330 -- : BFD_RELOC_RL78_NEG24
5331 -- : BFD_RELOC_RL78_NEG32
5332 -- : BFD_RELOC_RL78_16_OP
5333 -- : BFD_RELOC_RL78_24_OP
5334 -- : BFD_RELOC_RL78_32_OP
5335 -- : BFD_RELOC_RL78_8U
5336 -- : BFD_RELOC_RL78_16U
5337 -- : BFD_RELOC_RL78_24U
5338 -- : BFD_RELOC_RL78_DIR3U_PCREL
5339 -- : BFD_RELOC_RL78_DIFF
5340 -- : BFD_RELOC_RL78_GPRELB
5341 -- : BFD_RELOC_RL78_GPRELW
5342 -- : BFD_RELOC_RL78_GPRELL
5343 -- : BFD_RELOC_RL78_SYM
5344 -- : BFD_RELOC_RL78_OP_SUBTRACT
5345 -- : BFD_RELOC_RL78_OP_NEG
5346 -- : BFD_RELOC_RL78_OP_AND
5347 -- : BFD_RELOC_RL78_OP_SHRA
5348 -- : BFD_RELOC_RL78_ABS8
5349 -- : BFD_RELOC_RL78_ABS16
5350 -- : BFD_RELOC_RL78_ABS16_REV
5351 -- : BFD_RELOC_RL78_ABS32
5352 -- : BFD_RELOC_RL78_ABS32_REV
5353 -- : BFD_RELOC_RL78_ABS16U
5354 -- : BFD_RELOC_RL78_ABS16UW
5355 -- : BFD_RELOC_RL78_ABS16UL
5356 -- : BFD_RELOC_RL78_RELAX
5357 -- : BFD_RELOC_RL78_HI16
5358 -- : BFD_RELOC_RL78_HI8
5359 -- : BFD_RELOC_RL78_LO16
5360 -- : BFD_RELOC_RL78_CODE
5361 -- : BFD_RELOC_RL78_SADDR
5362     Renesas RL78 Relocations.
5363 -- : BFD_RELOC_RX_NEG8
5364 -- : BFD_RELOC_RX_NEG16
5365 -- : BFD_RELOC_RX_NEG24
5366 -- : BFD_RELOC_RX_NEG32
5367 -- : BFD_RELOC_RX_16_OP
5368 -- : BFD_RELOC_RX_24_OP
5369 -- : BFD_RELOC_RX_32_OP
5370 -- : BFD_RELOC_RX_8U
5371 -- : BFD_RELOC_RX_16U
5372 -- : BFD_RELOC_RX_24U
5373 -- : BFD_RELOC_RX_DIR3U_PCREL
5374 -- : BFD_RELOC_RX_DIFF
5375 -- : BFD_RELOC_RX_GPRELB
5376 -- : BFD_RELOC_RX_GPRELW
5377 -- : BFD_RELOC_RX_GPRELL
5378 -- : BFD_RELOC_RX_SYM
5379 -- : BFD_RELOC_RX_OP_SUBTRACT
5380 -- : BFD_RELOC_RX_OP_NEG
5381 -- : BFD_RELOC_RX_ABS8
5382 -- : BFD_RELOC_RX_ABS16
5383 -- : BFD_RELOC_RX_ABS16_REV
5384 -- : BFD_RELOC_RX_ABS32
5385 -- : BFD_RELOC_RX_ABS32_REV
5386 -- : BFD_RELOC_RX_ABS16U
5387 -- : BFD_RELOC_RX_ABS16UW
5388 -- : BFD_RELOC_RX_ABS16UL
5389 -- : BFD_RELOC_RX_RELAX
5390     Renesas RX Relocations.
5391 -- : BFD_RELOC_390_12
5392     Direct 12 bit.
5393 -- : BFD_RELOC_390_GOT12
5394     12 bit GOT offset.
5395 -- : BFD_RELOC_390_PLT32
5396     32 bit PC relative PLT address.
5397 -- : BFD_RELOC_390_COPY
5398     Copy symbol at runtime.
5399 -- : BFD_RELOC_390_GLOB_DAT
5400     Create GOT entry.
5401 -- : BFD_RELOC_390_JMP_SLOT
5402     Create PLT entry.
5403 -- : BFD_RELOC_390_RELATIVE
5404     Adjust by program base.
5405 -- : BFD_RELOC_390_GOTPC
5406     32 bit PC relative offset to GOT.
5407 -- : BFD_RELOC_390_GOT16
5408     16 bit GOT offset.
5409 -- : BFD_RELOC_390_PC12DBL
5410     PC relative 12 bit shifted by 1.
5411 -- : BFD_RELOC_390_PLT12DBL
5412     12 bit PC rel.  PLT shifted by 1.
5413 -- : BFD_RELOC_390_PC16DBL
5414     PC relative 16 bit shifted by 1.
5415 -- : BFD_RELOC_390_PLT16DBL
5416     16 bit PC rel.  PLT shifted by 1.
5417 -- : BFD_RELOC_390_PC24DBL
5418     PC relative 24 bit shifted by 1.
5419 -- : BFD_RELOC_390_PLT24DBL
5420     24 bit PC rel.  PLT shifted by 1.
5421 -- : BFD_RELOC_390_PC32DBL
5422     PC relative 32 bit shifted by 1.
5423 -- : BFD_RELOC_390_PLT32DBL
5424     32 bit PC rel.  PLT shifted by 1.
5425 -- : BFD_RELOC_390_GOTPCDBL
5426     32 bit PC rel.  GOT shifted by 1.
5427 -- : BFD_RELOC_390_GOT64
5428     64 bit GOT offset.
5429 -- : BFD_RELOC_390_PLT64
5430     64 bit PC relative PLT address.
5431 -- : BFD_RELOC_390_GOTENT
5432     32 bit rel.  offset to GOT entry.
5433 -- : BFD_RELOC_390_GOTOFF64
5434     64 bit offset to GOT.
5435 -- : BFD_RELOC_390_GOTPLT12
5436     12-bit offset to symbol-entry within GOT, with PLT handling.
5437 -- : BFD_RELOC_390_GOTPLT16
5438     16-bit offset to symbol-entry within GOT, with PLT handling.
5439 -- : BFD_RELOC_390_GOTPLT32
5440     32-bit offset to symbol-entry within GOT, with PLT handling.
5441 -- : BFD_RELOC_390_GOTPLT64
5442     64-bit offset to symbol-entry within GOT, with PLT handling.
5443 -- : BFD_RELOC_390_GOTPLTENT
5444     32-bit rel.  offset to symbol-entry within GOT, with PLT handling.
5445 -- : BFD_RELOC_390_PLTOFF16
5446     16-bit rel.  offset from the GOT to a PLT entry.
5447 -- : BFD_RELOC_390_PLTOFF32
5448     32-bit rel.  offset from the GOT to a PLT entry.
5449 -- : BFD_RELOC_390_PLTOFF64
5450     64-bit rel.  offset from the GOT to a PLT entry.
5451 -- : BFD_RELOC_390_TLS_LOAD
5452 -- : BFD_RELOC_390_TLS_GDCALL
5453 -- : BFD_RELOC_390_TLS_LDCALL
5454 -- : BFD_RELOC_390_TLS_GD32
5455 -- : BFD_RELOC_390_TLS_GD64
5456 -- : BFD_RELOC_390_TLS_GOTIE12
5457 -- : BFD_RELOC_390_TLS_GOTIE32
5458 -- : BFD_RELOC_390_TLS_GOTIE64
5459 -- : BFD_RELOC_390_TLS_LDM32
5460 -- : BFD_RELOC_390_TLS_LDM64
5461 -- : BFD_RELOC_390_TLS_IE32
5462 -- : BFD_RELOC_390_TLS_IE64
5463 -- : BFD_RELOC_390_TLS_IEENT
5464 -- : BFD_RELOC_390_TLS_LE32
5465 -- : BFD_RELOC_390_TLS_LE64
5466 -- : BFD_RELOC_390_TLS_LDO32
5467 -- : BFD_RELOC_390_TLS_LDO64
5468 -- : BFD_RELOC_390_TLS_DTPMOD
5469 -- : BFD_RELOC_390_TLS_DTPOFF
5470 -- : BFD_RELOC_390_TLS_TPOFF
5471     s390 tls relocations.
5472 -- : BFD_RELOC_390_20
5473 -- : BFD_RELOC_390_GOT20
5474 -- : BFD_RELOC_390_GOTPLT20
5475 -- : BFD_RELOC_390_TLS_GOTIE20
5476     Long displacement extension.
5477 -- : BFD_RELOC_390_IRELATIVE
5478     STT_GNU_IFUNC relocation.
5479 -- : BFD_RELOC_SCORE_GPREL15
5480     Score relocations Low 16 bit for load/store
5481 -- : BFD_RELOC_SCORE_DUMMY2
5482 -- : BFD_RELOC_SCORE_JMP
5483     This is a 24-bit reloc with the right 1 bit assumed to be 0
5484 -- : BFD_RELOC_SCORE_BRANCH
5485     This is a 19-bit reloc with the right 1 bit assumed to be 0
5486 -- : BFD_RELOC_SCORE_IMM30
5487     This is a 32-bit reloc for 48-bit instructions.
5488 -- : BFD_RELOC_SCORE_IMM32
5489     This is a 32-bit reloc for 48-bit instructions.
5490 -- : BFD_RELOC_SCORE16_JMP
5491     This is a 11-bit reloc with the right 1 bit assumed to be 0
5492 -- : BFD_RELOC_SCORE16_BRANCH
5493     This is a 8-bit reloc with the right 1 bit assumed to be 0
5494 -- : BFD_RELOC_SCORE_BCMP
5495     This is a 9-bit reloc with the right 1 bit assumed to be 0
5496 -- : BFD_RELOC_SCORE_GOT15
5497 -- : BFD_RELOC_SCORE_GOT_LO16
5498 -- : BFD_RELOC_SCORE_CALL15
5499 -- : BFD_RELOC_SCORE_DUMMY_HI16
5500     Undocumented Score relocs
5501 -- : BFD_RELOC_IP2K_FR9
5502     Scenix IP2K - 9-bit register number / data address
5503 -- : BFD_RELOC_IP2K_BANK
5504     Scenix IP2K - 4-bit register/data bank number
5505 -- : BFD_RELOC_IP2K_ADDR16CJP
5506     Scenix IP2K - low 13 bits of instruction word address
5507 -- : BFD_RELOC_IP2K_PAGE3
5508     Scenix IP2K - high 3 bits of instruction word address
5509 -- : BFD_RELOC_IP2K_LO8DATA
5510 -- : BFD_RELOC_IP2K_HI8DATA
5511 -- : BFD_RELOC_IP2K_EX8DATA
5512     Scenix IP2K - ext/low/high 8 bits of data address
5513 -- : BFD_RELOC_IP2K_LO8INSN
5514 -- : BFD_RELOC_IP2K_HI8INSN
5515     Scenix IP2K - low/high 8 bits of instruction word address
5516 -- : BFD_RELOC_IP2K_PC_SKIP
5517     Scenix IP2K - even/odd PC modifier to modify snb pcl.0
5518 -- : BFD_RELOC_IP2K_TEXT
5519     Scenix IP2K - 16 bit word address in text section.
5520 -- : BFD_RELOC_IP2K_FR_OFFSET
5521     Scenix IP2K - 7-bit sp or dp offset
5522 -- : BFD_RELOC_VPE4KMATH_DATA
5523 -- : BFD_RELOC_VPE4KMATH_INSN
5524     Scenix VPE4K coprocessor - data/insn-space addressing
5525 -- : BFD_RELOC_VTABLE_INHERIT
5526 -- : BFD_RELOC_VTABLE_ENTRY
5527     These two relocations are used by the linker to determine which of
5528     the entries in a C++ virtual function table are actually used.
5529     When the -gc-sections option is given, the linker will zero out the
5530     entries that are not used, so that the code for those functions
5531     need not be included in the output.
5532
5533     VTABLE_INHERIT is a zero-space relocation used to describe to the
5534     linker the inheritance tree of a C++ virtual function table.  The
5535     relocation's symbol should be the parent class' vtable, and the
5536     relocation should be located at the child vtable.
5537
5538     VTABLE_ENTRY is a zero-space relocation that describes the use of a
5539     virtual function table entry.  The reloc's symbol should refer to
5540     the table of the class mentioned in the code.  Off of that base, an
5541     offset describes the entry that is being used.  For Rela hosts,
5542     this offset is stored in the reloc's addend.  For Rel hosts, we are
5543     forced to put this offset in the reloc's section offset.
5544 -- : BFD_RELOC_IA64_IMM14
5545 -- : BFD_RELOC_IA64_IMM22
5546 -- : BFD_RELOC_IA64_IMM64
5547 -- : BFD_RELOC_IA64_DIR32MSB
5548 -- : BFD_RELOC_IA64_DIR32LSB
5549 -- : BFD_RELOC_IA64_DIR64MSB
5550 -- : BFD_RELOC_IA64_DIR64LSB
5551 -- : BFD_RELOC_IA64_GPREL22
5552 -- : BFD_RELOC_IA64_GPREL64I
5553 -- : BFD_RELOC_IA64_GPREL32MSB
5554 -- : BFD_RELOC_IA64_GPREL32LSB
5555 -- : BFD_RELOC_IA64_GPREL64MSB
5556 -- : BFD_RELOC_IA64_GPREL64LSB
5557 -- : BFD_RELOC_IA64_LTOFF22
5558 -- : BFD_RELOC_IA64_LTOFF64I
5559 -- : BFD_RELOC_IA64_PLTOFF22
5560 -- : BFD_RELOC_IA64_PLTOFF64I
5561 -- : BFD_RELOC_IA64_PLTOFF64MSB
5562 -- : BFD_RELOC_IA64_PLTOFF64LSB
5563 -- : BFD_RELOC_IA64_FPTR64I
5564 -- : BFD_RELOC_IA64_FPTR32MSB
5565 -- : BFD_RELOC_IA64_FPTR32LSB
5566 -- : BFD_RELOC_IA64_FPTR64MSB
5567 -- : BFD_RELOC_IA64_FPTR64LSB
5568 -- : BFD_RELOC_IA64_PCREL21B
5569 -- : BFD_RELOC_IA64_PCREL21BI
5570 -- : BFD_RELOC_IA64_PCREL21M
5571 -- : BFD_RELOC_IA64_PCREL21F
5572 -- : BFD_RELOC_IA64_PCREL22
5573 -- : BFD_RELOC_IA64_PCREL60B
5574 -- : BFD_RELOC_IA64_PCREL64I
5575 -- : BFD_RELOC_IA64_PCREL32MSB
5576 -- : BFD_RELOC_IA64_PCREL32LSB
5577 -- : BFD_RELOC_IA64_PCREL64MSB
5578 -- : BFD_RELOC_IA64_PCREL64LSB
5579 -- : BFD_RELOC_IA64_LTOFF_FPTR22
5580 -- : BFD_RELOC_IA64_LTOFF_FPTR64I
5581 -- : BFD_RELOC_IA64_LTOFF_FPTR32MSB
5582 -- : BFD_RELOC_IA64_LTOFF_FPTR32LSB
5583 -- : BFD_RELOC_IA64_LTOFF_FPTR64MSB
5584 -- : BFD_RELOC_IA64_LTOFF_FPTR64LSB
5585 -- : BFD_RELOC_IA64_SEGREL32MSB
5586 -- : BFD_RELOC_IA64_SEGREL32LSB
5587 -- : BFD_RELOC_IA64_SEGREL64MSB
5588 -- : BFD_RELOC_IA64_SEGREL64LSB
5589 -- : BFD_RELOC_IA64_SECREL32MSB
5590 -- : BFD_RELOC_IA64_SECREL32LSB
5591 -- : BFD_RELOC_IA64_SECREL64MSB
5592 -- : BFD_RELOC_IA64_SECREL64LSB
5593 -- : BFD_RELOC_IA64_REL32MSB
5594 -- : BFD_RELOC_IA64_REL32LSB
5595 -- : BFD_RELOC_IA64_REL64MSB
5596 -- : BFD_RELOC_IA64_REL64LSB
5597 -- : BFD_RELOC_IA64_LTV32MSB
5598 -- : BFD_RELOC_IA64_LTV32LSB
5599 -- : BFD_RELOC_IA64_LTV64MSB
5600 -- : BFD_RELOC_IA64_LTV64LSB
5601 -- : BFD_RELOC_IA64_IPLTMSB
5602 -- : BFD_RELOC_IA64_IPLTLSB
5603 -- : BFD_RELOC_IA64_COPY
5604 -- : BFD_RELOC_IA64_LTOFF22X
5605 -- : BFD_RELOC_IA64_LDXMOV
5606 -- : BFD_RELOC_IA64_TPREL14
5607 -- : BFD_RELOC_IA64_TPREL22
5608 -- : BFD_RELOC_IA64_TPREL64I
5609 -- : BFD_RELOC_IA64_TPREL64MSB
5610 -- : BFD_RELOC_IA64_TPREL64LSB
5611 -- : BFD_RELOC_IA64_LTOFF_TPREL22
5612 -- : BFD_RELOC_IA64_DTPMOD64MSB
5613 -- : BFD_RELOC_IA64_DTPMOD64LSB
5614 -- : BFD_RELOC_IA64_LTOFF_DTPMOD22
5615 -- : BFD_RELOC_IA64_DTPREL14
5616 -- : BFD_RELOC_IA64_DTPREL22
5617 -- : BFD_RELOC_IA64_DTPREL64I
5618 -- : BFD_RELOC_IA64_DTPREL32MSB
5619 -- : BFD_RELOC_IA64_DTPREL32LSB
5620 -- : BFD_RELOC_IA64_DTPREL64MSB
5621 -- : BFD_RELOC_IA64_DTPREL64LSB
5622 -- : BFD_RELOC_IA64_LTOFF_DTPREL22
5623     Intel IA64 Relocations.
5624 -- : BFD_RELOC_M68HC11_HI8
5625     Motorola 68HC11 reloc.  This is the 8 bit high part of an absolute
5626     address.
5627 -- : BFD_RELOC_M68HC11_LO8
5628     Motorola 68HC11 reloc.  This is the 8 bit low part of an absolute
5629     address.
5630 -- : BFD_RELOC_M68HC11_3B
5631     Motorola 68HC11 reloc.  This is the 3 bit of a value.
5632 -- : BFD_RELOC_M68HC11_RL_JUMP
5633     Motorola 68HC11 reloc.  This reloc marks the beginning of a
5634     jump/call instruction.  It is used for linker relaxation to
5635     correctly identify beginning of instruction and change some
5636     branches to use PC-relative addressing mode.
5637 -- : BFD_RELOC_M68HC11_RL_GROUP
5638     Motorola 68HC11 reloc.  This reloc marks a group of several
5639     instructions that gcc generates and for which the linker relaxation
5640     pass can modify and/or remove some of them.
5641 -- : BFD_RELOC_M68HC11_LO16
5642     Motorola 68HC11 reloc.  This is the 16-bit lower part of an
5643     address.  It is used for 'call' instruction to specify the symbol
5644     address without any special transformation (due to memory bank
5645     window).
5646 -- : BFD_RELOC_M68HC11_PAGE
5647     Motorola 68HC11 reloc.  This is a 8-bit reloc that specifies the
5648     page number of an address.  It is used by 'call' instruction to
5649     specify the page number of the symbol.
5650 -- : BFD_RELOC_M68HC11_24
5651     Motorola 68HC11 reloc.  This is a 24-bit reloc that represents the
5652     address with a 16-bit value and a 8-bit page number.  The symbol
5653     address is transformed to follow the 16K memory bank of 68HC12
5654     (seen as mapped in the window).
5655 -- : BFD_RELOC_M68HC12_5B
5656     Motorola 68HC12 reloc.  This is the 5 bits of a value.
5657 -- : BFD_RELOC_XGATE_RL_JUMP
5658     Freescale XGATE reloc.  This reloc marks the beginning of a bra/jal
5659     instruction.
5660 -- : BFD_RELOC_XGATE_RL_GROUP
5661     Freescale XGATE reloc.  This reloc marks a group of several
5662     instructions that gcc generates and for which the linker relaxation
5663     pass can modify and/or remove some of them.
5664 -- : BFD_RELOC_XGATE_LO16
5665     Freescale XGATE reloc.  This is the 16-bit lower part of an
5666     address.  It is used for the '16-bit' instructions.
5667 -- : BFD_RELOC_XGATE_GPAGE
5668     Freescale XGATE reloc.
5669 -- : BFD_RELOC_XGATE_24
5670     Freescale XGATE reloc.
5671 -- : BFD_RELOC_XGATE_PCREL_9
5672     Freescale XGATE reloc.  This is a 9-bit pc-relative reloc.
5673 -- : BFD_RELOC_XGATE_PCREL_10
5674     Freescale XGATE reloc.  This is a 10-bit pc-relative reloc.
5675 -- : BFD_RELOC_XGATE_IMM8_LO
5676     Freescale XGATE reloc.  This is the 16-bit lower part of an
5677     address.  It is used for the '16-bit' instructions.
5678 -- : BFD_RELOC_XGATE_IMM8_HI
5679     Freescale XGATE reloc.  This is the 16-bit higher part of an
5680     address.  It is used for the '16-bit' instructions.
5681 -- : BFD_RELOC_XGATE_IMM3
5682     Freescale XGATE reloc.  This is a 3-bit pc-relative reloc.
5683 -- : BFD_RELOC_XGATE_IMM4
5684     Freescale XGATE reloc.  This is a 4-bit pc-relative reloc.
5685 -- : BFD_RELOC_XGATE_IMM5
5686     Freescale XGATE reloc.  This is a 5-bit pc-relative reloc.
5687 -- : BFD_RELOC_M68HC12_9B
5688     Motorola 68HC12 reloc.  This is the 9 bits of a value.
5689 -- : BFD_RELOC_M68HC12_16B
5690     Motorola 68HC12 reloc.  This is the 16 bits of a value.
5691 -- : BFD_RELOC_M68HC12_9_PCREL
5692     Motorola 68HC12/XGATE reloc.  This is a PCREL9 branch.
5693 -- : BFD_RELOC_M68HC12_10_PCREL
5694     Motorola 68HC12/XGATE reloc.  This is a PCREL10 branch.
5695 -- : BFD_RELOC_M68HC12_LO8XG
5696     Motorola 68HC12/XGATE reloc.  This is the 8 bit low part of an
5697     absolute address and immediately precedes a matching HI8XG part.
5698 -- : BFD_RELOC_M68HC12_HI8XG
5699     Motorola 68HC12/XGATE reloc.  This is the 8 bit high part of an
5700     absolute address and immediately follows a matching LO8XG part.
5701 -- : BFD_RELOC_S12Z_15_PCREL
5702     Freescale S12Z reloc.  This is a 15 bit relative address.  If the
5703     most significant bits are all zero then it may be truncated to 8
5704     bits.
5705 -- : BFD_RELOC_16C_NUM08
5706 -- : BFD_RELOC_16C_NUM08_C
5707 -- : BFD_RELOC_16C_NUM16
5708 -- : BFD_RELOC_16C_NUM16_C
5709 -- : BFD_RELOC_16C_NUM32
5710 -- : BFD_RELOC_16C_NUM32_C
5711 -- : BFD_RELOC_16C_DISP04
5712 -- : BFD_RELOC_16C_DISP04_C
5713 -- : BFD_RELOC_16C_DISP08
5714 -- : BFD_RELOC_16C_DISP08_C
5715 -- : BFD_RELOC_16C_DISP16
5716 -- : BFD_RELOC_16C_DISP16_C
5717 -- : BFD_RELOC_16C_DISP24
5718 -- : BFD_RELOC_16C_DISP24_C
5719 -- : BFD_RELOC_16C_DISP24a
5720 -- : BFD_RELOC_16C_DISP24a_C
5721 -- : BFD_RELOC_16C_REG04
5722 -- : BFD_RELOC_16C_REG04_C
5723 -- : BFD_RELOC_16C_REG04a
5724 -- : BFD_RELOC_16C_REG04a_C
5725 -- : BFD_RELOC_16C_REG14
5726 -- : BFD_RELOC_16C_REG14_C
5727 -- : BFD_RELOC_16C_REG16
5728 -- : BFD_RELOC_16C_REG16_C
5729 -- : BFD_RELOC_16C_REG20
5730 -- : BFD_RELOC_16C_REG20_C
5731 -- : BFD_RELOC_16C_ABS20
5732 -- : BFD_RELOC_16C_ABS20_C
5733 -- : BFD_RELOC_16C_ABS24
5734 -- : BFD_RELOC_16C_ABS24_C
5735 -- : BFD_RELOC_16C_IMM04
5736 -- : BFD_RELOC_16C_IMM04_C
5737 -- : BFD_RELOC_16C_IMM16
5738 -- : BFD_RELOC_16C_IMM16_C
5739 -- : BFD_RELOC_16C_IMM20
5740 -- : BFD_RELOC_16C_IMM20_C
5741 -- : BFD_RELOC_16C_IMM24
5742 -- : BFD_RELOC_16C_IMM24_C
5743 -- : BFD_RELOC_16C_IMM32
5744 -- : BFD_RELOC_16C_IMM32_C
5745     NS CR16C Relocations.
5746 -- : BFD_RELOC_CR16_NUM8
5747 -- : BFD_RELOC_CR16_NUM16
5748 -- : BFD_RELOC_CR16_NUM32
5749 -- : BFD_RELOC_CR16_NUM32a
5750 -- : BFD_RELOC_CR16_REGREL0
5751 -- : BFD_RELOC_CR16_REGREL4
5752 -- : BFD_RELOC_CR16_REGREL4a
5753 -- : BFD_RELOC_CR16_REGREL14
5754 -- : BFD_RELOC_CR16_REGREL14a
5755 -- : BFD_RELOC_CR16_REGREL16
5756 -- : BFD_RELOC_CR16_REGREL20
5757 -- : BFD_RELOC_CR16_REGREL20a
5758 -- : BFD_RELOC_CR16_ABS20
5759 -- : BFD_RELOC_CR16_ABS24
5760 -- : BFD_RELOC_CR16_IMM4
5761 -- : BFD_RELOC_CR16_IMM8
5762 -- : BFD_RELOC_CR16_IMM16
5763 -- : BFD_RELOC_CR16_IMM20
5764 -- : BFD_RELOC_CR16_IMM24
5765 -- : BFD_RELOC_CR16_IMM32
5766 -- : BFD_RELOC_CR16_IMM32a
5767 -- : BFD_RELOC_CR16_DISP4
5768 -- : BFD_RELOC_CR16_DISP8
5769 -- : BFD_RELOC_CR16_DISP16
5770 -- : BFD_RELOC_CR16_DISP20
5771 -- : BFD_RELOC_CR16_DISP24
5772 -- : BFD_RELOC_CR16_DISP24a
5773 -- : BFD_RELOC_CR16_SWITCH8
5774 -- : BFD_RELOC_CR16_SWITCH16
5775 -- : BFD_RELOC_CR16_SWITCH32
5776 -- : BFD_RELOC_CR16_GOT_REGREL20
5777 -- : BFD_RELOC_CR16_GOTC_REGREL20
5778 -- : BFD_RELOC_CR16_GLOB_DAT
5779     NS CR16 Relocations.
5780 -- : BFD_RELOC_CRX_REL4
5781 -- : BFD_RELOC_CRX_REL8
5782 -- : BFD_RELOC_CRX_REL8_CMP
5783 -- : BFD_RELOC_CRX_REL16
5784 -- : BFD_RELOC_CRX_REL24
5785 -- : BFD_RELOC_CRX_REL32
5786 -- : BFD_RELOC_CRX_REGREL12
5787 -- : BFD_RELOC_CRX_REGREL22
5788 -- : BFD_RELOC_CRX_REGREL28
5789 -- : BFD_RELOC_CRX_REGREL32
5790 -- : BFD_RELOC_CRX_ABS16
5791 -- : BFD_RELOC_CRX_ABS32
5792 -- : BFD_RELOC_CRX_NUM8
5793 -- : BFD_RELOC_CRX_NUM16
5794 -- : BFD_RELOC_CRX_NUM32
5795 -- : BFD_RELOC_CRX_IMM16
5796 -- : BFD_RELOC_CRX_IMM32
5797 -- : BFD_RELOC_CRX_SWITCH8
5798 -- : BFD_RELOC_CRX_SWITCH16
5799 -- : BFD_RELOC_CRX_SWITCH32
5800     NS CRX Relocations.
5801 -- : BFD_RELOC_CRIS_BDISP8
5802 -- : BFD_RELOC_CRIS_UNSIGNED_5
5803 -- : BFD_RELOC_CRIS_SIGNED_6
5804 -- : BFD_RELOC_CRIS_UNSIGNED_6
5805 -- : BFD_RELOC_CRIS_SIGNED_8
5806 -- : BFD_RELOC_CRIS_UNSIGNED_8
5807 -- : BFD_RELOC_CRIS_SIGNED_16
5808 -- : BFD_RELOC_CRIS_UNSIGNED_16
5809 -- : BFD_RELOC_CRIS_LAPCQ_OFFSET
5810 -- : BFD_RELOC_CRIS_UNSIGNED_4
5811     These relocs are only used within the CRIS assembler.  They are not
5812     (at present) written to any object files.
5813 -- : BFD_RELOC_CRIS_COPY
5814 -- : BFD_RELOC_CRIS_GLOB_DAT
5815 -- : BFD_RELOC_CRIS_JUMP_SLOT
5816 -- : BFD_RELOC_CRIS_RELATIVE
5817     Relocs used in ELF shared libraries for CRIS.
5818 -- : BFD_RELOC_CRIS_32_GOT
5819     32-bit offset to symbol-entry within GOT.
5820 -- : BFD_RELOC_CRIS_16_GOT
5821     16-bit offset to symbol-entry within GOT.
5822 -- : BFD_RELOC_CRIS_32_GOTPLT
5823     32-bit offset to symbol-entry within GOT, with PLT handling.
5824 -- : BFD_RELOC_CRIS_16_GOTPLT
5825     16-bit offset to symbol-entry within GOT, with PLT handling.
5826 -- : BFD_RELOC_CRIS_32_GOTREL
5827     32-bit offset to symbol, relative to GOT.
5828 -- : BFD_RELOC_CRIS_32_PLT_GOTREL
5829     32-bit offset to symbol with PLT entry, relative to GOT.
5830 -- : BFD_RELOC_CRIS_32_PLT_PCREL
5831     32-bit offset to symbol with PLT entry, relative to this
5832     relocation.
5833 -- : BFD_RELOC_CRIS_32_GOT_GD
5834 -- : BFD_RELOC_CRIS_16_GOT_GD
5835 -- : BFD_RELOC_CRIS_32_GD
5836 -- : BFD_RELOC_CRIS_DTP
5837 -- : BFD_RELOC_CRIS_32_DTPREL
5838 -- : BFD_RELOC_CRIS_16_DTPREL
5839 -- : BFD_RELOC_CRIS_32_GOT_TPREL
5840 -- : BFD_RELOC_CRIS_16_GOT_TPREL
5841 -- : BFD_RELOC_CRIS_32_TPREL
5842 -- : BFD_RELOC_CRIS_16_TPREL
5843 -- : BFD_RELOC_CRIS_DTPMOD
5844 -- : BFD_RELOC_CRIS_32_IE
5845     Relocs used in TLS code for CRIS.
5846 -- : BFD_RELOC_OR1K_REL_26
5847 -- : BFD_RELOC_OR1K_GOTPC_HI16
5848 -- : BFD_RELOC_OR1K_GOTPC_LO16
5849 -- : BFD_RELOC_OR1K_GOT16
5850 -- : BFD_RELOC_OR1K_PLT26
5851 -- : BFD_RELOC_OR1K_GOTOFF_HI16
5852 -- : BFD_RELOC_OR1K_GOTOFF_LO16
5853 -- : BFD_RELOC_OR1K_COPY
5854 -- : BFD_RELOC_OR1K_GLOB_DAT
5855 -- : BFD_RELOC_OR1K_JMP_SLOT
5856 -- : BFD_RELOC_OR1K_RELATIVE
5857 -- : BFD_RELOC_OR1K_TLS_GD_HI16
5858 -- : BFD_RELOC_OR1K_TLS_GD_LO16
5859 -- : BFD_RELOC_OR1K_TLS_LDM_HI16
5860 -- : BFD_RELOC_OR1K_TLS_LDM_LO16
5861 -- : BFD_RELOC_OR1K_TLS_LDO_HI16
5862 -- : BFD_RELOC_OR1K_TLS_LDO_LO16
5863 -- : BFD_RELOC_OR1K_TLS_IE_HI16
5864 -- : BFD_RELOC_OR1K_TLS_IE_LO16
5865 -- : BFD_RELOC_OR1K_TLS_LE_HI16
5866 -- : BFD_RELOC_OR1K_TLS_LE_LO16
5867 -- : BFD_RELOC_OR1K_TLS_TPOFF
5868 -- : BFD_RELOC_OR1K_TLS_DTPOFF
5869 -- : BFD_RELOC_OR1K_TLS_DTPMOD
5870     OpenRISC 1000 Relocations.
5871 -- : BFD_RELOC_H8_DIR16A8
5872 -- : BFD_RELOC_H8_DIR16R8
5873 -- : BFD_RELOC_H8_DIR24A8
5874 -- : BFD_RELOC_H8_DIR24R8
5875 -- : BFD_RELOC_H8_DIR32A16
5876 -- : BFD_RELOC_H8_DISP32A16
5877     H8 elf Relocations.
5878 -- : BFD_RELOC_XSTORMY16_REL_12
5879 -- : BFD_RELOC_XSTORMY16_12
5880 -- : BFD_RELOC_XSTORMY16_24
5881 -- : BFD_RELOC_XSTORMY16_FPTR16
5882     Sony Xstormy16 Relocations.
5883 -- : BFD_RELOC_RELC
5884     Self-describing complex relocations.
5885 -- : BFD_RELOC_XC16X_PAG
5886 -- : BFD_RELOC_XC16X_POF
5887 -- : BFD_RELOC_XC16X_SEG
5888 -- : BFD_RELOC_XC16X_SOF
5889     Infineon Relocations.
5890 -- : BFD_RELOC_VAX_GLOB_DAT
5891 -- : BFD_RELOC_VAX_JMP_SLOT
5892 -- : BFD_RELOC_VAX_RELATIVE
5893     Relocations used by VAX ELF.
5894 -- : BFD_RELOC_MT_PC16
5895     Morpho MT - 16 bit immediate relocation.
5896 -- : BFD_RELOC_MT_HI16
5897     Morpho MT - Hi 16 bits of an address.
5898 -- : BFD_RELOC_MT_LO16
5899     Morpho MT - Low 16 bits of an address.
5900 -- : BFD_RELOC_MT_GNU_VTINHERIT
5901     Morpho MT - Used to tell the linker which vtable entries are used.
5902 -- : BFD_RELOC_MT_GNU_VTENTRY
5903     Morpho MT - Used to tell the linker which vtable entries are used.
5904 -- : BFD_RELOC_MT_PCINSN8
5905     Morpho MT - 8 bit immediate relocation.
5906 -- : BFD_RELOC_MSP430_10_PCREL
5907 -- : BFD_RELOC_MSP430_16_PCREL
5908 -- : BFD_RELOC_MSP430_16
5909 -- : BFD_RELOC_MSP430_16_PCREL_BYTE
5910 -- : BFD_RELOC_MSP430_16_BYTE
5911 -- : BFD_RELOC_MSP430_2X_PCREL
5912 -- : BFD_RELOC_MSP430_RL_PCREL
5913 -- : BFD_RELOC_MSP430_ABS8
5914 -- : BFD_RELOC_MSP430X_PCR20_EXT_SRC
5915 -- : BFD_RELOC_MSP430X_PCR20_EXT_DST
5916 -- : BFD_RELOC_MSP430X_PCR20_EXT_ODST
5917 -- : BFD_RELOC_MSP430X_ABS20_EXT_SRC
5918 -- : BFD_RELOC_MSP430X_ABS20_EXT_DST
5919 -- : BFD_RELOC_MSP430X_ABS20_EXT_ODST
5920 -- : BFD_RELOC_MSP430X_ABS20_ADR_SRC
5921 -- : BFD_RELOC_MSP430X_ABS20_ADR_DST
5922 -- : BFD_RELOC_MSP430X_PCR16
5923 -- : BFD_RELOC_MSP430X_PCR20_CALL
5924 -- : BFD_RELOC_MSP430X_ABS16
5925 -- : BFD_RELOC_MSP430_ABS_HI16
5926 -- : BFD_RELOC_MSP430_PREL31
5927 -- : BFD_RELOC_MSP430_SYM_DIFF
5928     msp430 specific relocation codes
5929 -- : BFD_RELOC_NIOS2_S16
5930 -- : BFD_RELOC_NIOS2_U16
5931 -- : BFD_RELOC_NIOS2_CALL26
5932 -- : BFD_RELOC_NIOS2_IMM5
5933 -- : BFD_RELOC_NIOS2_CACHE_OPX
5934 -- : BFD_RELOC_NIOS2_IMM6
5935 -- : BFD_RELOC_NIOS2_IMM8
5936 -- : BFD_RELOC_NIOS2_HI16
5937 -- : BFD_RELOC_NIOS2_LO16
5938 -- : BFD_RELOC_NIOS2_HIADJ16
5939 -- : BFD_RELOC_NIOS2_GPREL
5940 -- : BFD_RELOC_NIOS2_UJMP
5941 -- : BFD_RELOC_NIOS2_CJMP
5942 -- : BFD_RELOC_NIOS2_CALLR
5943 -- : BFD_RELOC_NIOS2_ALIGN
5944 -- : BFD_RELOC_NIOS2_GOT16
5945 -- : BFD_RELOC_NIOS2_CALL16
5946 -- : BFD_RELOC_NIOS2_GOTOFF_LO
5947 -- : BFD_RELOC_NIOS2_GOTOFF_HA
5948 -- : BFD_RELOC_NIOS2_PCREL_LO
5949 -- : BFD_RELOC_NIOS2_PCREL_HA
5950 -- : BFD_RELOC_NIOS2_TLS_GD16
5951 -- : BFD_RELOC_NIOS2_TLS_LDM16
5952 -- : BFD_RELOC_NIOS2_TLS_LDO16
5953 -- : BFD_RELOC_NIOS2_TLS_IE16
5954 -- : BFD_RELOC_NIOS2_TLS_LE16
5955 -- : BFD_RELOC_NIOS2_TLS_DTPMOD
5956 -- : BFD_RELOC_NIOS2_TLS_DTPREL
5957 -- : BFD_RELOC_NIOS2_TLS_TPREL
5958 -- : BFD_RELOC_NIOS2_COPY
5959 -- : BFD_RELOC_NIOS2_GLOB_DAT
5960 -- : BFD_RELOC_NIOS2_JUMP_SLOT
5961 -- : BFD_RELOC_NIOS2_RELATIVE
5962 -- : BFD_RELOC_NIOS2_GOTOFF
5963 -- : BFD_RELOC_NIOS2_CALL26_NOAT
5964 -- : BFD_RELOC_NIOS2_GOT_LO
5965 -- : BFD_RELOC_NIOS2_GOT_HA
5966 -- : BFD_RELOC_NIOS2_CALL_LO
5967 -- : BFD_RELOC_NIOS2_CALL_HA
5968 -- : BFD_RELOC_NIOS2_R2_S12
5969 -- : BFD_RELOC_NIOS2_R2_I10_1_PCREL
5970 -- : BFD_RELOC_NIOS2_R2_T1I7_1_PCREL
5971 -- : BFD_RELOC_NIOS2_R2_T1I7_2
5972 -- : BFD_RELOC_NIOS2_R2_T2I4
5973 -- : BFD_RELOC_NIOS2_R2_T2I4_1
5974 -- : BFD_RELOC_NIOS2_R2_T2I4_2
5975 -- : BFD_RELOC_NIOS2_R2_X1I7_2
5976 -- : BFD_RELOC_NIOS2_R2_X2L5
5977 -- : BFD_RELOC_NIOS2_R2_F1I5_2
5978 -- : BFD_RELOC_NIOS2_R2_L5I4X1
5979 -- : BFD_RELOC_NIOS2_R2_T1X1I6
5980 -- : BFD_RELOC_NIOS2_R2_T1X1I6_2
5981     Relocations used by the Altera Nios II core.
5982 -- : BFD_RELOC_PRU_U16
5983     PRU LDI 16-bit unsigned data-memory relocation.
5984 -- : BFD_RELOC_PRU_U16_PMEMIMM
5985     PRU LDI 16-bit unsigned instruction-memory relocation.
5986 -- : BFD_RELOC_PRU_LDI32
5987     PRU relocation for two consecutive LDI load instructions that load
5988     a 32 bit value into a register.  If the higher bits are all zero,
5989     then the second instruction may be relaxed.
5990 -- : BFD_RELOC_PRU_S10_PCREL
5991     PRU QBBx 10-bit signed PC-relative relocation.
5992 -- : BFD_RELOC_PRU_U8_PCREL
5993     PRU 8-bit unsigned relocation used for the LOOP instruction.
5994 -- : BFD_RELOC_PRU_32_PMEM
5995 -- : BFD_RELOC_PRU_16_PMEM
5996     PRU Program Memory relocations.  Used to convert from byte
5997     addressing to 32-bit word addressing.
5998 -- : BFD_RELOC_PRU_GNU_DIFF8
5999 -- : BFD_RELOC_PRU_GNU_DIFF16
6000 -- : BFD_RELOC_PRU_GNU_DIFF32
6001 -- : BFD_RELOC_PRU_GNU_DIFF16_PMEM
6002 -- : BFD_RELOC_PRU_GNU_DIFF32_PMEM
6003     PRU relocations to mark the difference of two local symbols.  These
6004     are only needed to support linker relaxation and can be ignored
6005     when not relaxing.  The field is set to the value of the difference
6006     assuming no relaxation.  The relocation encodes the position of the
6007     second symbol so the linker can determine whether to adjust the
6008     field value.  The PMEM variants encode the word difference, instead
6009     of byte difference between symbols.
6010 -- : BFD_RELOC_IQ2000_OFFSET_16
6011 -- : BFD_RELOC_IQ2000_OFFSET_21
6012 -- : BFD_RELOC_IQ2000_UHI16
6013     IQ2000 Relocations.
6014 -- : BFD_RELOC_XTENSA_RTLD
6015     Special Xtensa relocation used only by PLT entries in ELF shared
6016     objects to indicate that the runtime linker should set the value to
6017     one of its own internal functions or data structures.
6018 -- : BFD_RELOC_XTENSA_GLOB_DAT
6019 -- : BFD_RELOC_XTENSA_JMP_SLOT
6020 -- : BFD_RELOC_XTENSA_RELATIVE
6021     Xtensa relocations for ELF shared objects.
6022 -- : BFD_RELOC_XTENSA_PLT
6023     Xtensa relocation used in ELF object files for symbols that may
6024     require PLT entries.  Otherwise, this is just a generic 32-bit
6025     relocation.
6026 -- : BFD_RELOC_XTENSA_DIFF8
6027 -- : BFD_RELOC_XTENSA_DIFF16
6028 -- : BFD_RELOC_XTENSA_DIFF32
6029     Xtensa relocations to mark the difference of two local symbols.
6030     These are only needed to support linker relaxation and can be
6031     ignored when not relaxing.  The field is set to the value of the
6032     difference assuming no relaxation.  The relocation encodes the
6033     position of the first symbol so the linker can determine whether to
6034     adjust the field value.
6035 -- : BFD_RELOC_XTENSA_SLOT0_OP
6036 -- : BFD_RELOC_XTENSA_SLOT1_OP
6037 -- : BFD_RELOC_XTENSA_SLOT2_OP
6038 -- : BFD_RELOC_XTENSA_SLOT3_OP
6039 -- : BFD_RELOC_XTENSA_SLOT4_OP
6040 -- : BFD_RELOC_XTENSA_SLOT5_OP
6041 -- : BFD_RELOC_XTENSA_SLOT6_OP
6042 -- : BFD_RELOC_XTENSA_SLOT7_OP
6043 -- : BFD_RELOC_XTENSA_SLOT8_OP
6044 -- : BFD_RELOC_XTENSA_SLOT9_OP
6045 -- : BFD_RELOC_XTENSA_SLOT10_OP
6046 -- : BFD_RELOC_XTENSA_SLOT11_OP
6047 -- : BFD_RELOC_XTENSA_SLOT12_OP
6048 -- : BFD_RELOC_XTENSA_SLOT13_OP
6049 -- : BFD_RELOC_XTENSA_SLOT14_OP
6050     Generic Xtensa relocations for instruction operands.  Only the slot
6051     number is encoded in the relocation.  The relocation applies to the
6052     last PC-relative immediate operand, or if there are no PC-relative
6053     immediates, to the last immediate operand.
6054 -- : BFD_RELOC_XTENSA_SLOT0_ALT
6055 -- : BFD_RELOC_XTENSA_SLOT1_ALT
6056 -- : BFD_RELOC_XTENSA_SLOT2_ALT
6057 -- : BFD_RELOC_XTENSA_SLOT3_ALT
6058 -- : BFD_RELOC_XTENSA_SLOT4_ALT
6059 -- : BFD_RELOC_XTENSA_SLOT5_ALT
6060 -- : BFD_RELOC_XTENSA_SLOT6_ALT
6061 -- : BFD_RELOC_XTENSA_SLOT7_ALT
6062 -- : BFD_RELOC_XTENSA_SLOT8_ALT
6063 -- : BFD_RELOC_XTENSA_SLOT9_ALT
6064 -- : BFD_RELOC_XTENSA_SLOT10_ALT
6065 -- : BFD_RELOC_XTENSA_SLOT11_ALT
6066 -- : BFD_RELOC_XTENSA_SLOT12_ALT
6067 -- : BFD_RELOC_XTENSA_SLOT13_ALT
6068 -- : BFD_RELOC_XTENSA_SLOT14_ALT
6069     Alternate Xtensa relocations.  Only the slot is encoded in the
6070     relocation.  The meaning of these relocations is opcode-specific.
6071 -- : BFD_RELOC_XTENSA_OP0
6072 -- : BFD_RELOC_XTENSA_OP1
6073 -- : BFD_RELOC_XTENSA_OP2
6074     Xtensa relocations for backward compatibility.  These have all been
6075     replaced by BFD_RELOC_XTENSA_SLOT0_OP.
6076 -- : BFD_RELOC_XTENSA_ASM_EXPAND
6077     Xtensa relocation to mark that the assembler expanded the
6078     instructions from an original target.  The expansion size is
6079     encoded in the reloc size.
6080 -- : BFD_RELOC_XTENSA_ASM_SIMPLIFY
6081     Xtensa relocation to mark that the linker should simplify
6082     assembler-expanded instructions.  This is commonly used internally
6083     by the linker after analysis of a BFD_RELOC_XTENSA_ASM_EXPAND.
6084 -- : BFD_RELOC_XTENSA_TLSDESC_FN
6085 -- : BFD_RELOC_XTENSA_TLSDESC_ARG
6086 -- : BFD_RELOC_XTENSA_TLS_DTPOFF
6087 -- : BFD_RELOC_XTENSA_TLS_TPOFF
6088 -- : BFD_RELOC_XTENSA_TLS_FUNC
6089 -- : BFD_RELOC_XTENSA_TLS_ARG
6090 -- : BFD_RELOC_XTENSA_TLS_CALL
6091     Xtensa TLS relocations.
6092 -- : BFD_RELOC_Z80_DISP8
6093     8 bit signed offset in (ix+d) or (iy+d).
6094 -- : BFD_RELOC_Z8K_DISP7
6095     DJNZ offset.
6096 -- : BFD_RELOC_Z8K_CALLR
6097     CALR offset.
6098 -- : BFD_RELOC_Z8K_IMM4L
6099     4 bit value.
6100 -- : BFD_RELOC_LM32_CALL
6101 -- : BFD_RELOC_LM32_BRANCH
6102 -- : BFD_RELOC_LM32_16_GOT
6103 -- : BFD_RELOC_LM32_GOTOFF_HI16
6104 -- : BFD_RELOC_LM32_GOTOFF_LO16
6105 -- : BFD_RELOC_LM32_COPY
6106 -- : BFD_RELOC_LM32_GLOB_DAT
6107 -- : BFD_RELOC_LM32_JMP_SLOT
6108 -- : BFD_RELOC_LM32_RELATIVE
6109     Lattice Mico32 relocations.
6110 -- : BFD_RELOC_MACH_O_SECTDIFF
6111     Difference between two section addreses.  Must be followed by a
6112     BFD_RELOC_MACH_O_PAIR.
6113 -- : BFD_RELOC_MACH_O_LOCAL_SECTDIFF
6114     Like BFD_RELOC_MACH_O_SECTDIFF but with a local symbol.
6115 -- : BFD_RELOC_MACH_O_PAIR
6116     Pair of relocation.  Contains the first symbol.
6117 -- : BFD_RELOC_MACH_O_SUBTRACTOR32
6118     Symbol will be substracted.  Must be followed by a BFD_RELOC_32.
6119 -- : BFD_RELOC_MACH_O_SUBTRACTOR64
6120     Symbol will be substracted.  Must be followed by a BFD_RELOC_64.
6121 -- : BFD_RELOC_MACH_O_X86_64_BRANCH32
6122 -- : BFD_RELOC_MACH_O_X86_64_BRANCH8
6123     PCREL relocations.  They are marked as branch to create PLT entry
6124     if required.
6125 -- : BFD_RELOC_MACH_O_X86_64_GOT
6126     Used when referencing a GOT entry.
6127 -- : BFD_RELOC_MACH_O_X86_64_GOT_LOAD
6128     Used when loading a GOT entry with movq.  It is specially marked so
6129     that the linker could optimize the movq to a leaq if possible.
6130 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_1
6131     Same as BFD_RELOC_32_PCREL but with an implicit -1 addend.
6132 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_2
6133     Same as BFD_RELOC_32_PCREL but with an implicit -2 addend.
6134 -- : BFD_RELOC_MACH_O_X86_64_PCREL32_4
6135     Same as BFD_RELOC_32_PCREL but with an implicit -4 addend.
6136 -- : BFD_RELOC_MACH_O_X86_64_TLV
6137     Used when referencing a TLV entry.
6138 -- : BFD_RELOC_MACH_O_ARM64_ADDEND
6139     Addend for PAGE or PAGEOFF.
6140 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21
6141     Relative offset to page of GOT slot.
6142 -- : BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12
6143     Relative offset within page of GOT slot.
6144 -- : BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT
6145     Address of a GOT entry.
6146 -- : BFD_RELOC_MICROBLAZE_32_LO
6147     This is a 32 bit reloc for the microblaze that stores the low 16
6148     bits of a value
6149 -- : BFD_RELOC_MICROBLAZE_32_LO_PCREL
6150     This is a 32 bit pc-relative reloc for the microblaze that stores
6151     the low 16 bits of a value
6152 -- : BFD_RELOC_MICROBLAZE_32_ROSDA
6153     This is a 32 bit reloc for the microblaze that stores a value
6154     relative to the read-only small data area anchor
6155 -- : BFD_RELOC_MICROBLAZE_32_RWSDA
6156     This is a 32 bit reloc for the microblaze that stores a value
6157     relative to the read-write small data area anchor
6158 -- : BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM
6159     This is a 32 bit reloc for the microblaze to handle expressions of
6160     the form "Symbol Op Symbol"
6161 -- : BFD_RELOC_MICROBLAZE_64_NONE
6162     This is a 64 bit reloc that stores the 32 bit pc relative value in
6163     two words (with an imm instruction).  No relocation is done here -
6164     only used for relaxing
6165 -- : BFD_RELOC_MICROBLAZE_64_GOTPC
6166     This is a 64 bit reloc that stores the 32 bit pc relative value in
6167     two words (with an imm instruction).  The relocation is PC-relative
6168     GOT offset
6169 -- : BFD_RELOC_MICROBLAZE_64_GOT
6170     This is a 64 bit reloc that stores the 32 bit pc relative value in
6171     two words (with an imm instruction).  The relocation is GOT offset
6172 -- : BFD_RELOC_MICROBLAZE_64_PLT
6173     This is a 64 bit reloc that stores the 32 bit pc relative value in
6174     two words (with an imm instruction).  The relocation is PC-relative
6175     offset into PLT
6176 -- : BFD_RELOC_MICROBLAZE_64_GOTOFF
6177     This is a 64 bit reloc that stores the 32 bit GOT relative value in
6178     two words (with an imm instruction).  The relocation is relative
6179     offset from _GLOBAL_OFFSET_TABLE_
6180 -- : BFD_RELOC_MICROBLAZE_32_GOTOFF
6181     This is a 32 bit reloc that stores the 32 bit GOT relative value in
6182     a word.  The relocation is relative offset from
6183 -- : BFD_RELOC_MICROBLAZE_COPY
6184     This is used to tell the dynamic linker to copy the value out of
6185     the dynamic object into the runtime process image.
6186 -- : BFD_RELOC_MICROBLAZE_64_TLS
6187     Unused Reloc
6188 -- : BFD_RELOC_MICROBLAZE_64_TLSGD
6189     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6190     the GOT TLS GD info entry in two words (with an imm instruction).
6191     The relocation is GOT offset.
6192 -- : BFD_RELOC_MICROBLAZE_64_TLSLD
6193     This is a 64 bit reloc that stores the 32 bit GOT relative value of
6194     the GOT TLS LD info entry in two words (with an imm instruction).
6195     The relocation is GOT offset.
6196 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPMOD
6197     This is a 32 bit reloc that stores the Module ID to GOT(n).
6198 -- : BFD_RELOC_MICROBLAZE_32_TLSDTPREL
6199     This is a 32 bit reloc that stores TLS offset to GOT(n+1).
6200 -- : BFD_RELOC_MICROBLAZE_64_TLSDTPREL
6201     This is a 32 bit reloc for storing TLS offset to two words (uses
6202     imm instruction)
6203 -- : BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL
6204     This is a 64 bit reloc that stores 32-bit thread pointer relative
6205     offset to two words (uses imm instruction).
6206 -- : BFD_RELOC_MICROBLAZE_64_TLSTPREL
6207     This is a 64 bit reloc that stores 32-bit thread pointer relative
6208     offset to two words (uses imm instruction).
6209 -- : BFD_RELOC_MICROBLAZE_64_TEXTPCREL
6210     This is a 64 bit reloc that stores the 32 bit pc relative value in
6211     two words (with an imm instruction).  The relocation is PC-relative
6212     offset from start of TEXT.
6213 -- : BFD_RELOC_MICROBLAZE_64_TEXTREL
6214     This is a 64 bit reloc that stores the 32 bit offset value in two
6215     words (with an imm instruction).  The relocation is relative offset
6216     from start of TEXT.
6217 -- : BFD_RELOC_AARCH64_RELOC_START
6218     AArch64 pseudo relocation code to mark the start of the AArch64
6219     relocation enumerators.  N.B. the order of the enumerators is
6220     important as several tables in the AArch64 bfd backend are indexed
6221     by these enumerators; make sure they are all synced.
6222 -- : BFD_RELOC_AARCH64_NULL
6223     Deprecated AArch64 null relocation code.
6224 -- : BFD_RELOC_AARCH64_NONE
6225     AArch64 null relocation code.
6226 -- : BFD_RELOC_AARCH64_64
6227 -- : BFD_RELOC_AARCH64_32
6228 -- : BFD_RELOC_AARCH64_16
6229     Basic absolute relocations of N bits.  These are equivalent to
6230     BFD_RELOC_N and they were added to assist the indexing of the howto
6231     table.
6232 -- : BFD_RELOC_AARCH64_64_PCREL
6233 -- : BFD_RELOC_AARCH64_32_PCREL
6234 -- : BFD_RELOC_AARCH64_16_PCREL
6235     PC-relative relocations.  These are equivalent to BFD_RELOC_N_PCREL
6236     and they were added to assist the indexing of the howto table.
6237 -- : BFD_RELOC_AARCH64_MOVW_G0
6238     AArch64 MOV[NZK] instruction with most significant bits 0 to 15 of
6239     an unsigned address/value.
6240 -- : BFD_RELOC_AARCH64_MOVW_G0_NC
6241     AArch64 MOV[NZK] instruction with less significant bits 0 to 15 of
6242     an address/value.  No overflow checking.
6243 -- : BFD_RELOC_AARCH64_MOVW_G1
6244     AArch64 MOV[NZK] instruction with most significant bits 16 to 31 of
6245     an unsigned address/value.
6246 -- : BFD_RELOC_AARCH64_MOVW_G1_NC
6247     AArch64 MOV[NZK] instruction with less significant bits 16 to 31 of
6248     an address/value.  No overflow checking.
6249 -- : BFD_RELOC_AARCH64_MOVW_G2
6250     AArch64 MOV[NZK] instruction with most significant bits 32 to 47 of
6251     an unsigned address/value.
6252 -- : BFD_RELOC_AARCH64_MOVW_G2_NC
6253     AArch64 MOV[NZK] instruction with less significant bits 32 to 47 of
6254     an address/value.  No overflow checking.
6255 -- : BFD_RELOC_AARCH64_MOVW_G3
6256     AArch64 MOV[NZK] instruction with most signficant bits 48 to 64 of
6257     a signed or unsigned address/value.
6258 -- : BFD_RELOC_AARCH64_MOVW_G0_S
6259     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6260     signed value.  Changes instruction to MOVZ or MOVN depending on the
6261     value's sign.
6262 -- : BFD_RELOC_AARCH64_MOVW_G1_S
6263     AArch64 MOV[NZ] instruction with most significant bits 16 to 31 of
6264     a signed value.  Changes instruction to MOVZ or MOVN depending on
6265     the value's sign.
6266 -- : BFD_RELOC_AARCH64_MOVW_G2_S
6267     AArch64 MOV[NZ] instruction with most significant bits 32 to 47 of
6268     a signed value.  Changes instruction to MOVZ or MOVN depending on
6269     the value's sign.
6270 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0
6271     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6272     signed value.  Changes instruction to MOVZ or MOVN depending on the
6273     value's sign.
6274 -- : BFD_RELOC_AARCH64_MOVW_PREL_G0_NC
6275     AArch64 MOV[NZ] instruction with most significant bits 0 to 15 of a
6276     signed value.  Changes instruction to MOVZ or MOVN depending on the
6277     value's sign.
6278 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1
6279     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6280     signed value.
6281 -- : BFD_RELOC_AARCH64_MOVW_PREL_G1_NC
6282     AArch64 MOVK instruction with most significant bits 16 to 31 of a
6283     signed value.
6284 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2
6285     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6286     signed value.
6287 -- : BFD_RELOC_AARCH64_MOVW_PREL_G2_NC
6288     AArch64 MOVK instruction with most significant bits 32 to 47 of a
6289     signed value.
6290 -- : BFD_RELOC_AARCH64_MOVW_PREL_G3
6291     AArch64 MOVK instruction with most significant bits 47 to 63 of a
6292     signed value.
6293 -- : BFD_RELOC_AARCH64_LD_LO19_PCREL
6294     AArch64 Load Literal instruction, holding a 19 bit pc-relative word
6295     offset.  The lowest two bits must be zero and are not stored in the
6296     instruction, giving a 21 bit signed byte offset.
6297 -- : BFD_RELOC_AARCH64_ADR_LO21_PCREL
6298     AArch64 ADR instruction, holding a simple 21 bit pc-relative byte
6299     offset.
6300 -- : BFD_RELOC_AARCH64_ADR_HI21_PCREL
6301     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6302     offset, giving a 4KB aligned page base address.
6303 -- : BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL
6304     AArch64 ADRP instruction, with bits 12 to 32 of a pc-relative page
6305     offset, giving a 4KB aligned page base address, but with no
6306     overflow checking.
6307 -- : BFD_RELOC_AARCH64_ADD_LO12
6308     AArch64 ADD immediate instruction, holding bits 0 to 11 of the
6309     address.  Used in conjunction with
6310     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6311 -- : BFD_RELOC_AARCH64_LDST8_LO12
6312     AArch64 8-bit load/store instruction, holding bits 0 to 11 of the
6313     address.  Used in conjunction with
6314     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6315 -- : BFD_RELOC_AARCH64_TSTBR14
6316     AArch64 14 bit pc-relative test bit and branch.  The lowest two
6317     bits must be zero and are not stored in the instruction, giving a
6318     16 bit signed byte offset.
6319 -- : BFD_RELOC_AARCH64_BRANCH19
6320     AArch64 19 bit pc-relative conditional branch and compare & branch.
6321     The lowest two bits must be zero and are not stored in the
6322     instruction, giving a 21 bit signed byte offset.
6323 -- : BFD_RELOC_AARCH64_JUMP26
6324     AArch64 26 bit pc-relative unconditional branch.  The lowest two
6325     bits must be zero and are not stored in the instruction, giving a
6326     28 bit signed byte offset.
6327 -- : BFD_RELOC_AARCH64_CALL26
6328     AArch64 26 bit pc-relative unconditional branch and link.  The
6329     lowest two bits must be zero and are not stored in the instruction,
6330     giving a 28 bit signed byte offset.
6331 -- : BFD_RELOC_AARCH64_LDST16_LO12
6332     AArch64 16-bit load/store instruction, holding bits 0 to 11 of the
6333     address.  Used in conjunction with
6334     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6335 -- : BFD_RELOC_AARCH64_LDST32_LO12
6336     AArch64 32-bit load/store instruction, holding bits 0 to 11 of the
6337     address.  Used in conjunction with
6338     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6339 -- : BFD_RELOC_AARCH64_LDST64_LO12
6340     AArch64 64-bit load/store instruction, holding bits 0 to 11 of the
6341     address.  Used in conjunction with
6342     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6343 -- : BFD_RELOC_AARCH64_LDST128_LO12
6344     AArch64 128-bit load/store instruction, holding bits 0 to 11 of the
6345     address.  Used in conjunction with
6346     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6347 -- : BFD_RELOC_AARCH64_GOT_LD_PREL19
6348     AArch64 Load Literal instruction, holding a 19 bit PC relative word
6349     offset of the global offset table entry for a symbol.  The lowest
6350     two bits must be zero and are not stored in the instruction, giving
6351     a 21 bit signed byte offset.  This relocation type requires signed
6352     overflow checking.
6353 -- : BFD_RELOC_AARCH64_ADR_GOT_PAGE
6354     Get to the page base of the global offset table entry for a symbol
6355     as part of an ADRP instruction using a 21 bit PC relative
6356     value.Used in conjunction with BFD_RELOC_AARCH64_LD64_GOT_LO12_NC.
6357 -- : BFD_RELOC_AARCH64_LD64_GOT_LO12_NC
6358     Unsigned 12 bit byte offset for 64 bit load/store from the page of
6359     the GOT entry for this symbol.  Used in conjunction with
6360     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in LP64 ABI only.
6361 -- : BFD_RELOC_AARCH64_LD32_GOT_LO12_NC
6362     Unsigned 12 bit byte offset for 32 bit load/store from the page of
6363     the GOT entry for this symbol.  Used in conjunction with
6364     BFD_RELOC_AARCH64_ADR_GOT_PAGE. Valid in ILP32 ABI only.
6365 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC
6366     Unsigned 16 bit byte offset for 64 bit load/store from the GOT
6367     entry for this symbol.  Valid in LP64 ABI only.
6368 -- : BFD_RELOC_AARCH64_MOVW_GOTOFF_G1
6369     Unsigned 16 bit byte higher offset for 64 bit load/store from the
6370     GOT entry for this symbol.  Valid in LP64 ABI only.
6371 -- : BFD_RELOC_AARCH64_LD64_GOTOFF_LO15
6372     Unsigned 15 bit byte offset for 64 bit load/store from the page of
6373     the GOT entry for this symbol.  Valid in LP64 ABI only.
6374 -- : BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14
6375     Scaled 14 bit byte offset to the page base of the global offset
6376     table.
6377 -- : BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15
6378     Scaled 15 bit byte offset to the page base of the global offset
6379     table.
6380 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21
6381     Get to the page base of the global offset table entry for a symbols
6382     tls_index structure as part of an adrp instruction using a 21 bit
6383     PC relative value.  Used in conjunction with
6384     BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC.
6385 -- : BFD_RELOC_AARCH64_TLSGD_ADR_PREL21
6386     AArch64 TLS General Dynamic
6387 -- : BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC
6388     Unsigned 12 bit byte offset to global offset table entry for a
6389     symbols tls_index structure.  Used in conjunction with
6390     BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21.
6391 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC
6392     AArch64 TLS General Dynamic relocation.
6393 -- : BFD_RELOC_AARCH64_TLSGD_MOVW_G1
6394     AArch64 TLS General Dynamic relocation.
6395 -- : BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21
6396     AArch64 TLS INITIAL EXEC relocation.
6397 -- : BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC
6398     AArch64 TLS INITIAL EXEC relocation.
6399 -- : BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC
6400     AArch64 TLS INITIAL EXEC relocation.
6401 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19
6402     AArch64 TLS INITIAL EXEC relocation.
6403 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC
6404     AArch64 TLS INITIAL EXEC relocation.
6405 -- : BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1
6406     AArch64 TLS INITIAL EXEC relocation.
6407 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12
6408     bit[23:12] of byte offset to module TLS base address.
6409 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12
6410     Unsigned 12 bit byte offset to module TLS base address.
6411 -- : BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC
6412     No overflow check version of
6413     BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12.
6414 -- : BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC
6415     Unsigned 12 bit byte offset to global offset table entry for a
6416     symbols tls_index structure.  Used in conjunction with
6417     BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21.
6418 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21
6419     GOT entry page address for AArch64 TLS Local Dynamic, used with
6420     ADRP instruction.
6421 -- : BFD_RELOC_AARCH64_TLSLD_ADR_PREL21
6422     GOT entry address for AArch64 TLS Local Dynamic, used with ADR
6423     instruction.
6424 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12
6425     bit[11:1] of byte offset to module TLS base address, encoded in
6426     ldst instructions.
6427 -- : BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC
6428     Similar as BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12, but no
6429     overflow check.
6430 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12
6431     bit[11:2] of byte offset to module TLS base address, encoded in
6432     ldst instructions.
6433 -- : BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC
6434     Similar as BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12, but no
6435     overflow check.
6436 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12
6437     bit[11:3] of byte offset to module TLS base address, encoded in
6438     ldst instructions.
6439 -- : BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC
6440     Similar as BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12, but no
6441     overflow check.
6442 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12
6443     bit[11:0] of byte offset to module TLS base address, encoded in
6444     ldst instructions.
6445 -- : BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC
6446     Similar as BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12, but no
6447     overflow check.
6448 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6449     bit[15:0] of byte offset to module TLS base address.
6450 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC
6451     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0
6452 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6453     bit[31:16] of byte offset to module TLS base address.
6454 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC
6455     No overflow check version of BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1
6456 -- : BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2
6457     bit[47:32] of byte offset to module TLS base address.
6458 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2
6459     AArch64 TLS LOCAL EXEC relocation.
6460 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1
6461     AArch64 TLS LOCAL EXEC relocation.
6462 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC
6463     AArch64 TLS LOCAL EXEC relocation.
6464 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0
6465     AArch64 TLS LOCAL EXEC relocation.
6466 -- : BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC
6467     AArch64 TLS LOCAL EXEC relocation.
6468 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12
6469     AArch64 TLS LOCAL EXEC relocation.
6470 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12
6471     AArch64 TLS LOCAL EXEC relocation.
6472 -- : BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC
6473     AArch64 TLS LOCAL EXEC relocation.
6474 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12
6475     bit[11:1] of byte offset to module TLS base address, encoded in
6476     ldst instructions.
6477 -- : BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC
6478     Similar as BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12, but no
6479     overflow check.
6480 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12
6481     bit[11:2] of byte offset to module TLS base address, encoded in
6482     ldst instructions.
6483 -- : BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC
6484     Similar as BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12, but no
6485     overflow check.
6486 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12
6487     bit[11:3] of byte offset to module TLS base address, encoded in
6488     ldst instructions.
6489 -- : BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC
6490     Similar as BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12, but no
6491     overflow check.
6492 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12
6493     bit[11:0] of byte offset to module TLS base address, encoded in
6494     ldst instructions.
6495 -- : BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC
6496     Similar as BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12, but no
6497     overflow check.
6498 -- : BFD_RELOC_AARCH64_TLSDESC_LD_PREL19
6499     AArch64 TLS DESC relocation.
6500 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21
6501     AArch64 TLS DESC relocation.
6502 -- : BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21
6503     AArch64 TLS DESC relocation.
6504 -- : BFD_RELOC_AARCH64_TLSDESC_LD64_LO12
6505     AArch64 TLS DESC relocation.
6506 -- : BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC
6507     AArch64 TLS DESC relocation.
6508 -- : BFD_RELOC_AARCH64_TLSDESC_ADD_LO12
6509     AArch64 TLS DESC relocation.
6510 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G1
6511     AArch64 TLS DESC relocation.
6512 -- : BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC
6513     AArch64 TLS DESC relocation.
6514 -- : BFD_RELOC_AARCH64_TLSDESC_LDR
6515     AArch64 TLS DESC relocation.
6516 -- : BFD_RELOC_AARCH64_TLSDESC_ADD
6517     AArch64 TLS DESC relocation.
6518 -- : BFD_RELOC_AARCH64_TLSDESC_CALL
6519     AArch64 TLS DESC relocation.
6520 -- : BFD_RELOC_AARCH64_COPY
6521     AArch64 TLS relocation.
6522 -- : BFD_RELOC_AARCH64_GLOB_DAT
6523     AArch64 TLS relocation.
6524 -- : BFD_RELOC_AARCH64_JUMP_SLOT
6525     AArch64 TLS relocation.
6526 -- : BFD_RELOC_AARCH64_RELATIVE
6527     AArch64 TLS relocation.
6528 -- : BFD_RELOC_AARCH64_TLS_DTPMOD
6529     AArch64 TLS relocation.
6530 -- : BFD_RELOC_AARCH64_TLS_DTPREL
6531     AArch64 TLS relocation.
6532 -- : BFD_RELOC_AARCH64_TLS_TPREL
6533     AArch64 TLS relocation.
6534 -- : BFD_RELOC_AARCH64_TLSDESC
6535     AArch64 TLS relocation.
6536 -- : BFD_RELOC_AARCH64_IRELATIVE
6537     AArch64 support for STT_GNU_IFUNC.
6538 -- : BFD_RELOC_AARCH64_RELOC_END
6539     AArch64 pseudo relocation code to mark the end of the AArch64
6540     relocation enumerators that have direct mapping to ELF reloc codes.
6541     There are a few more enumerators after this one; those are mainly
6542     used by the AArch64 assembler for the internal fixup or to select
6543     one of the above enumerators.
6544 -- : BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP
6545     AArch64 pseudo relocation code to be used internally by the AArch64
6546     assembler and not (currently) written to any object files.
6547 -- : BFD_RELOC_AARCH64_LDST_LO12
6548     AArch64 unspecified load/store instruction, holding bits 0 to 11 of
6549     the address.  Used in conjunction with
6550     BFD_RELOC_AARCH64_ADR_HI21_PCREL.
6551 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12
6552     AArch64 pseudo relocation code for TLS local dynamic mode.  It's to
6553     be used internally by the AArch64 assembler and not (currently)
6554     written to any object files.
6555 -- : BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC
6556     Similar as BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12, but no
6557     overflow check.
6558 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12
6559     AArch64 pseudo relocation code for TLS local exec mode.  It's to be
6560     used internally by the AArch64 assembler and not (currently)
6561     written to any object files.
6562 -- : BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC
6563     Similar as BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12, but no overflow
6564     check.
6565 -- : BFD_RELOC_AARCH64_LD_GOT_LO12_NC
6566     AArch64 pseudo relocation code to be used internally by the AArch64
6567     assembler and not (currently) written to any object files.
6568 -- : BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC
6569     AArch64 pseudo relocation code to be used internally by the AArch64
6570     assembler and not (currently) written to any object files.
6571 -- : BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC
6572     AArch64 pseudo relocation code to be used internally by the AArch64
6573     assembler and not (currently) written to any object files.
6574 -- : BFD_RELOC_TILEPRO_COPY
6575 -- : BFD_RELOC_TILEPRO_GLOB_DAT
6576 -- : BFD_RELOC_TILEPRO_JMP_SLOT
6577 -- : BFD_RELOC_TILEPRO_RELATIVE
6578 -- : BFD_RELOC_TILEPRO_BROFF_X1
6579 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1
6580 -- : BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT
6581 -- : BFD_RELOC_TILEPRO_IMM8_X0
6582 -- : BFD_RELOC_TILEPRO_IMM8_Y0
6583 -- : BFD_RELOC_TILEPRO_IMM8_X1
6584 -- : BFD_RELOC_TILEPRO_IMM8_Y1
6585 -- : BFD_RELOC_TILEPRO_DEST_IMM8_X1
6586 -- : BFD_RELOC_TILEPRO_MT_IMM15_X1
6587 -- : BFD_RELOC_TILEPRO_MF_IMM15_X1
6588 -- : BFD_RELOC_TILEPRO_IMM16_X0
6589 -- : BFD_RELOC_TILEPRO_IMM16_X1
6590 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO
6591 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO
6592 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI
6593 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI
6594 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA
6595 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA
6596 -- : BFD_RELOC_TILEPRO_IMM16_X0_PCREL
6597 -- : BFD_RELOC_TILEPRO_IMM16_X1_PCREL
6598 -- : BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL
6599 -- : BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL
6600 -- : BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL
6601 -- : BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL
6602 -- : BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL
6603 -- : BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL
6604 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT
6605 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT
6606 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO
6607 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO
6608 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI
6609 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI
6610 -- : BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA
6611 -- : BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA
6612 -- : BFD_RELOC_TILEPRO_MMSTART_X0
6613 -- : BFD_RELOC_TILEPRO_MMEND_X0
6614 -- : BFD_RELOC_TILEPRO_MMSTART_X1
6615 -- : BFD_RELOC_TILEPRO_MMEND_X1
6616 -- : BFD_RELOC_TILEPRO_SHAMT_X0
6617 -- : BFD_RELOC_TILEPRO_SHAMT_X1
6618 -- : BFD_RELOC_TILEPRO_SHAMT_Y0
6619 -- : BFD_RELOC_TILEPRO_SHAMT_Y1
6620 -- : BFD_RELOC_TILEPRO_TLS_GD_CALL
6621 -- : BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD
6622 -- : BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD
6623 -- : BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD
6624 -- : BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD
6625 -- : BFD_RELOC_TILEPRO_TLS_IE_LOAD
6626 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD
6627 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD
6628 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO
6629 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO
6630 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI
6631 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI
6632 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA
6633 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA
6634 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE
6635 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE
6636 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO
6637 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO
6638 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI
6639 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI
6640 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA
6641 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA
6642 -- : BFD_RELOC_TILEPRO_TLS_DTPMOD32
6643 -- : BFD_RELOC_TILEPRO_TLS_DTPOFF32
6644 -- : BFD_RELOC_TILEPRO_TLS_TPOFF32
6645 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE
6646 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE
6647 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO
6648 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO
6649 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI
6650 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI
6651 -- : BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA
6652 -- : BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA
6653     Tilera TILEPro Relocations.
6654 -- : BFD_RELOC_TILEGX_HW0
6655 -- : BFD_RELOC_TILEGX_HW1
6656 -- : BFD_RELOC_TILEGX_HW2
6657 -- : BFD_RELOC_TILEGX_HW3
6658 -- : BFD_RELOC_TILEGX_HW0_LAST
6659 -- : BFD_RELOC_TILEGX_HW1_LAST
6660 -- : BFD_RELOC_TILEGX_HW2_LAST
6661 -- : BFD_RELOC_TILEGX_COPY
6662 -- : BFD_RELOC_TILEGX_GLOB_DAT
6663 -- : BFD_RELOC_TILEGX_JMP_SLOT
6664 -- : BFD_RELOC_TILEGX_RELATIVE
6665 -- : BFD_RELOC_TILEGX_BROFF_X1
6666 -- : BFD_RELOC_TILEGX_JUMPOFF_X1
6667 -- : BFD_RELOC_TILEGX_JUMPOFF_X1_PLT
6668 -- : BFD_RELOC_TILEGX_IMM8_X0
6669 -- : BFD_RELOC_TILEGX_IMM8_Y0
6670 -- : BFD_RELOC_TILEGX_IMM8_X1
6671 -- : BFD_RELOC_TILEGX_IMM8_Y1
6672 -- : BFD_RELOC_TILEGX_DEST_IMM8_X1
6673 -- : BFD_RELOC_TILEGX_MT_IMM14_X1
6674 -- : BFD_RELOC_TILEGX_MF_IMM14_X1
6675 -- : BFD_RELOC_TILEGX_MMSTART_X0
6676 -- : BFD_RELOC_TILEGX_MMEND_X0
6677 -- : BFD_RELOC_TILEGX_SHAMT_X0
6678 -- : BFD_RELOC_TILEGX_SHAMT_X1
6679 -- : BFD_RELOC_TILEGX_SHAMT_Y0
6680 -- : BFD_RELOC_TILEGX_SHAMT_Y1
6681 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0
6682 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0
6683 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1
6684 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1
6685 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2
6686 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2
6687 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3
6688 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3
6689 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST
6690 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST
6691 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST
6692 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST
6693 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST
6694 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST
6695 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL
6696 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL
6697 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL
6698 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL
6699 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL
6700 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL
6701 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL
6702 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL
6703 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL
6704 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL
6705 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL
6706 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL
6707 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL
6708 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL
6709 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT
6710 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT
6711 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL
6712 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL
6713 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL
6714 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL
6715 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL
6716 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL
6717 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT
6718 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT
6719 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT
6720 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT
6721 -- : BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL
6722 -- : BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL
6723 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD
6724 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD
6725 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE
6726 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE
6727 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE
6728 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE
6729 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE
6730 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE
6731 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD
6732 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD
6733 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD
6734 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD
6735 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE
6736 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE
6737 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL
6738 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL
6739 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL
6740 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL
6741 -- : BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL
6742 -- : BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL
6743 -- : BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE
6744 -- : BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE
6745 -- : BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE
6746 -- : BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE
6747 -- : BFD_RELOC_TILEGX_TLS_DTPMOD64
6748 -- : BFD_RELOC_TILEGX_TLS_DTPOFF64
6749 -- : BFD_RELOC_TILEGX_TLS_TPOFF64
6750 -- : BFD_RELOC_TILEGX_TLS_DTPMOD32
6751 -- : BFD_RELOC_TILEGX_TLS_DTPOFF32
6752 -- : BFD_RELOC_TILEGX_TLS_TPOFF32
6753 -- : BFD_RELOC_TILEGX_TLS_GD_CALL
6754 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD
6755 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD
6756 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD
6757 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD
6758 -- : BFD_RELOC_TILEGX_TLS_IE_LOAD
6759 -- : BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD
6760 -- : BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD
6761 -- : BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD
6762 -- : BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD
6763     Tilera TILE-Gx Relocations.
6764 -- : BFD_RELOC_EPIPHANY_SIMM8
6765     Adapteva EPIPHANY - 8 bit signed pc-relative displacement
6766 -- : BFD_RELOC_EPIPHANY_SIMM24
6767     Adapteva EPIPHANY - 24 bit signed pc-relative displacement
6768 -- : BFD_RELOC_EPIPHANY_HIGH
6769     Adapteva EPIPHANY - 16 most-significant bits of absolute address
6770 -- : BFD_RELOC_EPIPHANY_LOW
6771     Adapteva EPIPHANY - 16 least-significant bits of absolute address
6772 -- : BFD_RELOC_EPIPHANY_SIMM11
6773     Adapteva EPIPHANY - 11 bit signed number - add/sub immediate
6774 -- : BFD_RELOC_EPIPHANY_IMM11
6775     Adapteva EPIPHANY - 11 bit sign-magnitude number (ld/st
6776     displacement)
6777 -- : BFD_RELOC_EPIPHANY_IMM8
6778     Adapteva EPIPHANY - 8 bit immediate for 16 bit mov instruction.
6779 -- : BFD_RELOC_VISIUM_HI16
6780 -- : BFD_RELOC_VISIUM_LO16
6781 -- : BFD_RELOC_VISIUM_IM16
6782 -- : BFD_RELOC_VISIUM_REL16
6783 -- : BFD_RELOC_VISIUM_HI16_PCREL
6784 -- : BFD_RELOC_VISIUM_LO16_PCREL
6785 -- : BFD_RELOC_VISIUM_IM16_PCREL
6786     Visium Relocations.
6787 -- : BFD_RELOC_WASM32_LEB128
6788 -- : BFD_RELOC_WASM32_LEB128_GOT
6789 -- : BFD_RELOC_WASM32_LEB128_GOT_CODE
6790 -- : BFD_RELOC_WASM32_LEB128_PLT
6791 -- : BFD_RELOC_WASM32_PLT_INDEX
6792 -- : BFD_RELOC_WASM32_ABS32_CODE
6793 -- : BFD_RELOC_WASM32_COPY
6794 -- : BFD_RELOC_WASM32_CODE_POINTER
6795 -- : BFD_RELOC_WASM32_INDEX
6796 -- : BFD_RELOC_WASM32_PLT_SIG
6797     WebAssembly relocations.
6798
6799
6800     typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
6801
68022.10.2.2 'bfd_reloc_type_lookup'
6803................................
6804
6805*Synopsis*
6806     reloc_howto_type *bfd_reloc_type_lookup
6807        (bfd *abfd, bfd_reloc_code_real_type code);
6808     reloc_howto_type *bfd_reloc_name_lookup
6809        (bfd *abfd, const char *reloc_name);
6810   *Description*
6811Return a pointer to a howto structure which, when invoked, will perform
6812the relocation CODE on data from the architecture noted.
6813
68142.10.2.3 'bfd_default_reloc_type_lookup'
6815........................................
6816
6817*Synopsis*
6818     reloc_howto_type *bfd_default_reloc_type_lookup
6819        (bfd *abfd, bfd_reloc_code_real_type  code);
6820   *Description*
6821Provides a default relocation lookup routine for any architecture.
6822
68232.10.2.4 'bfd_get_reloc_code_name'
6824..................................
6825
6826*Synopsis*
6827     const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
6828   *Description*
6829Provides a printable name for the supplied relocation code.  Useful
6830mainly for printing error messages.
6831
68322.10.2.5 'bfd_generic_relax_section'
6833....................................
6834
6835*Synopsis*
6836     bfd_boolean bfd_generic_relax_section
6837        (bfd *abfd,
6838         asection *section,
6839         struct bfd_link_info *,
6840         bfd_boolean *);
6841   *Description*
6842Provides default handling for relaxing for back ends which don't do
6843relaxing.
6844
68452.10.2.6 'bfd_generic_gc_sections'
6846..................................
6847
6848*Synopsis*
6849     bfd_boolean bfd_generic_gc_sections
6850        (bfd *, struct bfd_link_info *);
6851   *Description*
6852Provides default handling for relaxing for back ends which don't do
6853section gc - i.e., does nothing.
6854
68552.10.2.7 'bfd_generic_lookup_section_flags'
6856...........................................
6857
6858*Synopsis*
6859     bfd_boolean bfd_generic_lookup_section_flags
6860        (struct bfd_link_info *, struct flag_info *, asection *);
6861   *Description*
6862Provides default handling for section flags lookup - i.e., does nothing.
6863Returns FALSE if the section should be omitted, otherwise TRUE.
6864
68652.10.2.8 'bfd_generic_merge_sections'
6866.....................................
6867
6868*Synopsis*
6869     bfd_boolean bfd_generic_merge_sections
6870        (bfd *, struct bfd_link_info *);
6871   *Description*
6872Provides default handling for SEC_MERGE section merging for back ends
6873which don't have SEC_MERGE support - i.e., does nothing.
6874
68752.10.2.9 'bfd_generic_get_relocated_section_contents'
6876.....................................................
6877
6878*Synopsis*
6879     bfd_byte *bfd_generic_get_relocated_section_contents
6880        (bfd *abfd,
6881         struct bfd_link_info *link_info,
6882         struct bfd_link_order *link_order,
6883         bfd_byte *data,
6884         bfd_boolean relocatable,
6885         asymbol **symbols);
6886   *Description*
6887Provides default handling of relocation effort for back ends which can't
6888be bothered to do it efficiently.
6889
68902.10.2.10 '_bfd_generic_set_reloc'
6891..................................
6892
6893*Synopsis*
6894     void _bfd_generic_set_reloc
6895        (bfd *abfd,
6896         sec_ptr section,
6897         arelent **relptr,
6898         unsigned int count);
6899   *Description*
6900Installs a new set of internal relocations in SECTION.
6901
69022.10.2.11 '_bfd_unrecognized_reloc'
6903...................................
6904
6905*Synopsis*
6906     bfd_boolean _bfd_unrecognized_reloc
6907        (bfd * abfd,
6908         sec_ptr section,
6909         unsigned int r_type);
6910   *Description*
6911Reports an unrecognized reloc.  Written as a function in order to reduce
6912code duplication.  Returns FALSE so that it can be called from a return
6913statement.
6914
6915
6916File: bfd.info,  Node: Core Files,  Next: Targets,  Prev: Relocations,  Up: BFD front end
6917
69182.11 Core files
6919===============
6920
69212.11.1 Core file functions
6922--------------------------
6923
6924*Description*
6925These are functions pertaining to core files.
6926
69272.11.1.1 'bfd_core_file_failing_command'
6928........................................
6929
6930*Synopsis*
6931     const char *bfd_core_file_failing_command (bfd *abfd);
6932   *Description*
6933Return a read-only string explaining which program was running when it
6934failed and produced the core file ABFD.
6935
69362.11.1.2 'bfd_core_file_failing_signal'
6937.......................................
6938
6939*Synopsis*
6940     int bfd_core_file_failing_signal (bfd *abfd);
6941   *Description*
6942Returns the signal number which caused the core dump which generated the
6943file the BFD ABFD is attached to.
6944
69452.11.1.3 'bfd_core_file_pid'
6946............................
6947
6948*Synopsis*
6949     int bfd_core_file_pid (bfd *abfd);
6950   *Description*
6951Returns the PID of the process the core dump the BFD ABFD is attached to
6952was generated from.
6953
69542.11.1.4 'core_file_matches_executable_p'
6955.........................................
6956
6957*Synopsis*
6958     bfd_boolean core_file_matches_executable_p
6959        (bfd *core_bfd, bfd *exec_bfd);
6960   *Description*
6961Return 'TRUE' if the core file attached to CORE_BFD was generated by a
6962run of the executable file attached to EXEC_BFD, 'FALSE' otherwise.
6963
69642.11.1.5 'generic_core_file_matches_executable_p'
6965.................................................
6966
6967*Synopsis*
6968     bfd_boolean generic_core_file_matches_executable_p
6969        (bfd *core_bfd, bfd *exec_bfd);
6970   *Description*
6971Return TRUE if the core file attached to CORE_BFD was generated by a run
6972of the executable file attached to EXEC_BFD.  The match is based on
6973executable basenames only.
6974
6975   Note: When not able to determine the core file failing command or the
6976executable name, we still return TRUE even though we're not sure that
6977core file and executable match.  This is to avoid generating a false
6978warning in situations where we really don't know whether they match or
6979not.
6980
6981
6982File: bfd.info,  Node: Targets,  Next: Architectures,  Prev: Core Files,  Up: BFD front end
6983
69842.12 Targets
6985============
6986
6987*Description*
6988Each port of BFD to a different machine requires the creation of a
6989target back end.  All the back end provides to the root part of BFD is a
6990structure containing pointers to functions which perform certain low
6991level operations on files.  BFD translates the applications's requests
6992through a pointer into calls to the back end routines.
6993
6994   When a file is opened with 'bfd_openr', its format and target are
6995unknown.  BFD uses various mechanisms to determine how to interpret the
6996file.  The operations performed are:
6997
6998   * Create a BFD by calling the internal routine '_bfd_new_bfd', then
6999     call 'bfd_find_target' with the target string supplied to
7000     'bfd_openr' and the new BFD pointer.
7001
7002   * If a null target string was provided to 'bfd_find_target', look up
7003     the environment variable 'GNUTARGET' and use that as the target
7004     string.
7005
7006   * If the target string is still 'NULL', or the target string is
7007     'default', then use the first item in the target vector as the
7008     target type, and set 'target_defaulted' in the BFD to cause
7009     'bfd_check_format' to loop through all the targets.  *Note
7010     bfd_target::.  *Note Formats::.
7011
7012   * Otherwise, inspect the elements in the target vector one by one,
7013     until a match on target name is found.  When found, use it.
7014
7015   * Otherwise return the error 'bfd_error_invalid_target' to
7016     'bfd_openr'.
7017
7018   * 'bfd_openr' attempts to open the file using 'bfd_open_file', and
7019     returns the BFD.
7020   Once the BFD has been opened and the target selected, the file format
7021may be determined.  This is done by calling 'bfd_check_format' on the
7022BFD with a suggested format.  If 'target_defaulted' has been set, each
7023possible target type is tried to see if it recognizes the specified
7024format.  'bfd_check_format' returns 'TRUE' when the caller guesses
7025right.
7026* Menu:
7027
7028* bfd_target::
7029
7030
7031File: bfd.info,  Node: bfd_target,  Prev: Targets,  Up: Targets
7032
70332.12.1 bfd_target
7034-----------------
7035
7036*Description*
7037This structure contains everything that BFD knows about a target.  It
7038includes things like its byte order, name, and which routines to call to
7039do various operations.
7040
7041   Every BFD points to a target structure with its 'xvec' member.
7042
7043   The macros below are used to dispatch to functions through the
7044'bfd_target' vector.  They are used in a number of macros further down
7045in 'bfd.h', and are also used when calling various routines by hand
7046inside the BFD implementation.  The ARGLIST argument must be
7047parenthesized; it contains all the arguments to the called function.
7048
7049   They make the documentation (more) unpleasant to read, so if someone
7050wants to fix this and not break the above, please do.
7051     #define BFD_SEND(bfd, message, arglist) \
7052       ((*((bfd)->xvec->message)) arglist)
7053
7054     #ifdef DEBUG_BFD_SEND
7055     #undef BFD_SEND
7056     #define BFD_SEND(bfd, message, arglist) \
7057       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7058         ((*((bfd)->xvec->message)) arglist) : \
7059         (bfd_assert (__FILE__,__LINE__), NULL))
7060     #endif
7061   For operations which index on the BFD format:
7062     #define BFD_SEND_FMT(bfd, message, arglist) \
7063       (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
7064
7065     #ifdef DEBUG_BFD_SEND
7066     #undef BFD_SEND_FMT
7067     #define BFD_SEND_FMT(bfd, message, arglist) \
7068       (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
7069        (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
7070        (bfd_assert (__FILE__,__LINE__), NULL))
7071     #endif
7072
7073   This is the structure which defines the type of BFD this is.  The
7074'xvec' member of the struct 'bfd' itself points here.  Each module that
7075implements access to a different target under BFD, defines one of these.
7076
7077   FIXME, these names should be rationalised with the names of the entry
7078points which call them.  Too bad we can't have one macro to define them
7079both!
7080     enum bfd_flavour
7081     {
7082       /* N.B. Update bfd_flavour_name if you change this.  */
7083       bfd_target_unknown_flavour,
7084       bfd_target_aout_flavour,
7085       bfd_target_coff_flavour,
7086       bfd_target_ecoff_flavour,
7087       bfd_target_xcoff_flavour,
7088       bfd_target_elf_flavour,
7089       bfd_target_tekhex_flavour,
7090       bfd_target_srec_flavour,
7091       bfd_target_verilog_flavour,
7092       bfd_target_ihex_flavour,
7093       bfd_target_som_flavour,
7094       bfd_target_os9k_flavour,
7095       bfd_target_versados_flavour,
7096       bfd_target_msdos_flavour,
7097       bfd_target_ovax_flavour,
7098       bfd_target_evax_flavour,
7099       bfd_target_mmo_flavour,
7100       bfd_target_mach_o_flavour,
7101       bfd_target_pef_flavour,
7102       bfd_target_pef_xlib_flavour,
7103       bfd_target_sym_flavour
7104     };
7105
7106     enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
7107
7108     /* Forward declaration.  */
7109     typedef struct bfd_link_info _bfd_link_info;
7110
7111     /* Forward declaration.  */
7112     typedef struct flag_info flag_info;
7113
7114     typedef struct bfd_target
7115     {
7116       /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
7117       char *name;
7118
7119      /* The "flavour" of a back end is a general indication about
7120         the contents of a file.  */
7121       enum bfd_flavour flavour;
7122
7123       /* The order of bytes within the data area of a file.  */
7124       enum bfd_endian byteorder;
7125
7126      /* The order of bytes within the header parts of a file.  */
7127       enum bfd_endian header_byteorder;
7128
7129       /* A mask of all the flags which an executable may have set -
7130          from the set BFD_NO_FLAGS, HAS_RELOC, ...D_PAGED.  */
7131       flagword object_flags;
7132
7133      /* A mask of all the flags which a section may have set - from
7134         the set SEC_NO_FLAGS, SEC_ALLOC, ...SET_NEVER_LOAD.  */
7135       flagword section_flags;
7136
7137      /* The character normally found at the front of a symbol.
7138         (if any), perhaps `_'.  */
7139       char symbol_leading_char;
7140
7141      /* The pad character for file names within an archive header.  */
7142       char ar_pad_char;
7143
7144       /* The maximum number of characters in an archive header.  */
7145       unsigned char ar_max_namelen;
7146
7147       /* How well this target matches, used to select between various
7148          possible targets when more than one target matches.  */
7149       unsigned char match_priority;
7150
7151       /* Entries for byte swapping for data. These are different from the
7152          other entry points, since they don't take a BFD as the first argument.
7153          Certain other handlers could do the same.  */
7154       bfd_uint64_t   (*bfd_getx64) (const void *);
7155       bfd_int64_t    (*bfd_getx_signed_64) (const void *);
7156       void           (*bfd_putx64) (bfd_uint64_t, void *);
7157       bfd_vma        (*bfd_getx32) (const void *);
7158       bfd_signed_vma (*bfd_getx_signed_32) (const void *);
7159       void           (*bfd_putx32) (bfd_vma, void *);
7160       bfd_vma        (*bfd_getx16) (const void *);
7161       bfd_signed_vma (*bfd_getx_signed_16) (const void *);
7162       void           (*bfd_putx16) (bfd_vma, void *);
7163
7164       /* Byte swapping for the headers.  */
7165       bfd_uint64_t   (*bfd_h_getx64) (const void *);
7166       bfd_int64_t    (*bfd_h_getx_signed_64) (const void *);
7167       void           (*bfd_h_putx64) (bfd_uint64_t, void *);
7168       bfd_vma        (*bfd_h_getx32) (const void *);
7169       bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
7170       void           (*bfd_h_putx32) (bfd_vma, void *);
7171       bfd_vma        (*bfd_h_getx16) (const void *);
7172       bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
7173       void           (*bfd_h_putx16) (bfd_vma, void *);
7174
7175       /* Format dependent routines: these are vectors of entry points
7176          within the target vector structure, one for each format to check.  */
7177
7178       /* Check the format of a file being read.  Return a bfd_target * or zero.  */
7179       const struct bfd_target *
7180                   (*_bfd_check_format[bfd_type_end]) (bfd *);
7181
7182       /* Set the format of a file being written.  */
7183       bfd_boolean (*_bfd_set_format[bfd_type_end]) (bfd *);
7184
7185       /* Write cached information into a file being written, at bfd_close.  */
7186       bfd_boolean (*_bfd_write_contents[bfd_type_end]) (bfd *);
7187
7188   The general target vector.  These vectors are initialized using the
7189BFD_JUMP_TABLE macros.
7190
7191       /* Generic entry points.  */
7192     #define BFD_JUMP_TABLE_GENERIC(NAME) \
7193       NAME##_close_and_cleanup, \
7194       NAME##_bfd_free_cached_info, \
7195       NAME##_new_section_hook, \
7196       NAME##_get_section_contents, \
7197       NAME##_get_section_contents_in_window
7198
7199       /* Called when the BFD is being closed to do any necessary cleanup.  */
7200       bfd_boolean (*_close_and_cleanup) (bfd *);
7201       /* Ask the BFD to free all cached information.  */
7202       bfd_boolean (*_bfd_free_cached_info) (bfd *);
7203       /* Called when a new section is created.  */
7204       bfd_boolean (*_new_section_hook) (bfd *, sec_ptr);
7205       /* Read the contents of a section.  */
7206       bfd_boolean (*_bfd_get_section_contents) (bfd *, sec_ptr, void *, file_ptr,
7207                                                 bfd_size_type);
7208       bfd_boolean (*_bfd_get_section_contents_in_window) (bfd *, sec_ptr,
7209                                                           bfd_window *, file_ptr,
7210                                                           bfd_size_type);
7211
7212       /* Entry points to copy private data.  */
7213     #define BFD_JUMP_TABLE_COPY(NAME) \
7214       NAME##_bfd_copy_private_bfd_data, \
7215       NAME##_bfd_merge_private_bfd_data, \
7216       _bfd_generic_init_private_section_data, \
7217       NAME##_bfd_copy_private_section_data, \
7218       NAME##_bfd_copy_private_symbol_data, \
7219       NAME##_bfd_copy_private_header_data, \
7220       NAME##_bfd_set_private_flags, \
7221       NAME##_bfd_print_private_bfd_data
7222
7223       /* Called to copy BFD general private data from one object file
7224          to another.  */
7225       bfd_boolean (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
7226       /* Called to merge BFD general private data from one object file
7227          to a common output file when linking.  */
7228       bfd_boolean (*_bfd_merge_private_bfd_data) (bfd *, struct bfd_link_info *);
7229       /* Called to initialize BFD private section data from one object file
7230          to another.  */
7231     #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
7232            BFD_SEND (obfd, _bfd_init_private_section_data, \
7233                      (ibfd, isec, obfd, osec, link_info))
7234       bfd_boolean (*_bfd_init_private_section_data) (bfd *, sec_ptr, bfd *,
7235                                                      sec_ptr,
7236                                                      struct bfd_link_info *);
7237       /* Called to copy BFD private section data from one object file
7238          to another.  */
7239       bfd_boolean (*_bfd_copy_private_section_data) (bfd *, sec_ptr, bfd *,
7240                                                      sec_ptr);
7241       /* Called to copy BFD private symbol data from one symbol
7242          to another.  */
7243       bfd_boolean (*_bfd_copy_private_symbol_data) (bfd *, asymbol *, bfd *,
7244                                                     asymbol *);
7245       /* Called to copy BFD private header data from one object file
7246          to another.  */
7247       bfd_boolean (*_bfd_copy_private_header_data) (bfd *, bfd *);
7248       /* Called to set private backend flags.  */
7249       bfd_boolean (*_bfd_set_private_flags) (bfd *, flagword);
7250
7251       /* Called to print private BFD data.  */
7252       bfd_boolean (*_bfd_print_private_bfd_data) (bfd *, void *);
7253
7254       /* Core file entry points.  */
7255     #define BFD_JUMP_TABLE_CORE(NAME) \
7256       NAME##_core_file_failing_command, \
7257       NAME##_core_file_failing_signal, \
7258       NAME##_core_file_matches_executable_p, \
7259       NAME##_core_file_pid
7260
7261       char *      (*_core_file_failing_command) (bfd *);
7262       int         (*_core_file_failing_signal) (bfd *);
7263       bfd_boolean (*_core_file_matches_executable_p) (bfd *, bfd *);
7264       int         (*_core_file_pid) (bfd *);
7265
7266       /* Archive entry points.  */
7267     #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
7268       NAME##_slurp_armap, \
7269       NAME##_slurp_extended_name_table, \
7270       NAME##_construct_extended_name_table, \
7271       NAME##_truncate_arname, \
7272       NAME##_write_armap, \
7273       NAME##_read_ar_hdr, \
7274       NAME##_write_ar_hdr, \
7275       NAME##_openr_next_archived_file, \
7276       NAME##_get_elt_at_index, \
7277       NAME##_generic_stat_arch_elt, \
7278       NAME##_update_armap_timestamp
7279
7280       bfd_boolean (*_bfd_slurp_armap) (bfd *);
7281       bfd_boolean (*_bfd_slurp_extended_name_table) (bfd *);
7282       bfd_boolean (*_bfd_construct_extended_name_table) (bfd *, char **,
7283                                                          bfd_size_type *,
7284                                                          const char **);
7285       void        (*_bfd_truncate_arname) (bfd *, const char *, char *);
7286       bfd_boolean (*write_armap) (bfd *, unsigned int, struct orl *,
7287                                   unsigned int, int);
7288       void *      (*_bfd_read_ar_hdr_fn) (bfd *);
7289       bfd_boolean (*_bfd_write_ar_hdr_fn) (bfd *, bfd *);
7290       bfd *       (*openr_next_archived_file) (bfd *, bfd *);
7291     #define bfd_get_elt_at_index(b,i) \
7292            BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
7293       bfd *       (*_bfd_get_elt_at_index) (bfd *, symindex);
7294       int         (*_bfd_stat_arch_elt) (bfd *, struct stat *);
7295       bfd_boolean (*_bfd_update_armap_timestamp) (bfd *);
7296
7297       /* Entry points used for symbols.  */
7298     #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
7299       NAME##_get_symtab_upper_bound, \
7300       NAME##_canonicalize_symtab, \
7301       NAME##_make_empty_symbol, \
7302       NAME##_print_symbol, \
7303       NAME##_get_symbol_info, \
7304       NAME##_get_symbol_version_string, \
7305       NAME##_bfd_is_local_label_name, \
7306       NAME##_bfd_is_target_special_symbol, \
7307       NAME##_get_lineno, \
7308       NAME##_find_nearest_line, \
7309       NAME##_find_line, \
7310       NAME##_find_inliner_info, \
7311       NAME##_bfd_make_debug_symbol, \
7312       NAME##_read_minisymbols, \
7313       NAME##_minisymbol_to_symbol
7314
7315       long        (*_bfd_get_symtab_upper_bound) (bfd *);
7316       long        (*_bfd_canonicalize_symtab) (bfd *, struct bfd_symbol **);
7317       struct bfd_symbol *
7318                   (*_bfd_make_empty_symbol) (bfd *);
7319       void        (*_bfd_print_symbol) (bfd *, void *, struct bfd_symbol *,
7320                                         bfd_print_symbol_type);
7321     #define bfd_print_symbol(b,p,s,e) \
7322            BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
7323       void        (*_bfd_get_symbol_info) (bfd *, struct bfd_symbol *,
7324                                            symbol_info *);
7325     #define bfd_get_symbol_info(b,p,e) \
7326            BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
7327       const char *(*_bfd_get_symbol_version_string) (bfd *, struct bfd_symbol *,
7328                                                      bfd_boolean *);
7329     #define bfd_get_symbol_version_string(b,s,h) \
7330            BFD_SEND (b, _bfd_get_symbol_version_string, (b,s,h))
7331       bfd_boolean (*_bfd_is_local_label_name) (bfd *, const char *);
7332       bfd_boolean (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
7333       alent *     (*_get_lineno) (bfd *, struct bfd_symbol *);
7334       bfd_boolean (*_bfd_find_nearest_line) (bfd *, struct bfd_symbol **,
7335                                              struct bfd_section *, bfd_vma,
7336                                              const char **, const char **,
7337                                              unsigned int *, unsigned int *);
7338       bfd_boolean (*_bfd_find_line) (bfd *, struct bfd_symbol **,
7339                                      struct bfd_symbol *, const char **,
7340                                      unsigned int *);
7341       bfd_boolean (*_bfd_find_inliner_info)
7342         (bfd *, const char **, const char **, unsigned int *);
7343      /* Back-door to allow format-aware applications to create debug symbols
7344         while using BFD for everything else.  Currently used by the assembler
7345         when creating COFF files.  */
7346       asymbol *   (*_bfd_make_debug_symbol) (bfd *, void *, unsigned long size);
7347     #define bfd_read_minisymbols(b, d, m, s) \
7348            BFD_SEND (b, _read_minisymbols, (b, d, m, s))
7349       long        (*_read_minisymbols) (bfd *, bfd_boolean, void **,
7350                                         unsigned int *);
7351     #define bfd_minisymbol_to_symbol(b, d, m, f) \
7352            BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
7353       asymbol *   (*_minisymbol_to_symbol) (bfd *, bfd_boolean, const void *,
7354                                             asymbol *);
7355
7356       /* Routines for relocs.  */
7357     #define BFD_JUMP_TABLE_RELOCS(NAME) \
7358       NAME##_get_reloc_upper_bound, \
7359       NAME##_canonicalize_reloc, \
7360       NAME##_set_reloc, \
7361       NAME##_bfd_reloc_type_lookup, \
7362       NAME##_bfd_reloc_name_lookup
7363
7364       long        (*_get_reloc_upper_bound) (bfd *, sec_ptr);
7365       long        (*_bfd_canonicalize_reloc) (bfd *, sec_ptr, arelent **,
7366                                               struct bfd_symbol **);
7367       void        (*_bfd_set_reloc) (bfd *, sec_ptr, arelent **, unsigned int);
7368       /* See documentation on reloc types.  */
7369       reloc_howto_type *
7370                   (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
7371       reloc_howto_type *
7372                   (*reloc_name_lookup) (bfd *, const char *);
7373
7374       /* Routines used when writing an object file.  */
7375     #define BFD_JUMP_TABLE_WRITE(NAME) \
7376       NAME##_set_arch_mach, \
7377       NAME##_set_section_contents
7378
7379       bfd_boolean (*_bfd_set_arch_mach) (bfd *, enum bfd_architecture,
7380                                          unsigned long);
7381       bfd_boolean (*_bfd_set_section_contents) (bfd *, sec_ptr, const void *,
7382                                                 file_ptr, bfd_size_type);
7383
7384       /* Routines used by the linker.  */
7385     #define BFD_JUMP_TABLE_LINK(NAME) \
7386       NAME##_sizeof_headers, \
7387       NAME##_bfd_get_relocated_section_contents, \
7388       NAME##_bfd_relax_section, \
7389       NAME##_bfd_link_hash_table_create, \
7390       NAME##_bfd_link_add_symbols, \
7391       NAME##_bfd_link_just_syms, \
7392       NAME##_bfd_copy_link_hash_symbol_type, \
7393       NAME##_bfd_final_link, \
7394       NAME##_bfd_link_split_section, \
7395       NAME##_bfd_link_check_relocs, \
7396       NAME##_bfd_gc_sections, \
7397       NAME##_bfd_lookup_section_flags, \
7398       NAME##_bfd_merge_sections, \
7399       NAME##_bfd_is_group_section, \
7400       NAME##_bfd_discard_group, \
7401       NAME##_section_already_linked, \
7402       NAME##_bfd_define_common_symbol, \
7403       NAME##_bfd_link_hide_symbol, \
7404       NAME##_bfd_define_start_stop
7405
7406       int         (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
7407       bfd_byte *  (*_bfd_get_relocated_section_contents) (bfd *,
7408                                                           struct bfd_link_info *,
7409                                                           struct bfd_link_order *,
7410                                                           bfd_byte *, bfd_boolean,
7411                                                           struct bfd_symbol **);
7412
7413       bfd_boolean (*_bfd_relax_section) (bfd *, struct bfd_section *,
7414                                          struct bfd_link_info *, bfd_boolean *);
7415
7416       /* Create a hash table for the linker.  Different backends store
7417          different information in this table.  */
7418       struct bfd_link_hash_table *
7419                   (*_bfd_link_hash_table_create) (bfd *);
7420
7421       /* Add symbols from this object file into the hash table.  */
7422       bfd_boolean (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
7423
7424       /* Indicate that we are only retrieving symbol values from this section.  */
7425       void        (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
7426
7427       /* Copy the symbol type and other attributes for a linker script
7428          assignment of one symbol to another.  */
7429     #define bfd_copy_link_hash_symbol_type(b, t, f) \
7430            BFD_SEND (b, _bfd_copy_link_hash_symbol_type, (b, t, f))
7431       void        (*_bfd_copy_link_hash_symbol_type) (bfd *,
7432                                                       struct bfd_link_hash_entry *,
7433                                                       struct bfd_link_hash_entry *);
7434
7435       /* Do a link based on the link_order structures attached to each
7436          section of the BFD.  */
7437       bfd_boolean (*_bfd_final_link) (bfd *, struct bfd_link_info *);
7438
7439       /* Should this section be split up into smaller pieces during linking.  */
7440       bfd_boolean (*_bfd_link_split_section) (bfd *, struct bfd_section *);
7441
7442       /* Check the relocations in the bfd for validity.  */
7443       bfd_boolean (* _bfd_link_check_relocs)(bfd *, struct bfd_link_info *);
7444
7445       /* Remove sections that are not referenced from the output.  */
7446       bfd_boolean (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
7447
7448       /* Sets the bitmask of allowed and disallowed section flags.  */
7449       bfd_boolean (*_bfd_lookup_section_flags) (struct bfd_link_info *,
7450                                                 struct flag_info *, asection *);
7451
7452       /* Attempt to merge SEC_MERGE sections.  */
7453       bfd_boolean (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
7454
7455       /* Is this section a member of a group?  */
7456       bfd_boolean (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
7457
7458       /* Discard members of a group.  */
7459       bfd_boolean (*_bfd_discard_group) (bfd *, struct bfd_section *);
7460
7461       /* Check if SEC has been already linked during a reloceatable or
7462          final link.  */
7463       bfd_boolean (*_section_already_linked) (bfd *, asection *,
7464                                               struct bfd_link_info *);
7465
7466       /* Define a common symbol.  */
7467       bfd_boolean (*_bfd_define_common_symbol) (bfd *, struct bfd_link_info *,
7468                                                 struct bfd_link_hash_entry *);
7469
7470       /* Hide a symbol.  */
7471       void (*_bfd_link_hide_symbol) (bfd *, struct bfd_link_info *,
7472                                      struct bfd_link_hash_entry *);
7473
7474       /* Define a __start, __stop, .startof. or .sizeof. symbol.  */
7475       struct bfd_link_hash_entry *
7476                   (*_bfd_define_start_stop) (struct bfd_link_info *, const char *,
7477                                              asection *);
7478
7479       /* Routines to handle dynamic symbols and relocs.  */
7480     #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
7481       NAME##_get_dynamic_symtab_upper_bound, \
7482       NAME##_canonicalize_dynamic_symtab, \
7483       NAME##_get_synthetic_symtab, \
7484       NAME##_get_dynamic_reloc_upper_bound, \
7485       NAME##_canonicalize_dynamic_reloc
7486
7487       /* Get the amount of memory required to hold the dynamic symbols.  */
7488       long        (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
7489       /* Read in the dynamic symbols.  */
7490       long        (*_bfd_canonicalize_dynamic_symtab) (bfd *, struct bfd_symbol **);
7491       /* Create synthetized symbols.  */
7492       long        (*_bfd_get_synthetic_symtab) (bfd *, long, struct bfd_symbol **,
7493                                                 long, struct bfd_symbol **,
7494                                                 struct bfd_symbol **);
7495       /* Get the amount of memory required to hold the dynamic relocs.  */
7496       long        (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
7497       /* Read in the dynamic relocs.  */
7498       long        (*_bfd_canonicalize_dynamic_reloc) (bfd *, arelent **,
7499                                                       struct bfd_symbol **);
7500
7501   A pointer to an alternative bfd_target in case the current one is not
7502satisfactory.  This can happen when the target cpu supports both big and
7503little endian code, and target chosen by the linker has the wrong
7504endianness.  The function open_output() in ld/ldlang.c uses this field
7505to find an alternative output format that is suitable.
7506       /* Opposite endian version of this target.  */
7507       const struct bfd_target *alternative_target;
7508
7509       /* Data for use by back-end routines, which isn't
7510          generic enough to belong in this structure.  */
7511       const void *backend_data;
7512
7513     } bfd_target;
7514
7515
75162.12.1.1 'bfd_set_default_target'
7517.................................
7518
7519*Synopsis*
7520     bfd_boolean bfd_set_default_target (const char *name);
7521   *Description*
7522Set the default target vector to use when recognizing a BFD. This takes
7523the name of the target, which may be a BFD target name or a
7524configuration triplet.
7525
75262.12.1.2 'bfd_find_target'
7527..........................
7528
7529*Synopsis*
7530     const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
7531   *Description*
7532Return a pointer to the transfer vector for the object target named
7533TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7534environment variable 'GNUTARGET'; if that is null or not defined, then
7535choose the first entry in the target list.  Passing in the string
7536"default" or setting the environment variable to "default" will cause
7537the first entry in the target list to be returned, and
7538"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7539causes 'bfd_check_format' to loop over all the targets to find the one
7540that matches the file being read.
7541
75422.12.1.3 'bfd_get_target_info'
7543..............................
7544
7545*Synopsis*
7546     const bfd_target *bfd_get_target_info (const char *target_name,
7547         bfd *abfd,
7548         bfd_boolean *is_bigendian,
7549         int *underscoring,
7550         const char **def_target_arch);
7551   *Description*
7552Return a pointer to the transfer vector for the object target named
7553TARGET_NAME.  If TARGET_NAME is 'NULL', choose the one in the
7554environment variable 'GNUTARGET'; if that is null or not defined, then
7555choose the first entry in the target list.  Passing in the string
7556"default" or setting the environment variable to "default" will cause
7557the first entry in the target list to be returned, and
7558"target_defaulted" will be set in the BFD if ABFD isn't 'NULL'.  This
7559causes 'bfd_check_format' to loop over all the targets to find the one
7560that matches the file being read.  If IS_BIGENDIAN is not 'NULL', then
7561set this value to target's endian mode.  True for big-endian, FALSE for
7562little-endian or for invalid target.  If UNDERSCORING is not 'NULL',
7563then set this value to target's underscoring mode.  Zero for
7564none-underscoring, -1 for invalid target, else the value of target
7565vector's symbol underscoring.  If DEF_TARGET_ARCH is not 'NULL', then
7566set it to the architecture string specified by the target_name.
7567
75682.12.1.4 'bfd_target_list'
7569..........................
7570
7571*Synopsis*
7572     const char ** bfd_target_list (void);
7573   *Description*
7574Return a freshly malloced NULL-terminated vector of the names of all the
7575valid BFD targets.  Do not modify the names.
7576
75772.12.1.5 'bfd_iterate_over_targets'
7578...................................
7579
7580*Synopsis*
7581     const bfd_target *bfd_iterate_over_targets
7582        (int (*func) (const bfd_target *, void *),
7583         void *data);
7584   *Description*
7585Call FUNC for each target in the list of BFD target vectors, passing
7586DATA to FUNC.  Stop iterating if FUNC returns a non-zero result, and
7587return that target vector.  Return NULL if FUNC always returns zero.
7588
75892.12.1.6 'bfd_flavour_name'
7590...........................
7591
7592*Synopsis*
7593     const char *bfd_flavour_name (enum bfd_flavour flavour);
7594   *Description*
7595Return the string form of FLAVOUR.
7596
7597
7598File: bfd.info,  Node: Architectures,  Next: Opening and Closing,  Prev: Targets,  Up: BFD front end
7599
76002.13 Architectures
7601==================
7602
7603BFD keeps one atom in a BFD describing the architecture of the data
7604attached to the BFD: a pointer to a 'bfd_arch_info_type'.
7605
7606   Pointers to structures can be requested independently of a BFD so
7607that an architecture's information can be interrogated without access to
7608an open BFD.
7609
7610   The architecture information is provided by each architecture
7611package.  The set of default architectures is selected by the macro
7612'SELECT_ARCHITECTURES'.  This is normally set up in the
7613'config/TARGET.mt' file of your choice.  If the name is not defined,
7614then all the architectures supported are included.
7615
7616   When BFD starts up, all the architectures are called with an
7617initialize method.  It is up to the architecture back end to insert as
7618many items into the list of architectures as it wants to; generally this
7619would be one for each machine and one for the default case (an item with
7620a machine field of 0).
7621
7622   BFD's idea of an architecture is implemented in 'archures.c'.
7623
76242.13.1 bfd_architecture
7625-----------------------
7626
7627*Description*
7628This enum gives the object file's CPU architecture, in a global
7629sense--i.e., what processor family does it belong to?  Another field
7630indicates which processor within the family is in use.  The machine
7631gives a number which distinguishes different versions of the
7632architecture, containing, for example, 68020 for Motorola 68020.
7633     enum bfd_architecture
7634     {
7635       bfd_arch_unknown,   /* File arch not known.  */
7636       bfd_arch_obscure,   /* Arch known, not one of these.  */
7637       bfd_arch_m68k,      /* Motorola 68xxx.  */
7638     #define bfd_mach_m68000                1
7639     #define bfd_mach_m68008                2
7640     #define bfd_mach_m68010                3
7641     #define bfd_mach_m68020                4
7642     #define bfd_mach_m68030                5
7643     #define bfd_mach_m68040                6
7644     #define bfd_mach_m68060                7
7645     #define bfd_mach_cpu32                 8
7646     #define bfd_mach_fido                  9
7647     #define bfd_mach_mcf_isa_a_nodiv       10
7648     #define bfd_mach_mcf_isa_a             11
7649     #define bfd_mach_mcf_isa_a_mac         12
7650     #define bfd_mach_mcf_isa_a_emac        13
7651     #define bfd_mach_mcf_isa_aplus         14
7652     #define bfd_mach_mcf_isa_aplus_mac     15
7653     #define bfd_mach_mcf_isa_aplus_emac    16
7654     #define bfd_mach_mcf_isa_b_nousp       17
7655     #define bfd_mach_mcf_isa_b_nousp_mac   18
7656     #define bfd_mach_mcf_isa_b_nousp_emac  19
7657     #define bfd_mach_mcf_isa_b             20
7658     #define bfd_mach_mcf_isa_b_mac         21
7659     #define bfd_mach_mcf_isa_b_emac        22
7660     #define bfd_mach_mcf_isa_b_float       23
7661     #define bfd_mach_mcf_isa_b_float_mac   24
7662     #define bfd_mach_mcf_isa_b_float_emac  25
7663     #define bfd_mach_mcf_isa_c             26
7664     #define bfd_mach_mcf_isa_c_mac         27
7665     #define bfd_mach_mcf_isa_c_emac        28
7666     #define bfd_mach_mcf_isa_c_nodiv       29
7667     #define bfd_mach_mcf_isa_c_nodiv_mac   30
7668     #define bfd_mach_mcf_isa_c_nodiv_emac  31
7669       bfd_arch_vax,       /* DEC Vax.  */
7670
7671       bfd_arch_or1k,      /* OpenRISC 1000.  */
7672     #define bfd_mach_or1k          1
7673     #define bfd_mach_or1knd        2
7674
7675       bfd_arch_sparc,     /* SPARC.  */
7676     #define bfd_mach_sparc                 1
7677     /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
7678     #define bfd_mach_sparc_sparclet        2
7679     #define bfd_mach_sparc_sparclite       3
7680     #define bfd_mach_sparc_v8plus          4
7681     #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
7682     #define bfd_mach_sparc_sparclite_le    6
7683     #define bfd_mach_sparc_v9              7
7684     #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
7685     #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
7686     #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
7687     #define bfd_mach_sparc_v8plusc         11 /* with UA2005 and T1 add'ns.  */
7688     #define bfd_mach_sparc_v9c             12 /* with UA2005 and T1 add'ns.  */
7689     #define bfd_mach_sparc_v8plusd         13 /* with UA2007 and T3 add'ns.  */
7690     #define bfd_mach_sparc_v9d             14 /* with UA2007 and T3 add'ns.  */
7691     #define bfd_mach_sparc_v8pluse         15 /* with OSA2001 and T4 add'ns (no IMA).  */
7692     #define bfd_mach_sparc_v9e             16 /* with OSA2001 and T4 add'ns (no IMA).  */
7693     #define bfd_mach_sparc_v8plusv         17 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7694     #define bfd_mach_sparc_v9v             18 /* with OSA2011 and T4 and IMA and FJMAU add'ns.  */
7695     #define bfd_mach_sparc_v8plusm         19 /* with OSA2015 and M7 add'ns.  */
7696     #define bfd_mach_sparc_v9m             20 /* with OSA2015 and M7 add'ns.  */
7697     #define bfd_mach_sparc_v8plusm8        21 /* with OSA2017 and M8 add'ns.  */
7698     #define bfd_mach_sparc_v9m8            22 /* with OSA2017 and M8 add'ns.  */
7699     /* Nonzero if MACH has the v9 instruction set.  */
7700     #define bfd_mach_sparc_v9_p(mach) \
7701       ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9m8 \
7702        && (mach) != bfd_mach_sparc_sparclite_le)
7703     /* Nonzero if MACH is a 64 bit sparc architecture.  */
7704     #define bfd_mach_sparc_64bit_p(mach) \
7705       ((mach) >= bfd_mach_sparc_v9 \
7706        && (mach) != bfd_mach_sparc_v8plusb \
7707        && (mach) != bfd_mach_sparc_v8plusc \
7708        && (mach) != bfd_mach_sparc_v8plusd \
7709        && (mach) != bfd_mach_sparc_v8pluse \
7710        && (mach) != bfd_mach_sparc_v8plusv \
7711        && (mach) != bfd_mach_sparc_v8plusm \
7712        && (mach) != bfd_mach_sparc_v8plusm8)
7713       bfd_arch_spu,       /* PowerPC SPU.  */
7714     #define bfd_mach_spu           256
7715       bfd_arch_mips,      /* MIPS Rxxxx.  */
7716     #define bfd_mach_mips3000              3000
7717     #define bfd_mach_mips3900              3900
7718     #define bfd_mach_mips4000              4000
7719     #define bfd_mach_mips4010              4010
7720     #define bfd_mach_mips4100              4100
7721     #define bfd_mach_mips4111              4111
7722     #define bfd_mach_mips4120              4120
7723     #define bfd_mach_mips4300              4300
7724     #define bfd_mach_mips4400              4400
7725     #define bfd_mach_mips4600              4600
7726     #define bfd_mach_mips4650              4650
7727     #define bfd_mach_mips5000              5000
7728     #define bfd_mach_mips5400              5400
7729     #define bfd_mach_mips5500              5500
7730     #define bfd_mach_mips5900              5900
7731     #define bfd_mach_mips6000              6000
7732     #define bfd_mach_mips7000              7000
7733     #define bfd_mach_mips8000              8000
7734     #define bfd_mach_mips9000              9000
7735     #define bfd_mach_mips10000             10000
7736     #define bfd_mach_mips12000             12000
7737     #define bfd_mach_mips14000             14000
7738     #define bfd_mach_mips16000             16000
7739     #define bfd_mach_mips16                16
7740     #define bfd_mach_mips5                 5
7741     #define bfd_mach_mips_loongson_2e      3001
7742     #define bfd_mach_mips_loongson_2f      3002
7743     #define bfd_mach_mips_loongson_3a      3003
7744     #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01.  */
7745     #define bfd_mach_mips_octeon           6501
7746     #define bfd_mach_mips_octeonp          6601
7747     #define bfd_mach_mips_octeon2          6502
7748     #define bfd_mach_mips_octeon3          6503
7749     #define bfd_mach_mips_xlr              887682   /* decimal 'XLR'.  */
7750     #define bfd_mach_mips_interaptiv_mr2   736550   /* decimal 'IA2'.  */
7751     #define bfd_mach_mipsisa32             32
7752     #define bfd_mach_mipsisa32r2           33
7753     #define bfd_mach_mipsisa32r3           34
7754     #define bfd_mach_mipsisa32r5           36
7755     #define bfd_mach_mipsisa32r6           37
7756     #define bfd_mach_mipsisa64             64
7757     #define bfd_mach_mipsisa64r2           65
7758     #define bfd_mach_mipsisa64r3           66
7759     #define bfd_mach_mipsisa64r5           68
7760     #define bfd_mach_mipsisa64r6           69
7761     #define bfd_mach_mips_micromips        96
7762       bfd_arch_i386,      /* Intel 386.  */
7763     #define bfd_mach_i386_intel_syntax     (1 << 0)
7764     #define bfd_mach_i386_i8086            (1 << 1)
7765     #define bfd_mach_i386_i386             (1 << 2)
7766     #define bfd_mach_x86_64                (1 << 3)
7767     #define bfd_mach_x64_32                (1 << 4)
7768     #define bfd_mach_i386_i386_intel_syntax (bfd_mach_i386_i386 | bfd_mach_i386_intel_syntax)
7769     #define bfd_mach_x86_64_intel_syntax   (bfd_mach_x86_64 | bfd_mach_i386_intel_syntax)
7770     #define bfd_mach_x64_32_intel_syntax   (bfd_mach_x64_32 | bfd_mach_i386_intel_syntax)
7771       bfd_arch_l1om,      /* Intel L1OM.  */
7772     #define bfd_mach_l1om                  (1 << 5)
7773     #define bfd_mach_l1om_intel_syntax     (bfd_mach_l1om | bfd_mach_i386_intel_syntax)
7774       bfd_arch_k1om,      /* Intel K1OM.  */
7775     #define bfd_mach_k1om                  (1 << 6)
7776     #define bfd_mach_k1om_intel_syntax     (bfd_mach_k1om | bfd_mach_i386_intel_syntax)
7777     #define bfd_mach_i386_nacl             (1 << 7)
7778     #define bfd_mach_i386_i386_nacl        (bfd_mach_i386_i386 | bfd_mach_i386_nacl)
7779     #define bfd_mach_x86_64_nacl           (bfd_mach_x86_64 | bfd_mach_i386_nacl)
7780     #define bfd_mach_x64_32_nacl           (bfd_mach_x64_32 | bfd_mach_i386_nacl)
7781       bfd_arch_iamcu,     /* Intel MCU.  */
7782     #define bfd_mach_iamcu                 (1 << 8)
7783     #define bfd_mach_i386_iamcu            (bfd_mach_i386_i386 | bfd_mach_iamcu)
7784     #define bfd_mach_i386_iamcu_intel_syntax (bfd_mach_i386_iamcu | bfd_mach_i386_intel_syntax)
7785       bfd_arch_romp,      /* IBM ROMP PC/RT.  */
7786       bfd_arch_convex,    /* Convex.  */
7787       bfd_arch_m98k,      /* Motorola 98xxx.  */
7788       bfd_arch_pyramid,   /* Pyramid Technology.  */
7789       bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300).  */
7790     #define bfd_mach_h8300         1
7791     #define bfd_mach_h8300h        2
7792     #define bfd_mach_h8300s        3
7793     #define bfd_mach_h8300hn       4
7794     #define bfd_mach_h8300sn       5
7795     #define bfd_mach_h8300sx       6
7796     #define bfd_mach_h8300sxn      7
7797       bfd_arch_pdp11,     /* DEC PDP-11.  */
7798       bfd_arch_plugin,
7799       bfd_arch_powerpc,   /* PowerPC.  */
7800     #define bfd_mach_ppc           32
7801     #define bfd_mach_ppc64         64
7802     #define bfd_mach_ppc_403       403
7803     #define bfd_mach_ppc_403gc     4030
7804     #define bfd_mach_ppc_405       405
7805     #define bfd_mach_ppc_505       505
7806     #define bfd_mach_ppc_601       601
7807     #define bfd_mach_ppc_602       602
7808     #define bfd_mach_ppc_603       603
7809     #define bfd_mach_ppc_ec603e    6031
7810     #define bfd_mach_ppc_604       604
7811     #define bfd_mach_ppc_620       620
7812     #define bfd_mach_ppc_630       630
7813     #define bfd_mach_ppc_750       750
7814     #define bfd_mach_ppc_860       860
7815     #define bfd_mach_ppc_a35       35
7816     #define bfd_mach_ppc_rs64ii    642
7817     #define bfd_mach_ppc_rs64iii   643
7818     #define bfd_mach_ppc_7400      7400
7819     #define bfd_mach_ppc_e500      500
7820     #define bfd_mach_ppc_e500mc    5001
7821     #define bfd_mach_ppc_e500mc64  5005
7822     #define bfd_mach_ppc_e5500     5006
7823     #define bfd_mach_ppc_e6500     5007
7824     #define bfd_mach_ppc_titan     83
7825     #define bfd_mach_ppc_vle       84
7826       bfd_arch_rs6000,    /* IBM RS/6000.  */
7827     #define bfd_mach_rs6k          6000
7828     #define bfd_mach_rs6k_rs1      6001
7829     #define bfd_mach_rs6k_rsc      6003
7830     #define bfd_mach_rs6k_rs2      6002
7831       bfd_arch_hppa,      /* HP PA RISC.  */
7832     #define bfd_mach_hppa10        10
7833     #define bfd_mach_hppa11        11
7834     #define bfd_mach_hppa20        20
7835     #define bfd_mach_hppa20w       25
7836       bfd_arch_d10v,      /* Mitsubishi D10V.  */
7837     #define bfd_mach_d10v          1
7838     #define bfd_mach_d10v_ts2      2
7839     #define bfd_mach_d10v_ts3      3
7840       bfd_arch_d30v,      /* Mitsubishi D30V.  */
7841       bfd_arch_dlx,       /* DLX.  */
7842       bfd_arch_m68hc11,   /* Motorola 68HC11.  */
7843       bfd_arch_m68hc12,   /* Motorola 68HC12.  */
7844     #define bfd_mach_m6812_default 0
7845     #define bfd_mach_m6812         1
7846     #define bfd_mach_m6812s        2
7847       bfd_arch_m9s12x,    /* Freescale S12X.  */
7848       bfd_arch_m9s12xg,   /* Freescale XGATE.  */
7849       bfd_arch_s12z,    /* Freescale S12Z.  */
7850     #define bfd_mach_s12z_default 0
7851       bfd_arch_z8k,       /* Zilog Z8000.  */
7852     #define bfd_mach_z8001         1
7853     #define bfd_mach_z8002         2
7854       bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH).  */
7855     #define bfd_mach_sh                            1
7856     #define bfd_mach_sh2                           0x20
7857     #define bfd_mach_sh_dsp                        0x2d
7858     #define bfd_mach_sh2a                          0x2a
7859     #define bfd_mach_sh2a_nofpu                    0x2b
7860     #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
7861     #define bfd_mach_sh2a_nofpu_or_sh3_nommu       0x2a2
7862     #define bfd_mach_sh2a_or_sh4                   0x2a3
7863     #define bfd_mach_sh2a_or_sh3e                  0x2a4
7864     #define bfd_mach_sh2e                          0x2e
7865     #define bfd_mach_sh3                           0x30
7866     #define bfd_mach_sh3_nommu                     0x31
7867     #define bfd_mach_sh3_dsp                       0x3d
7868     #define bfd_mach_sh3e                          0x3e
7869     #define bfd_mach_sh4                           0x40
7870     #define bfd_mach_sh4_nofpu                     0x41
7871     #define bfd_mach_sh4_nommu_nofpu               0x42
7872     #define bfd_mach_sh4a                          0x4a
7873     #define bfd_mach_sh4a_nofpu                    0x4b
7874     #define bfd_mach_sh4al_dsp                     0x4d
7875       bfd_arch_alpha,     /* Dec Alpha.  */
7876     #define bfd_mach_alpha_ev4     0x10
7877     #define bfd_mach_alpha_ev5     0x20
7878     #define bfd_mach_alpha_ev6     0x30
7879       bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
7880     #define bfd_mach_arm_unknown   0
7881     #define bfd_mach_arm_2         1
7882     #define bfd_mach_arm_2a        2
7883     #define bfd_mach_arm_3         3
7884     #define bfd_mach_arm_3M        4
7885     #define bfd_mach_arm_4         5
7886     #define bfd_mach_arm_4T        6
7887     #define bfd_mach_arm_5         7
7888     #define bfd_mach_arm_5T        8
7889     #define bfd_mach_arm_5TE       9
7890     #define bfd_mach_arm_XScale    10
7891     #define bfd_mach_arm_ep9312    11
7892     #define bfd_mach_arm_iWMMXt    12
7893     #define bfd_mach_arm_iWMMXt2   13
7894       bfd_arch_nds32,     /* Andes NDS32.  */
7895     #define bfd_mach_n1            1
7896     #define bfd_mach_n1h           2
7897     #define bfd_mach_n1h_v2        3
7898     #define bfd_mach_n1h_v3        4
7899     #define bfd_mach_n1h_v3m       5
7900       bfd_arch_ns32k,     /* National Semiconductors ns32000.  */
7901       bfd_arch_tic30,     /* Texas Instruments TMS320C30.  */
7902       bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X.  */
7903     #define bfd_mach_tic3x         30
7904     #define bfd_mach_tic4x         40
7905       bfd_arch_tic54x,    /* Texas Instruments TMS320C54X.  */
7906       bfd_arch_tic6x,     /* Texas Instruments TMS320C6X.  */
7907       bfd_arch_tic80,     /* TI TMS320c80 (MVP).  */
7908       bfd_arch_v850,      /* NEC V850.  */
7909       bfd_arch_v850_rh850,/* NEC V850 (using RH850 ABI).  */
7910     #define bfd_mach_v850          1
7911     #define bfd_mach_v850e         'E'
7912     #define bfd_mach_v850e1        '1'
7913     #define bfd_mach_v850e2        0x4532
7914     #define bfd_mach_v850e2v3      0x45325633
7915     #define bfd_mach_v850e3v5      0x45335635 /* ('E'|'3'|'V'|'5').  */
7916       bfd_arch_arc,       /* ARC Cores.  */
7917     #define bfd_mach_arc_a4        0
7918     #define bfd_mach_arc_a5        1
7919     #define bfd_mach_arc_arc600    2
7920     #define bfd_mach_arc_arc601    4
7921     #define bfd_mach_arc_arc700    3
7922     #define bfd_mach_arc_arcv2     5
7923      bfd_arch_m32c,       /* Renesas M16C/M32C.  */
7924     #define bfd_mach_m16c          0x75
7925     #define bfd_mach_m32c          0x78
7926       bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D).  */
7927     #define bfd_mach_m32r          1 /* For backwards compatibility.  */
7928     #define bfd_mach_m32rx         'x'
7929     #define bfd_mach_m32r2         '2'
7930       bfd_arch_mn10200,   /* Matsushita MN10200.  */
7931       bfd_arch_mn10300,   /* Matsushita MN10300.  */
7932     #define bfd_mach_mn10300       300
7933     #define bfd_mach_am33          330
7934     #define bfd_mach_am33_2        332
7935       bfd_arch_fr30,
7936     #define bfd_mach_fr30          0x46523330
7937       bfd_arch_frv,
7938     #define bfd_mach_frv           1
7939     #define bfd_mach_frvsimple     2
7940     #define bfd_mach_fr300         300
7941     #define bfd_mach_fr400         400
7942     #define bfd_mach_fr450         450
7943     #define bfd_mach_frvtomcat     499     /* fr500 prototype.  */
7944     #define bfd_mach_fr500         500
7945     #define bfd_mach_fr550         550
7946       bfd_arch_moxie,     /* The moxie processor.  */
7947     #define bfd_mach_moxie         1
7948       bfd_arch_ft32,      /* The ft32 processor.  */
7949     #define bfd_mach_ft32          1
7950     #define bfd_mach_ft32b         2
7951       bfd_arch_mcore,
7952       bfd_arch_mep,
7953     #define bfd_mach_mep           1
7954     #define bfd_mach_mep_h1        0x6831
7955     #define bfd_mach_mep_c5        0x6335
7956       bfd_arch_metag,
7957     #define bfd_mach_metag         1
7958       bfd_arch_ia64,      /* HP/Intel ia64.  */
7959     #define bfd_mach_ia64_elf64    64
7960     #define bfd_mach_ia64_elf32    32
7961       bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
7962     #define bfd_mach_ip2022        1
7963     #define bfd_mach_ip2022ext     2
7964      bfd_arch_iq2000,     /* Vitesse IQ2000.  */
7965     #define bfd_mach_iq2000        1
7966     #define bfd_mach_iq10          2
7967       bfd_arch_epiphany,  /* Adapteva EPIPHANY.  */
7968     #define bfd_mach_epiphany16    1
7969     #define bfd_mach_epiphany32    2
7970       bfd_arch_mt,
7971     #define bfd_mach_ms1           1
7972     #define bfd_mach_mrisc2        2
7973     #define bfd_mach_ms2           3
7974       bfd_arch_pj,
7975       bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
7976     #define bfd_mach_avr1          1
7977     #define bfd_mach_avr2          2
7978     #define bfd_mach_avr25         25
7979     #define bfd_mach_avr3          3
7980     #define bfd_mach_avr31         31
7981     #define bfd_mach_avr35         35
7982     #define bfd_mach_avr4          4
7983     #define bfd_mach_avr5          5
7984     #define bfd_mach_avr51         51
7985     #define bfd_mach_avr6          6
7986     #define bfd_mach_avrtiny       100
7987     #define bfd_mach_avrxmega1     101
7988     #define bfd_mach_avrxmega2     102
7989     #define bfd_mach_avrxmega3     103
7990     #define bfd_mach_avrxmega4     104
7991     #define bfd_mach_avrxmega5     105
7992     #define bfd_mach_avrxmega6     106
7993     #define bfd_mach_avrxmega7     107
7994       bfd_arch_bfin,      /* ADI Blackfin.  */
7995     #define bfd_mach_bfin          1
7996       bfd_arch_cr16,      /* National Semiconductor CompactRISC (ie CR16).  */
7997     #define bfd_mach_cr16          1
7998       bfd_arch_cr16c,     /* National Semiconductor CompactRISC.  */
7999     #define bfd_mach_cr16c         1
8000       bfd_arch_crx,       /*  National Semiconductor CRX.  */
8001     #define bfd_mach_crx           1
8002       bfd_arch_cris,      /* Axis CRIS.  */
8003     #define bfd_mach_cris_v0_v10   255
8004     #define bfd_mach_cris_v32      32
8005     #define bfd_mach_cris_v10_v32  1032
8006       bfd_arch_riscv,
8007     #define bfd_mach_riscv32       132
8008     #define bfd_mach_riscv64       164
8009       bfd_arch_rl78,
8010     #define bfd_mach_rl78          0x75
8011       bfd_arch_rx,        /* Renesas RX.  */
8012     #define bfd_mach_rx            0x75
8013       bfd_arch_s390,      /* IBM s390.  */
8014     #define bfd_mach_s390_31       31
8015     #define bfd_mach_s390_64       64
8016       bfd_arch_score,     /* Sunplus score.  */
8017     #define bfd_mach_score3        3
8018     #define bfd_mach_score7        7
8019       bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
8020       bfd_arch_xstormy16,
8021     #define bfd_mach_xstormy16     1
8022       bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
8023     #define bfd_mach_msp11         11
8024     #define bfd_mach_msp110        110
8025     #define bfd_mach_msp12         12
8026     #define bfd_mach_msp13         13
8027     #define bfd_mach_msp14         14
8028     #define bfd_mach_msp15         15
8029     #define bfd_mach_msp16         16
8030     #define bfd_mach_msp20         20
8031     #define bfd_mach_msp21         21
8032     #define bfd_mach_msp22         22
8033     #define bfd_mach_msp23         23
8034     #define bfd_mach_msp24         24
8035     #define bfd_mach_msp26         26
8036     #define bfd_mach_msp31         31
8037     #define bfd_mach_msp32         32
8038     #define bfd_mach_msp33         33
8039     #define bfd_mach_msp41         41
8040     #define bfd_mach_msp42         42
8041     #define bfd_mach_msp43         43
8042     #define bfd_mach_msp44         44
8043     #define bfd_mach_msp430x       45
8044     #define bfd_mach_msp46         46
8045     #define bfd_mach_msp47         47
8046     #define bfd_mach_msp54         54
8047       bfd_arch_xc16x,     /* Infineon's XC16X Series.  */
8048     #define bfd_mach_xc16x         1
8049     #define bfd_mach_xc16xl        2
8050     #define bfd_mach_xc16xs        3
8051       bfd_arch_xgate,     /* Freescale XGATE.  */
8052     #define bfd_mach_xgate         1
8053       bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
8054     #define bfd_mach_xtensa        1
8055       bfd_arch_z80,
8056     #define bfd_mach_z80strict     1 /* No undocumented opcodes.  */
8057     #define bfd_mach_z80           3 /* With ixl, ixh, iyl, and iyh.  */
8058     #define bfd_mach_z80full       7 /* All undocumented instructions.  */
8059     #define bfd_mach_r800          11 /* R800: successor with multiplication.  */
8060       bfd_arch_lm32,      /* Lattice Mico32.  */
8061     #define bfd_mach_lm32          1
8062       bfd_arch_microblaze,/* Xilinx MicroBlaze.  */
8063       bfd_arch_tilepro,   /* Tilera TILEPro.  */
8064       bfd_arch_tilegx,    /* Tilera TILE-Gx.  */
8065     #define bfd_mach_tilepro       1
8066     #define bfd_mach_tilegx        1
8067     #define bfd_mach_tilegx32      2
8068       bfd_arch_aarch64,   /* AArch64.  */
8069     #define bfd_mach_aarch64 0
8070     #define bfd_mach_aarch64_ilp32 32
8071       bfd_arch_nios2,     /* Nios II.  */
8072     #define bfd_mach_nios2         0
8073     #define bfd_mach_nios2r1       1
8074     #define bfd_mach_nios2r2       2
8075       bfd_arch_visium,    /* Visium.  */
8076     #define bfd_mach_visium        1
8077       bfd_arch_wasm32,    /* WebAssembly.  */
8078     #define bfd_mach_wasm32        1
8079       bfd_arch_pru,       /* PRU.  */
8080     #define bfd_mach_pru           0
8081       bfd_arch_nfp,       /* Netronome Flow Processor */
8082     #define bfd_mach_nfp3200       0x3200
8083     #define bfd_mach_nfp6000       0x6000
8084       bfd_arch_last
8085       };
8086
80872.13.2 bfd_arch_info
8088--------------------
8089
8090*Description*
8091This structure contains information on architectures for use within BFD.
8092
8093     typedef struct bfd_arch_info
8094     {
8095       int bits_per_word;
8096       int bits_per_address;
8097       int bits_per_byte;
8098       enum bfd_architecture arch;
8099       unsigned long mach;
8100       const char *arch_name;
8101       const char *printable_name;
8102       unsigned int section_align_power;
8103       /* TRUE if this is the default machine for the architecture.
8104          The default arch should be the first entry for an arch so that
8105          all the entries for that arch can be accessed via next.  */
8106       bfd_boolean the_default;
8107       const struct bfd_arch_info * (*compatible) (const struct bfd_arch_info *,
8108                                                   const struct bfd_arch_info *);
8109
8110       bfd_boolean (*scan) (const struct bfd_arch_info *, const char *);
8111
8112       /* Allocate via bfd_malloc and return a fill buffer of size COUNT.  If
8113          IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8114          TRUE, the buffer contains code.  */
8115       void *(*fill) (bfd_size_type count, bfd_boolean is_bigendian,
8116                      bfd_boolean code);
8117
8118       const struct bfd_arch_info *next;
8119     }
8120     bfd_arch_info_type;
8121
8122
81232.13.2.1 'bfd_printable_name'
8124.............................
8125
8126*Synopsis*
8127     const char *bfd_printable_name (bfd *abfd);
8128   *Description*
8129Return a printable string representing the architecture and machine from
8130the pointer to the architecture info structure.
8131
81322.13.2.2 'bfd_scan_arch'
8133........................
8134
8135*Synopsis*
8136     const bfd_arch_info_type *bfd_scan_arch (const char *string);
8137   *Description*
8138Figure out if BFD supports any cpu which could be described with the
8139name STRING.  Return a pointer to an 'arch_info' structure if a machine
8140is found, otherwise NULL.
8141
81422.13.2.3 'bfd_arch_list'
8143........................
8144
8145*Synopsis*
8146     const char **bfd_arch_list (void);
8147   *Description*
8148Return a freshly malloced NULL-terminated vector of the names of all the
8149valid BFD architectures.  Do not modify the names.
8150
81512.13.2.4 'bfd_arch_get_compatible'
8152..................................
8153
8154*Synopsis*
8155     const bfd_arch_info_type *bfd_arch_get_compatible
8156        (const bfd *abfd, const bfd *bbfd, bfd_boolean accept_unknowns);
8157   *Description*
8158Determine whether two BFDs' architectures and machine types are
8159compatible.  Calculates the lowest common denominator between the two
8160architectures and machine types implied by the BFDs and returns a
8161pointer to an 'arch_info' structure describing the compatible machine.
8162
81632.13.2.5 'bfd_default_arch_struct'
8164..................................
8165
8166*Description*
8167The 'bfd_default_arch_struct' is an item of 'bfd_arch_info_type' which
8168has been initialized to a fairly generic state.  A BFD starts life by
8169pointing to this structure, until the correct back end has determined
8170the real architecture of the file.
8171     extern const bfd_arch_info_type bfd_default_arch_struct;
8172
81732.13.2.6 'bfd_set_arch_info'
8174............................
8175
8176*Synopsis*
8177     void bfd_set_arch_info (bfd *abfd, const bfd_arch_info_type *arg);
8178   *Description*
8179Set the architecture info of ABFD to ARG.
8180
81812.13.2.7 'bfd_default_set_arch_mach'
8182....................................
8183
8184*Synopsis*
8185     bfd_boolean bfd_default_set_arch_mach
8186        (bfd *abfd, enum bfd_architecture arch, unsigned long mach);
8187   *Description*
8188Set the architecture and machine type in BFD ABFD to ARCH and MACH.
8189Find the correct pointer to a structure and insert it into the
8190'arch_info' pointer.
8191
81922.13.2.8 'bfd_get_arch'
8193.......................
8194
8195*Synopsis*
8196     enum bfd_architecture bfd_get_arch (bfd *abfd);
8197   *Description*
8198Return the enumerated type which describes the BFD ABFD's architecture.
8199
82002.13.2.9 'bfd_get_mach'
8201.......................
8202
8203*Synopsis*
8204     unsigned long bfd_get_mach (bfd *abfd);
8205   *Description*
8206Return the long type which describes the BFD ABFD's machine.
8207
82082.13.2.10 'bfd_arch_bits_per_byte'
8209..................................
8210
8211*Synopsis*
8212     unsigned int bfd_arch_bits_per_byte (bfd *abfd);
8213   *Description*
8214Return the number of bits in one of the BFD ABFD's architecture's bytes.
8215
82162.13.2.11 'bfd_arch_bits_per_address'
8217.....................................
8218
8219*Synopsis*
8220     unsigned int bfd_arch_bits_per_address (bfd *abfd);
8221   *Description*
8222Return the number of bits in one of the BFD ABFD's architecture's
8223addresses.
8224
82252.13.2.12 'bfd_default_compatible'
8226..................................
8227
8228*Synopsis*
8229     const bfd_arch_info_type *bfd_default_compatible
8230        (const bfd_arch_info_type *a, const bfd_arch_info_type *b);
8231   *Description*
8232The default function for testing for compatibility.
8233
82342.13.2.13 'bfd_default_scan'
8235............................
8236
8237*Synopsis*
8238     bfd_boolean bfd_default_scan
8239        (const struct bfd_arch_info *info, const char *string);
8240   *Description*
8241The default function for working out whether this is an architecture hit
8242and a machine hit.
8243
82442.13.2.14 'bfd_get_arch_info'
8245.............................
8246
8247*Synopsis*
8248     const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
8249   *Description*
8250Return the architecture info struct in ABFD.
8251
82522.13.2.15 'bfd_lookup_arch'
8253...........................
8254
8255*Synopsis*
8256     const bfd_arch_info_type *bfd_lookup_arch
8257        (enum bfd_architecture arch, unsigned long machine);
8258   *Description*
8259Look for the architecture info structure which matches the arguments
8260ARCH and MACHINE.  A machine of 0 matches the machine/architecture
8261structure which marks itself as the default.
8262
82632.13.2.16 'bfd_printable_arch_mach'
8264...................................
8265
8266*Synopsis*
8267     const char *bfd_printable_arch_mach
8268        (enum bfd_architecture arch, unsigned long machine);
8269   *Description*
8270Return a printable string representing the architecture and machine
8271type.
8272
8273   This routine is depreciated.
8274
82752.13.2.17 'bfd_octets_per_byte'
8276...............................
8277
8278*Synopsis*
8279     unsigned int bfd_octets_per_byte (bfd *abfd);
8280   *Description*
8281Return the number of octets (8-bit quantities) per target byte (minimum
8282addressable unit).  In most cases, this will be one, but some DSP
8283targets have 16, 32, or even 48 bits per byte.
8284
82852.13.2.18 'bfd_arch_mach_octets_per_byte'
8286.........................................
8287
8288*Synopsis*
8289     unsigned int bfd_arch_mach_octets_per_byte
8290        (enum bfd_architecture arch, unsigned long machine);
8291   *Description*
8292See bfd_octets_per_byte.
8293
8294   This routine is provided for those cases where a bfd * is not
8295available
8296
82972.13.2.19 'bfd_arch_default_fill'
8298.................................
8299
8300*Synopsis*
8301     void *bfd_arch_default_fill (bfd_size_type count,
8302         bfd_boolean is_bigendian,
8303         bfd_boolean code);
8304   *Description*
8305Allocate via bfd_malloc and return a fill buffer of size COUNT. If
8306IS_BIGENDIAN is TRUE, the order of bytes is big endian.  If CODE is
8307TRUE, the buffer contains code.
8308
8309
8310File: bfd.info,  Node: Opening and Closing,  Next: Internal,  Prev: Architectures,  Up: BFD front end
8311
8312     /* Set to N to open the next N BFDs using an alternate id space.  */
8313     extern unsigned int bfd_use_reserved_id;
8314
83152.14 Opening and closing BFDs
8316=============================
8317
83182.14.1 Functions for opening and closing
8319----------------------------------------
8320
83212.14.1.1 'bfd_fopen'
8322....................
8323
8324*Synopsis*
8325     bfd *bfd_fopen (const char *filename, const char *target,
8326         const char *mode, int fd);
8327   *Description*
8328Open the file FILENAME with the target TARGET.  Return a pointer to the
8329created BFD. If FD is not -1, then 'fdopen' is used to open the file;
8330otherwise, 'fopen' is used.  MODE is passed directly to 'fopen' or
8331'fdopen'.
8332
8333   Calls 'bfd_find_target', so TARGET is interpreted as by that
8334function.
8335
8336   The new BFD is marked as cacheable iff FD is -1.
8337
8338   If 'NULL' is returned then an error has occured.  Possible errors are
8339'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8340error.
8341
8342   On error, FD is always closed.
8343
8344   A copy of the FILENAME argument is stored in the newly created BFD.
8345It can be accessed via the bfd_get_filename() macro.
8346
83472.14.1.2 'bfd_openr'
8348....................
8349
8350*Synopsis*
8351     bfd *bfd_openr (const char *filename, const char *target);
8352   *Description*
8353Open the file FILENAME (using 'fopen') with the target TARGET.  Return a
8354pointer to the created BFD.
8355
8356   Calls 'bfd_find_target', so TARGET is interpreted as by that
8357function.
8358
8359   If 'NULL' is returned then an error has occured.  Possible errors are
8360'bfd_error_no_memory', 'bfd_error_invalid_target' or 'system_call'
8361error.
8362
8363   A copy of the FILENAME argument is stored in the newly created BFD.
8364It can be accessed via the bfd_get_filename() macro.
8365
83662.14.1.3 'bfd_fdopenr'
8367......................
8368
8369*Synopsis*
8370     bfd *bfd_fdopenr (const char *filename, const char *target, int fd);
8371   *Description*
8372'bfd_fdopenr' is to 'bfd_fopenr' much like 'fdopen' is to 'fopen'.  It
8373opens a BFD on a file already described by the FD supplied.
8374
8375   When the file is later 'bfd_close'd, the file descriptor will be
8376closed.  If the caller desires that this file descriptor be cached by
8377BFD (opened as needed, closed as needed to free descriptors for other
8378opens), with the supplied FD used as an initial file descriptor (but
8379subject to closure at any time), call bfd_set_cacheable(bfd, 1) on the
8380returned BFD. The default is to assume no caching; the file descriptor
8381will remain open until 'bfd_close', and will not be affected by BFD
8382operations on other files.
8383
8384   Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8385and 'bfd_error_system_call'.
8386
8387   On error, FD is closed.
8388
8389   A copy of the FILENAME argument is stored in the newly created BFD.
8390It can be accessed via the bfd_get_filename() macro.
8391
83922.14.1.4 'bfd_openstreamr'
8393..........................
8394
8395*Synopsis*
8396     bfd *bfd_openstreamr (const char * filename, const char * target,
8397         void * stream);
8398   *Description*
8399Open a BFD for read access on an existing stdio stream.  When the BFD is
8400passed to 'bfd_close', the stream will be closed.
8401
8402   A copy of the FILENAME argument is stored in the newly created BFD.
8403It can be accessed via the bfd_get_filename() macro.
8404
84052.14.1.5 'bfd_openr_iovec'
8406..........................
8407
8408*Synopsis*
8409     bfd *bfd_openr_iovec (const char *filename, const char *target,
8410         void *(*open_func) (struct bfd *nbfd,
8411         void *open_closure),
8412         void *open_closure,
8413         file_ptr (*pread_func) (struct bfd *nbfd,
8414         void *stream,
8415         void *buf,
8416         file_ptr nbytes,
8417         file_ptr offset),
8418         int (*close_func) (struct bfd *nbfd,
8419         void *stream),
8420         int (*stat_func) (struct bfd *abfd,
8421         void *stream,
8422         struct stat *sb));
8423   *Description*
8424Create and return a BFD backed by a read-only STREAM.  The STREAM is
8425created using OPEN_FUNC, accessed using PREAD_FUNC and destroyed using
8426CLOSE_FUNC.
8427
8428   Calls 'bfd_find_target', so TARGET is interpreted as by that
8429function.
8430
8431   Calls OPEN_FUNC (which can call 'bfd_zalloc' and 'bfd_get_filename')
8432to obtain the read-only stream backing the BFD. OPEN_FUNC either
8433succeeds returning the non-'NULL' STREAM, or fails returning 'NULL'
8434(setting 'bfd_error').
8435
8436   Calls PREAD_FUNC to request NBYTES of data from STREAM starting at
8437OFFSET (e.g., via a call to 'bfd_read').  PREAD_FUNC either succeeds
8438returning the number of bytes read (which can be less than NBYTES when
8439end-of-file), or fails returning -1 (setting 'bfd_error').
8440
8441   Calls CLOSE_FUNC when the BFD is later closed using 'bfd_close'.
8442CLOSE_FUNC either succeeds returning 0, or fails returning -1 (setting
8443'bfd_error').
8444
8445   Calls STAT_FUNC to fill in a stat structure for bfd_stat,
8446bfd_get_size, and bfd_get_mtime calls.  STAT_FUNC returns 0 on success,
8447or returns -1 on failure (setting 'bfd_error').
8448
8449   If 'bfd_openr_iovec' returns 'NULL' then an error has occurred.
8450Possible errors are 'bfd_error_no_memory', 'bfd_error_invalid_target'
8451and 'bfd_error_system_call'.
8452
8453   A copy of the FILENAME argument is stored in the newly created BFD.
8454It can be accessed via the bfd_get_filename() macro.
8455
84562.14.1.6 'bfd_openw'
8457....................
8458
8459*Synopsis*
8460     bfd *bfd_openw (const char *filename, const char *target);
8461   *Description*
8462Create a BFD, associated with file FILENAME, using the file format
8463TARGET, and return a pointer to it.
8464
8465   Possible errors are 'bfd_error_system_call', 'bfd_error_no_memory',
8466'bfd_error_invalid_target'.
8467
8468   A copy of the FILENAME argument is stored in the newly created BFD.
8469It can be accessed via the bfd_get_filename() macro.
8470
84712.14.1.7 'bfd_close'
8472....................
8473
8474*Synopsis*
8475     bfd_boolean bfd_close (bfd *abfd);
8476   *Description*
8477Close a BFD. If the BFD was open for writing, then pending operations
8478are completed and the file written out and closed.  If the created file
8479is executable, then 'chmod' is called to mark it as such.
8480
8481   All memory attached to the BFD is released.
8482
8483   The file descriptor associated with the BFD is closed (even if it was
8484passed in to BFD by 'bfd_fdopenr').
8485
8486   *Returns*
8487'TRUE' is returned if all is ok, otherwise 'FALSE'.
8488
84892.14.1.8 'bfd_close_all_done'
8490.............................
8491
8492*Synopsis*
8493     bfd_boolean bfd_close_all_done (bfd *);
8494   *Description*
8495Close a BFD. Differs from 'bfd_close' since it does not complete any
8496pending operations.  This routine would be used if the application had
8497just used BFD for swapping and didn't want to use any of the writing
8498code.
8499
8500   If the created file is executable, then 'chmod' is called to mark it
8501as such.
8502
8503   All memory attached to the BFD is released.
8504
8505   *Returns*
8506'TRUE' is returned if all is ok, otherwise 'FALSE'.
8507
85082.14.1.9 'bfd_create'
8509.....................
8510
8511*Synopsis*
8512     bfd *bfd_create (const char *filename, bfd *templ);
8513   *Description*
8514Create a new BFD in the manner of 'bfd_openw', but without opening a
8515file.  The new BFD takes the target from the target used by TEMPL.  The
8516format is always set to 'bfd_object'.
8517
8518   A copy of the FILENAME argument is stored in the newly created BFD.
8519It can be accessed via the bfd_get_filename() macro.
8520
85212.14.1.10 'bfd_make_writable'
8522.............................
8523
8524*Synopsis*
8525     bfd_boolean bfd_make_writable (bfd *abfd);
8526   *Description*
8527Takes a BFD as created by 'bfd_create' and converts it into one like as
8528returned by 'bfd_openw'.  It does this by converting the BFD to
8529BFD_IN_MEMORY. It's assumed that you will call 'bfd_make_readable' on
8530this bfd later.
8531
8532   *Returns*
8533'TRUE' is returned if all is ok, otherwise 'FALSE'.
8534
85352.14.1.11 'bfd_make_readable'
8536.............................
8537
8538*Synopsis*
8539     bfd_boolean bfd_make_readable (bfd *abfd);
8540   *Description*
8541Takes a BFD as created by 'bfd_create' and 'bfd_make_writable' and
8542converts it into one like as returned by 'bfd_openr'.  It does this by
8543writing the contents out to the memory buffer, then reversing the
8544direction.
8545
8546   *Returns*
8547'TRUE' is returned if all is ok, otherwise 'FALSE'.
8548
85492.14.1.12 'bfd_alloc'
8550.....................
8551
8552*Synopsis*
8553     void *bfd_alloc (bfd *abfd, bfd_size_type wanted);
8554   *Description*
8555Allocate a block of WANTED bytes of memory attached to 'abfd' and return
8556a pointer to it.
8557
85582.14.1.13 'bfd_alloc2'
8559......................
8560
8561*Synopsis*
8562     void *bfd_alloc2 (bfd *abfd, bfd_size_type nmemb, bfd_size_type size);
8563   *Description*
8564Allocate a block of NMEMB elements of SIZE bytes each of memory attached
8565to 'abfd' and return a pointer to it.
8566
85672.14.1.14 'bfd_zalloc'
8568......................
8569
8570*Synopsis*
8571     void *bfd_zalloc (bfd *abfd, bfd_size_type wanted);
8572   *Description*
8573Allocate a block of WANTED bytes of zeroed memory attached to 'abfd' and
8574return a pointer to it.
8575
85762.14.1.15 'bfd_zalloc2'
8577.......................
8578
8579*Synopsis*
8580     void *bfd_zalloc2 (bfd *abfd, bfd_size_type nmemb, bfd_size_type size);
8581   *Description*
8582Allocate a block of NMEMB elements of SIZE bytes each of zeroed memory
8583attached to 'abfd' and return a pointer to it.
8584
85852.14.1.16 'bfd_calc_gnu_debuglink_crc32'
8586........................................
8587
8588*Synopsis*
8589     unsigned long bfd_calc_gnu_debuglink_crc32
8590        (unsigned long crc, const unsigned char *buf, bfd_size_type len);
8591   *Description*
8592Computes a CRC value as used in the .gnu_debuglink section.  Advances
8593the previously computed CRC value by computing and adding in the crc32
8594for LEN bytes of BUF.
8595
8596   *Returns*
8597Return the updated CRC32 value.
8598
85992.14.1.17 'bfd_get_debug_link_info_1'
8600.....................................
8601
8602*Synopsis*
8603     char *bfd_get_debug_link_info_1 (bfd *abfd, void *crc32_out);
8604   *Description*
8605Extracts the filename and CRC32 value for any separate debug information
8606file associated with ABFD.
8607
8608   The CRC32_OUT parameter is an untyped pointer because this routine is
8609used as a 'get_func_type' function, but it is expected to be an unsigned
8610long pointer.
8611
8612   *Returns*
8613The filename of the associated debug information file, or NULL if there
8614is no such file.  If the filename was found then the contents of
8615CRC32_OUT are updated to hold the corresponding CRC32 value for the
8616file.
8617
8618   The returned filename is allocated with 'malloc'; freeing it is the
8619responsibility of the caller.
8620
86212.14.1.18 'bfd_get_debug_link_info'
8622...................................
8623
8624*Synopsis*
8625     char *bfd_get_debug_link_info (bfd *abfd, unsigned long *crc32_out);
8626   *Description*
8627Extracts the filename and CRC32 value for any separate debug information
8628file associated with ABFD.
8629
8630   *Returns*
8631The filename of the associated debug information file, or NULL if there
8632is no such file.  If the filename was found then the contents of
8633CRC32_OUT are updated to hold the corresponding CRC32 value for the
8634file.
8635
8636   The returned filename is allocated with 'malloc'; freeing it is the
8637responsibility of the caller.
8638
86392.14.1.19 'bfd_get_alt_debug_link_info'
8640.......................................
8641
8642*Synopsis*
8643     char *bfd_get_alt_debug_link_info (bfd * abfd,
8644         bfd_size_type *buildid_len,
8645         bfd_byte **buildid_out);
8646   *Description*
8647Fetch the filename and BuildID value for any alternate debuginfo
8648associated with ABFD.  Return NULL if no such info found, otherwise
8649return filename and update BUILDID_LEN and BUILDID_OUT.  The returned
8650filename and build_id are allocated with 'malloc'; freeing them is the
8651responsibility of the caller.
8652
86532.14.1.20 'separate_debug_file_exists'
8654......................................
8655
8656*Synopsis*
8657     bfd_boolean separate_debug_file_exists
8658        (char *name, void *crc32_p);
8659   *Description*
8660Checks to see if NAME is a file and if its contents match CRC32, which
8661is a pointer to an 'unsigned long' containing a CRC32.
8662
8663   The CRC32_P parameter is an untyped pointer because this routine is
8664used as a 'check_func_type' function.
8665
86662.14.1.21 'separate_alt_debug_file_exists'
8667..........................................
8668
8669*Synopsis*
8670     bfd_boolean separate_alt_debug_file_exists
8671        (char *name, void *unused);
8672   *Description*
8673Checks to see if NAME is a file.
8674
86752.14.1.22 'find_separate_debug_file'
8676....................................
8677
8678*Synopsis*
8679     char *find_separate_debug_file
8680        (bfd *abfd, const char *dir, bfd_boolean include_dirs,
8681         get_func_type get, check_func_type check, void *data);
8682   *Description*
8683Searches for a debug information file corresponding to ABFD.
8684
8685   The name of the separate debug info file is returned by the GET
8686function.  This function scans various fixed locations in the
8687filesystem, including the file tree rooted at DIR.  If the INCLUDE_DIRS
8688parameter is true then the directory components of ABFD's filename will
8689be included in the searched locations.
8690
8691   DATA is passed unmodified to the GET and CHECK functions.  It is
8692generally used to implement build-id-like matching in the callback
8693functions.
8694
8695   *Returns*
8696Returns the filename of the first file to be found which receives a TRUE
8697result from the CHECK function.  Returns NULL if no valid file could be
8698found.
8699
87002.14.1.23 'bfd_follow_gnu_debuglink'
8701....................................
8702
8703*Synopsis*
8704     char *bfd_follow_gnu_debuglink (bfd *abfd, const char *dir);
8705   *Description*
8706Takes a BFD and searches it for a .gnu_debuglink section.  If this
8707section is found, it examines the section for the name and checksum of a
8708'.debug' file containing auxiliary debugging information.  It then
8709searches the filesystem for this .debug file in some standard locations,
8710including the directory tree rooted at DIR, and if found returns the
8711full filename.
8712
8713   If DIR is NULL, the search will take place starting at the current
8714directory.
8715
8716   *Returns*
8717'NULL' on any errors or failure to locate the .debug file, otherwise a
8718pointer to a heap-allocated string containing the filename.  The caller
8719is responsible for freeing this string.
8720
87212.14.1.24 'bfd_follow_gnu_debugaltlink'
8722.......................................
8723
8724*Synopsis*
8725     char *bfd_follow_gnu_debugaltlink (bfd *abfd, const char *dir);
8726   *Description*
8727Takes a BFD and searches it for a .gnu_debugaltlink section.  If this
8728section is found, it examines the section for the name of a file
8729containing auxiliary debugging information.  It then searches the
8730filesystem for this file in a set of standard locations, including the
8731directory tree rooted at DIR, and if found returns the full filename.
8732
8733   If DIR is NULL, the search will take place starting at the current
8734directory.
8735
8736   *Returns*
8737'NULL' on any errors or failure to locate the debug file, otherwise a
8738pointer to a heap-allocated string containing the filename.  The caller
8739is responsible for freeing this string.
8740
87412.14.1.25 'bfd_create_gnu_debuglink_section'
8742............................................
8743
8744*Synopsis*
8745     struct bfd_section *bfd_create_gnu_debuglink_section
8746        (bfd *abfd, const char *filename);
8747   *Description*
8748Takes a BFD and adds a .gnu_debuglink section to it.  The section is
8749sized to be big enough to contain a link to the specified FILENAME.
8750
8751   *Returns*
8752A pointer to the new section is returned if all is ok.  Otherwise 'NULL'
8753is returned and bfd_error is set.
8754
87552.14.1.26 'bfd_fill_in_gnu_debuglink_section'
8756.............................................
8757
8758*Synopsis*
8759     bfd_boolean bfd_fill_in_gnu_debuglink_section
8760        (bfd *abfd, struct bfd_section *sect, const char *filename);
8761   *Description*
8762Takes a BFD and containing a .gnu_debuglink section SECT and fills in
8763the contents of the section to contain a link to the specified FILENAME.
8764The filename should be relative to the current directory.
8765
8766   *Returns*
8767'TRUE' is returned if all is ok.  Otherwise 'FALSE' is returned and
8768bfd_error is set.
8769
87702.14.1.27 'get_build_id'
8771........................
8772
8773*Synopsis*
8774     struct bfd_build_id * get_build_id (bfd *abfd);
8775   *Description*
8776Finds the build-id associated with ABFD.  If the build-id is extracted
8777from the note section then a build-id structure is built for it, using
8778memory allocated to ABFD, and this is then attached to the ABFD.
8779
8780   *Returns*
8781Returns a pointer to the build-id structure if a build-id could be
8782found.  If no build-id is found NULL is returned and error code is set.
8783
87842.14.1.28 'get_build_id_name'
8785.............................
8786
8787*Synopsis*
8788     char * get_build_id_name (bfd *abfd, void *build_id_out_p)
8789   *Description*
8790Searches ABFD for a build-id, and then constructs a pathname from it.
8791The path is computed as .build-id/NN/NN+NN.debug where NNNN+NN is the
8792build-id value as a hexadecimal string.
8793
8794   *Returns*
8795Returns the constructed filename or NULL upon error.  It is the caller's
8796responsibility to free the memory used to hold the filename.  If a
8797filename is returned then the BUILD_ID_OUT_P parameter (which points to
8798a 'struct bfd_build_id' pointer) is set to a pointer to the build_id
8799structure.
8800
88012.14.1.29 'check_build_id_file'
8802...............................
8803
8804*Synopsis*
8805     bfd_boolean check_build_id_file (char *name, void *buildid_p);
8806   *Description*
8807Checks to see if NAME is a readable file and if its build-id matches
8808BUILDID.
8809
8810   *Returns*
8811Returns TRUE if the file exists, is readable, and contains a build-id
8812which matches the build-id pointed at by BUILD_ID_P (which is really a
8813'struct bfd_build_id **').
8814
88152.14.1.30 'bfd_follow_build_id_debuglink'
8816.........................................
8817
8818*Synopsis*
8819     char *bfd_follow_build_id_debuglink (bfd *abfd, const char *dir);
8820   *Description*
8821Takes ABFD and searches it for a .note.gnu.build-id section.  If this
8822section is found, it extracts the value of the NT_GNU_BUILD_ID note,
8823which should be a hexadecimal value NNNN+NN (for 32+ hex digits).  It
8824then searches the filesystem for a file named .BUILD-ID/NN/NN+NN.DEBUG
8825in a set of standard locations, including the directory tree rooted at
8826DIR.  The filename of the first matching file to be found is returned.
8827A matching file should contain a .note.gnu.build-id section with the
8828same NNNN+NN note as ABFD, although this check is currently not
8829implemented.
8830
8831   If DIR is NULL, the search will take place starting at the current
8832directory.
8833
8834   *Returns*
8835'NULL' on any errors or failure to locate the debug file, otherwise a
8836pointer to a heap-allocated string containing the filename.  The caller
8837is responsible for freeing this string.
8838
8839
8840File: bfd.info,  Node: Internal,  Next: File Caching,  Prev: Opening and Closing,  Up: BFD front end
8841
88422.15 Implementation details
8843===========================
8844
88452.15.1 Internal functions
8846-------------------------
8847
8848*Description*
8849These routines are used within BFD. They are not intended for export,
8850but are documented here for completeness.
8851
88522.15.1.1 'bfd_write_bigendian_4byte_int'
8853........................................
8854
8855*Synopsis*
8856     bfd_boolean bfd_write_bigendian_4byte_int (bfd *, unsigned int);
8857   *Description*
8858Write a 4 byte integer I to the output BFD ABFD, in big endian order
8859regardless of what else is going on.  This is useful in archives.
8860
88612.15.1.2 'bfd_put_size'
8862.......................
8863
88642.15.1.3 'bfd_get_size'
8865.......................
8866
8867*Description*
8868These macros as used for reading and writing raw data in sections; each
8869access (except for bytes) is vectored through the target format of the
8870BFD and mangled accordingly.  The mangling performs any necessary endian
8871translations and removes alignment restrictions.  Note that types
8872accepted and returned by these macros are identical so they can be
8873swapped around in macros--for example, 'libaout.h' defines 'GET_WORD' to
8874either 'bfd_get_32' or 'bfd_get_64'.
8875
8876   In the put routines, VAL must be a 'bfd_vma'.  If we are on a system
8877without prototypes, the caller is responsible for making sure that is
8878true, with a cast if necessary.  We don't cast them in the macro
8879definitions because that would prevent 'lint' or 'gcc -Wall' from
8880detecting sins such as passing a pointer.  To detect calling these with
8881less than a 'bfd_vma', use 'gcc -Wconversion' on a host with 64 bit
8882'bfd_vma''s.
8883
8884     /* Byte swapping macros for user section data.  */
8885
8886     #define bfd_put_8(abfd, val, ptr) \
8887       ((void) (*((unsigned char *) (ptr)) = (val) & 0xff))
8888     #define bfd_put_signed_8 \
8889       bfd_put_8
8890     #define bfd_get_8(abfd, ptr) \
8891       (*(const unsigned char *) (ptr) & 0xff)
8892     #define bfd_get_signed_8(abfd, ptr) \
8893       (((*(const unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
8894
8895     #define bfd_put_16(abfd, val, ptr) \
8896       BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
8897     #define bfd_put_signed_16 \
8898       bfd_put_16
8899     #define bfd_get_16(abfd, ptr) \
8900       BFD_SEND (abfd, bfd_getx16, (ptr))
8901     #define bfd_get_signed_16(abfd, ptr) \
8902       BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
8903
8904     #define bfd_put_32(abfd, val, ptr) \
8905       BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
8906     #define bfd_put_signed_32 \
8907       bfd_put_32
8908     #define bfd_get_32(abfd, ptr) \
8909       BFD_SEND (abfd, bfd_getx32, (ptr))
8910     #define bfd_get_signed_32(abfd, ptr) \
8911       BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
8912
8913     #define bfd_put_64(abfd, val, ptr) \
8914       BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
8915     #define bfd_put_signed_64 \
8916       bfd_put_64
8917     #define bfd_get_64(abfd, ptr) \
8918       BFD_SEND (abfd, bfd_getx64, (ptr))
8919     #define bfd_get_signed_64(abfd, ptr) \
8920       BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
8921
8922     #define bfd_get(bits, abfd, ptr)                       \
8923       ((bits) == 8 ? (bfd_vma) bfd_get_8 (abfd, ptr)       \
8924        : (bits) == 16 ? bfd_get_16 (abfd, ptr)             \
8925        : (bits) == 32 ? bfd_get_32 (abfd, ptr)             \
8926        : (bits) == 64 ? bfd_get_64 (abfd, ptr)             \
8927        : (abort (), (bfd_vma) - 1))
8928
8929     #define bfd_put(bits, abfd, val, ptr)                  \
8930       ((bits) == 8 ? bfd_put_8  (abfd, val, ptr)           \
8931        : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)        \
8932        : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)        \
8933        : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)        \
8934        : (abort (), (void) 0))
8935
8936
89372.15.1.4 'bfd_h_put_size'
8938.........................
8939
8940*Description*
8941These macros have the same function as their 'bfd_get_x' brethren,
8942except that they are used for removing information for the header
8943records of object files.  Believe it or not, some object files keep
8944their header records in big endian order and their data in little endian
8945order.
8946
8947     /* Byte swapping macros for file header data.  */
8948
8949     #define bfd_h_put_8(abfd, val, ptr) \
8950       bfd_put_8 (abfd, val, ptr)
8951     #define bfd_h_put_signed_8(abfd, val, ptr) \
8952       bfd_put_8 (abfd, val, ptr)
8953     #define bfd_h_get_8(abfd, ptr) \
8954       bfd_get_8 (abfd, ptr)
8955     #define bfd_h_get_signed_8(abfd, ptr) \
8956       bfd_get_signed_8 (abfd, ptr)
8957
8958     #define bfd_h_put_16(abfd, val, ptr) \
8959       BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
8960     #define bfd_h_put_signed_16 \
8961       bfd_h_put_16
8962     #define bfd_h_get_16(abfd, ptr) \
8963       BFD_SEND (abfd, bfd_h_getx16, (ptr))
8964     #define bfd_h_get_signed_16(abfd, ptr) \
8965       BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
8966
8967     #define bfd_h_put_32(abfd, val, ptr) \
8968       BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
8969     #define bfd_h_put_signed_32 \
8970       bfd_h_put_32
8971     #define bfd_h_get_32(abfd, ptr) \
8972       BFD_SEND (abfd, bfd_h_getx32, (ptr))
8973     #define bfd_h_get_signed_32(abfd, ptr) \
8974       BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
8975
8976     #define bfd_h_put_64(abfd, val, ptr) \
8977       BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
8978     #define bfd_h_put_signed_64 \
8979       bfd_h_put_64
8980     #define bfd_h_get_64(abfd, ptr) \
8981       BFD_SEND (abfd, bfd_h_getx64, (ptr))
8982     #define bfd_h_get_signed_64(abfd, ptr) \
8983       BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
8984
8985     /* Aliases for the above, which should eventually go away.  */
8986
8987     #define H_PUT_64  bfd_h_put_64
8988     #define H_PUT_32  bfd_h_put_32
8989     #define H_PUT_16  bfd_h_put_16
8990     #define H_PUT_8   bfd_h_put_8
8991     #define H_PUT_S64 bfd_h_put_signed_64
8992     #define H_PUT_S32 bfd_h_put_signed_32
8993     #define H_PUT_S16 bfd_h_put_signed_16
8994     #define H_PUT_S8  bfd_h_put_signed_8
8995     #define H_GET_64  bfd_h_get_64
8996     #define H_GET_32  bfd_h_get_32
8997     #define H_GET_16  bfd_h_get_16
8998     #define H_GET_8   bfd_h_get_8
8999     #define H_GET_S64 bfd_h_get_signed_64
9000     #define H_GET_S32 bfd_h_get_signed_32
9001     #define H_GET_S16 bfd_h_get_signed_16
9002     #define H_GET_S8  bfd_h_get_signed_8
9003
9004
9005
90062.15.1.5 'bfd_log2'
9007...................
9008
9009*Synopsis*
9010     unsigned int bfd_log2 (bfd_vma x);
9011   *Description*
9012Return the log base 2 of the value supplied, rounded up.  E.g., an X of
90131025 returns 11.  A X of 0 returns 0.
9014
9015
9016File: bfd.info,  Node: File Caching,  Next: Linker Functions,  Prev: Internal,  Up: BFD front end
9017
90182.16 File caching
9019=================
9020
9021The file caching mechanism is embedded within BFD and allows the
9022application to open as many BFDs as it wants without regard to the
9023underlying operating system's file descriptor limit (often as low as 20
9024open files).  The module in 'cache.c' maintains a least recently used
9025list of 'bfd_cache_max_open' files, and exports the name
9026'bfd_cache_lookup', which runs around and makes sure that the required
9027BFD is open.  If not, then it chooses a file to close, closes it and
9028opens the one wanted, returning its file handle.
9029
90302.16.1 Caching functions
9031------------------------
9032
90332.16.1.1 'bfd_cache_init'
9034.........................
9035
9036*Synopsis*
9037     bfd_boolean bfd_cache_init (bfd *abfd);
9038   *Description*
9039Add a newly opened BFD to the cache.
9040
90412.16.1.2 'bfd_cache_close'
9042..........................
9043
9044*Synopsis*
9045     bfd_boolean bfd_cache_close (bfd *abfd);
9046   *Description*
9047Remove the BFD ABFD from the cache.  If the attached file is open, then
9048close it too.
9049
9050   *Returns*
9051'FALSE' is returned if closing the file fails, 'TRUE' is returned if all
9052is well.
9053
90542.16.1.3 'bfd_cache_close_all'
9055..............................
9056
9057*Synopsis*
9058     bfd_boolean bfd_cache_close_all (void);
9059   *Description*
9060Remove all BFDs from the cache.  If the attached file is open, then
9061close it too.
9062
9063   *Returns*
9064'FALSE' is returned if closing one of the file fails, 'TRUE' is returned
9065if all is well.
9066
90672.16.1.4 'bfd_open_file'
9068........................
9069
9070*Synopsis*
9071     FILE* bfd_open_file (bfd *abfd);
9072   *Description*
9073Call the OS to open a file for ABFD.  Return the 'FILE *' (possibly
9074'NULL') that results from this operation.  Set up the BFD so that future
9075accesses know the file is open.  If the 'FILE *' returned is 'NULL',
9076then it won't have been put in the cache, so it won't have to be removed
9077from it.
9078
9079
9080File: bfd.info,  Node: Linker Functions,  Next: Hash Tables,  Prev: File Caching,  Up: BFD front end
9081
90822.17 Linker Functions
9083=====================
9084
9085The linker uses three special entry points in the BFD target vector.  It
9086is not necessary to write special routines for these entry points when
9087creating a new BFD back end, since generic versions are provided.
9088However, writing them can speed up linking and make it use significantly
9089less runtime memory.
9090
9091   The first routine creates a hash table used by the other routines.
9092The second routine adds the symbols from an object file to the hash
9093table.  The third routine takes all the object files and links them
9094together to create the output file.  These routines are designed so that
9095the linker proper does not need to know anything about the symbols in
9096the object files that it is linking.  The linker merely arranges the
9097sections as directed by the linker script and lets BFD handle the
9098details of symbols and relocs.
9099
9100   The second routine and third routines are passed a pointer to a
9101'struct bfd_link_info' structure (defined in 'bfdlink.h') which holds
9102information relevant to the link, including the linker hash table (which
9103was created by the first routine) and a set of callback functions to the
9104linker proper.
9105
9106   The generic linker routines are in 'linker.c', and use the header
9107file 'genlink.h'.  As of this writing, the only back ends which have
9108implemented versions of these routines are a.out (in 'aoutx.h') and
9109ECOFF (in 'ecoff.c').  The a.out routines are used as examples
9110throughout this section.
9111
9112* Menu:
9113
9114* Creating a Linker Hash Table::
9115* Adding Symbols to the Hash Table::
9116* Performing the Final Link::
9117
9118
9119File: bfd.info,  Node: Creating a Linker Hash Table,  Next: Adding Symbols to the Hash Table,  Prev: Linker Functions,  Up: Linker Functions
9120
91212.17.1 Creating a linker hash table
9122-----------------------------------
9123
9124The linker routines must create a hash table, which must be derived from
9125'struct bfd_link_hash_table' described in 'bfdlink.c'.  *Note Hash
9126Tables::, for information on how to create a derived hash table.  This
9127entry point is called using the target vector of the linker output file.
9128
9129   The '_bfd_link_hash_table_create' entry point must allocate and
9130initialize an instance of the desired hash table.  If the back end does
9131not require any additional information to be stored with the entries in
9132the hash table, the entry point may simply create a 'struct
9133bfd_link_hash_table'.  Most likely, however, some additional information
9134will be needed.
9135
9136   For example, with each entry in the hash table the a.out linker keeps
9137the index the symbol has in the final output file (this index number is
9138used so that when doing a relocatable link the symbol index used in the
9139output file can be quickly filled in when copying over a reloc).  The
9140a.out linker code defines the required structures and functions for a
9141hash table derived from 'struct bfd_link_hash_table'.  The a.out linker
9142hash table is created by the function
9143'NAME(aout,link_hash_table_create)'; it simply allocates space for the
9144hash table, initializes it, and returns a pointer to it.
9145
9146   When writing the linker routines for a new back end, you will
9147generally not know exactly which fields will be required until you have
9148finished.  You should simply create a new hash table which defines no
9149additional fields, and then simply add fields as they become necessary.
9150
9151
9152File: bfd.info,  Node: Adding Symbols to the Hash Table,  Next: Performing the Final Link,  Prev: Creating a Linker Hash Table,  Up: Linker Functions
9153
91542.17.2 Adding symbols to the hash table
9155---------------------------------------
9156
9157The linker proper will call the '_bfd_link_add_symbols' entry point for
9158each object file or archive which is to be linked (typically these are
9159the files named on the command line, but some may also come from the
9160linker script).  The entry point is responsible for examining the file.
9161For an object file, BFD must add any relevant symbol information to the
9162hash table.  For an archive, BFD must determine which elements of the
9163archive should be used and adding them to the link.
9164
9165   The a.out version of this entry point is
9166'NAME(aout,link_add_symbols)'.
9167
9168* Menu:
9169
9170* Differing file formats::
9171* Adding symbols from an object file::
9172* Adding symbols from an archive::
9173
9174
9175File: 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
9176
91772.17.2.1 Differing file formats
9178...............................
9179
9180Normally all the files involved in a link will be of the same format,
9181but it is also possible to link together different format object files,
9182and the back end must support that.  The '_bfd_link_add_symbols' entry
9183point is called via the target vector of the file to be added.  This has
9184an important consequence: the function may not assume that the hash
9185table is the type created by the corresponding
9186'_bfd_link_hash_table_create' vector.  All the '_bfd_link_add_symbols'
9187function can assume about the hash table is that it is derived from
9188'struct bfd_link_hash_table'.
9189
9190   Sometimes the '_bfd_link_add_symbols' function must store some
9191information in the hash table entry to be used by the '_bfd_final_link'
9192function.  In such a case the output bfd xvec must be checked to make
9193sure that the hash table was created by an object file of the same
9194format.
9195
9196   The '_bfd_final_link' routine must be prepared to handle a hash entry
9197without any extra information added by the '_bfd_link_add_symbols'
9198function.  A hash entry without extra information will also occur when
9199the linker script directs the linker to create a symbol.  Note that,
9200regardless of how a hash table entry is added, all the fields will be
9201initialized to some sort of null value by the hash table entry
9202initialization function.
9203
9204   See 'ecoff_link_add_externals' for an example of how to check the
9205output bfd before saving information (in this case, the ECOFF external
9206symbol debugging information) in a hash table entry.
9207
9208
9209File: 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
9210
92112.17.2.2 Adding symbols from an object file
9212...........................................
9213
9214When the '_bfd_link_add_symbols' routine is passed an object file, it
9215must add all externally visible symbols in that object file to the hash
9216table.  The actual work of adding the symbol to the hash table is
9217normally handled by the function '_bfd_generic_link_add_one_symbol'.
9218The '_bfd_link_add_symbols' routine is responsible for reading all the
9219symbols from the object file and passing the correct information to
9220'_bfd_generic_link_add_one_symbol'.
9221
9222   The '_bfd_link_add_symbols' routine should not use
9223'bfd_canonicalize_symtab' to read the symbols.  The point of providing
9224this routine is to avoid the overhead of converting the symbols into
9225generic 'asymbol' structures.
9226
9227   '_bfd_generic_link_add_one_symbol' handles the details of combining
9228common symbols, warning about multiple definitions, and so forth.  It
9229takes arguments which describe the symbol to add, notably symbol flags,
9230a section, and an offset.  The symbol flags include such things as
9231'BSF_WEAK' or 'BSF_INDIRECT'.  The section is a section in the object
9232file, or something like 'bfd_und_section_ptr' for an undefined symbol or
9233'bfd_com_section_ptr' for a common symbol.
9234
9235   If the '_bfd_final_link' routine is also going to need to read the
9236symbol information, the '_bfd_link_add_symbols' routine should save it
9237somewhere attached to the object file BFD. However, the information
9238should only be saved if the 'keep_memory' field of the 'info' argument
9239is TRUE, so that the '-no-keep-memory' linker switch is effective.
9240
9241   The a.out function which adds symbols from an object file is
9242'aout_link_add_object_symbols', and most of the interesting work is in
9243'aout_link_add_symbols'.  The latter saves pointers to the hash tables
9244entries created by '_bfd_generic_link_add_one_symbol' indexed by symbol
9245number, so that the '_bfd_final_link' routine does not have to call the
9246hash table lookup routine to locate the entry.
9247
9248
9249File: bfd.info,  Node: Adding symbols from an archive,  Prev: Adding symbols from an object file,  Up: Adding Symbols to the Hash Table
9250
92512.17.2.3 Adding symbols from an archive
9252.......................................
9253
9254When the '_bfd_link_add_symbols' routine is passed an archive, it must
9255look through the symbols defined by the archive and decide which
9256elements of the archive should be included in the link.  For each such
9257element it must call the 'add_archive_element' linker callback, and it
9258must add the symbols from the object file to the linker hash table.
9259(The callback may in fact indicate that a replacement BFD should be
9260used, in which case the symbols from that BFD should be added to the
9261linker hash table instead.)
9262
9263   In most cases the work of looking through the symbols in the archive
9264should be done by the '_bfd_generic_link_add_archive_symbols' function.
9265'_bfd_generic_link_add_archive_symbols' is passed a function to call to
9266make the final decision about adding an archive element to the link and
9267to do the actual work of adding the symbols to the linker hash table.
9268If the element is to be included, the 'add_archive_element' linker
9269callback routine must be called with the element as an argument, and the
9270element's symbols must be added to the linker hash table just as though
9271the element had itself been passed to the '_bfd_link_add_symbols'
9272function.
9273
9274   When the a.out '_bfd_link_add_symbols' function receives an archive,
9275it calls '_bfd_generic_link_add_archive_symbols' passing
9276'aout_link_check_archive_element' as the function argument.
9277'aout_link_check_archive_element' calls 'aout_link_check_ar_symbols'.
9278If the latter decides to add the element (an element is only added if it
9279provides a real, non-common, definition for a previously undefined or
9280common symbol) it calls the 'add_archive_element' callback and then
9281'aout_link_check_archive_element' calls 'aout_link_add_symbols' to
9282actually add the symbols to the linker hash table - possibly those of a
9283substitute BFD, if the 'add_archive_element' callback avails itself of
9284that option.
9285
9286   The ECOFF back end is unusual in that it does not normally call
9287'_bfd_generic_link_add_archive_symbols', because ECOFF archives already
9288contain a hash table of symbols.  The ECOFF back end searches the
9289archive itself to avoid the overhead of creating a new hash table.
9290
9291
9292File: bfd.info,  Node: Performing the Final Link,  Prev: Adding Symbols to the Hash Table,  Up: Linker Functions
9293
92942.17.3 Performing the final link
9295--------------------------------
9296
9297When all the input files have been processed, the linker calls the
9298'_bfd_final_link' entry point of the output BFD. This routine is
9299responsible for producing the final output file, which has several
9300aspects.  It must relocate the contents of the input sections and copy
9301the data into the output sections.  It must build an output symbol table
9302including any local symbols from the input files and the global symbols
9303from the hash table.  When producing relocatable output, it must modify
9304the input relocs and write them into the output file.  There may also be
9305object format dependent work to be done.
9306
9307   The linker will also call the 'write_object_contents' entry point
9308when the BFD is closed.  The two entry points must work together in
9309order to produce the correct output file.
9310
9311   The details of how this works are inevitably dependent upon the
9312specific object file format.  The a.out '_bfd_final_link' routine is
9313'NAME(aout,final_link)'.
9314
9315* Menu:
9316
9317* Information provided by the linker::
9318* Relocating the section contents::
9319* Writing the symbol table::
9320
9321
9322File: bfd.info,  Node: Information provided by the linker,  Next: Relocating the section contents,  Prev: Performing the Final Link,  Up: Performing the Final Link
9323
93242.17.3.1 Information provided by the linker
9325...........................................
9326
9327Before the linker calls the '_bfd_final_link' entry point, it sets up
9328some data structures for the function to use.
9329
9330   The 'input_bfds' field of the 'bfd_link_info' structure will point to
9331a list of all the input files included in the link.  These files are
9332linked through the 'link.next' field of the 'bfd' structure.
9333
9334   Each section in the output file will have a list of 'link_order'
9335structures attached to the 'map_head.link_order' field (the 'link_order'
9336structure is defined in 'bfdlink.h').  These structures describe how to
9337create the contents of the output section in terms of the contents of
9338various input sections, fill constants, and, eventually, other types of
9339information.  They also describe relocs that must be created by the BFD
9340backend, but do not correspond to any input file; this is used to
9341support -Ur, which builds constructors while generating a relocatable
9342object file.
9343
9344
9345File: bfd.info,  Node: Relocating the section contents,  Next: Writing the symbol table,  Prev: Information provided by the linker,  Up: Performing the Final Link
9346
93472.17.3.2 Relocating the section contents
9348........................................
9349
9350The '_bfd_final_link' function should look through the 'link_order'
9351structures attached to each section of the output file.  Each
9352'link_order' structure should either be handled specially, or it should
9353be passed to the function '_bfd_default_link_order' which will do the
9354right thing ('_bfd_default_link_order' is defined in 'linker.c').
9355
9356   For efficiency, a 'link_order' of type 'bfd_indirect_link_order'
9357whose associated section belongs to a BFD of the same format as the
9358output BFD must be handled specially.  This type of 'link_order'
9359describes part of an output section in terms of a section belonging to
9360one of the input files.  The '_bfd_final_link' function should read the
9361contents of the section and any associated relocs, apply the relocs to
9362the section contents, and write out the modified section contents.  If
9363performing a relocatable link, the relocs themselves must also be
9364modified and written out.
9365
9366   The functions '_bfd_relocate_contents' and '_bfd_final_link_relocate'
9367provide some general support for performing the actual relocations,
9368notably overflow checking.  Their arguments include information about
9369the symbol the relocation is against and a 'reloc_howto_type' argument
9370which describes the relocation to perform.  These functions are defined
9371in 'reloc.c'.
9372
9373   The a.out function which handles reading, relocating, and writing
9374section contents is 'aout_link_input_section'.  The actual relocation is
9375done in 'aout_link_input_section_std' and 'aout_link_input_section_ext'.
9376
9377
9378File: bfd.info,  Node: Writing the symbol table,  Prev: Relocating the section contents,  Up: Performing the Final Link
9379
93802.17.3.3 Writing the symbol table
9381.................................
9382
9383The '_bfd_final_link' function must gather all the symbols in the input
9384files and write them out.  It must also write out all the symbols in the
9385global hash table.  This must be controlled by the 'strip' and 'discard'
9386fields of the 'bfd_link_info' structure.
9387
9388   The local symbols of the input files will not have been entered into
9389the linker hash table.  The '_bfd_final_link' routine must consider each
9390input file and include the symbols in the output file.  It may be
9391convenient to do this when looking through the 'link_order' structures,
9392or it may be done by stepping through the 'input_bfds' list.
9393
9394   The '_bfd_final_link' routine must also traverse the global hash
9395table to gather all the externally visible symbols.  It is possible that
9396most of the externally visible symbols may be written out when
9397considering the symbols of each input file, but it is still necessary to
9398traverse the hash table since the linker script may have defined some
9399symbols that are not in any of the input files.
9400
9401   The 'strip' field of the 'bfd_link_info' structure controls which
9402symbols are written out.  The possible values are listed in 'bfdlink.h'.
9403If the value is 'strip_some', then the 'keep_hash' field of the
9404'bfd_link_info' structure is a hash table of symbols to keep; each
9405symbol should be looked up in this hash table, and only symbols which
9406are present should be included in the output file.
9407
9408   If the 'strip' field of the 'bfd_link_info' structure permits local
9409symbols to be written out, the 'discard' field is used to further
9410controls which local symbols are included in the output file.  If the
9411value is 'discard_l', then all local symbols which begin with a certain
9412prefix are discarded; this is controlled by the
9413'bfd_is_local_label_name' entry point.
9414
9415   The a.out backend handles symbols by calling
9416'aout_link_write_symbols' on each input BFD and then traversing the
9417global hash table with the function 'aout_link_write_other_symbol'.  It
9418builds a string table while writing out the symbols, which is written to
9419the output file at the end of 'NAME(aout,final_link)'.
9420
94212.17.3.4 'bfd_link_split_section'
9422.................................
9423
9424*Synopsis*
9425     bfd_boolean bfd_link_split_section (bfd *abfd, asection *sec);
9426   *Description*
9427Return nonzero if SEC should be split during a reloceatable or final
9428link.
9429     #define bfd_link_split_section(abfd, sec) \
9430            BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
9431
9432
94332.17.3.5 'bfd_section_already_linked'
9434.....................................
9435
9436*Synopsis*
9437     bfd_boolean bfd_section_already_linked (bfd *abfd,
9438         asection *sec,
9439         struct bfd_link_info *info);
9440   *Description*
9441Check if DATA has been already linked during a reloceatable or final
9442link.  Return TRUE if it has.
9443     #define bfd_section_already_linked(abfd, sec, info) \
9444            BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
9445
9446
94472.17.3.6 'bfd_generic_define_common_symbol'
9448...........................................
9449
9450*Synopsis*
9451     bfd_boolean bfd_generic_define_common_symbol
9452        (bfd *output_bfd, struct bfd_link_info *info,
9453         struct bfd_link_hash_entry *h);
9454   *Description*
9455Convert common symbol H into a defined symbol.  Return TRUE on success
9456and FALSE on failure.
9457     #define bfd_define_common_symbol(output_bfd, info, h) \
9458            BFD_SEND (output_bfd, _bfd_define_common_symbol, (output_bfd, info, h))
9459
9460
94612.17.3.7 '_bfd_generic_link_hide_symbol'
9462........................................
9463
9464*Synopsis*
9465     void _bfd_generic_link_hide_symbol
9466        (bfd *output_bfd, struct bfd_link_info *info,
9467         struct bfd_link_hash_entry *h);
9468   *Description*
9469Hide symbol H.  This is an internal function.  It should not be called
9470from outside the BFD library.
9471     #define bfd_link_hide_symbol(output_bfd, info, h) \
9472            BFD_SEND (output_bfd, _bfd_link_hide_symbol, (output_bfd, info, h))
9473
9474
94752.17.3.8 'bfd_generic_define_start_stop'
9476........................................
9477
9478*Synopsis*
9479     struct bfd_link_hash_entry *bfd_generic_define_start_stop
9480        (struct bfd_link_info *info,
9481         const char *symbol, asection *sec);
9482   *Description*
9483Define a __start, __stop, .startof.  or .sizeof.  symbol.  Return the
9484symbol or NULL if no such undefined symbol exists.
9485     #define bfd_define_start_stop(output_bfd, info, symbol, sec) \
9486            BFD_SEND (output_bfd, _bfd_define_start_stop, (info, symbol, sec))
9487
9488
94892.17.3.9 'bfd_find_version_for_sym'
9490...................................
9491
9492*Synopsis*
9493     struct bfd_elf_version_tree * bfd_find_version_for_sym
9494        (struct bfd_elf_version_tree *verdefs,
9495         const char *sym_name, bfd_boolean *hide);
9496   *Description*
9497Search an elf version script tree for symbol versioning info and export
9498/ don't-export status for a given symbol.  Return non-NULL on success
9499and NULL on failure; also sets the output 'hide' boolean parameter.
9500
95012.17.3.10 'bfd_hide_sym_by_version'
9502...................................
9503
9504*Synopsis*
9505     bfd_boolean bfd_hide_sym_by_version
9506        (struct bfd_elf_version_tree *verdefs, const char *sym_name);
9507   *Description*
9508Search an elf version script tree for symbol versioning info for a given
9509symbol.  Return TRUE if the symbol is hidden.
9510
95112.17.3.11 'bfd_link_check_relocs'
9512.................................
9513
9514*Synopsis*
9515     bfd_boolean bfd_link_check_relocs
9516        (bfd *abfd, struct bfd_link_info *info);
9517   *Description*
9518Checks the relocs in ABFD for validity.  Does not execute the relocs.
9519Return TRUE if everything is OK, FALSE otherwise.  This is the external
9520entry point to this code.
9521
95222.17.3.12 '_bfd_generic_link_check_relocs'
9523..........................................
9524
9525*Synopsis*
9526     bfd_boolean _bfd_generic_link_check_relocs
9527        (bfd *abfd, struct bfd_link_info *info);
9528   *Description*
9529Stub function for targets that do not implement reloc checking.  Return
9530TRUE. This is an internal function.  It should not be called from
9531outside the BFD library.
9532
95332.17.3.13 'bfd_merge_private_bfd_data'
9534......................................
9535
9536*Synopsis*
9537     bfd_boolean bfd_merge_private_bfd_data
9538        (bfd *ibfd, struct bfd_link_info *info);
9539   *Description*
9540Merge private BFD information from the BFD IBFD to the the output file
9541BFD when linking.  Return 'TRUE' on success, 'FALSE' on error.  Possible
9542error returns are:
9543
9544   * 'bfd_error_no_memory' - Not enough memory exists to create private
9545     data for OBFD.
9546     #define bfd_merge_private_bfd_data(ibfd, info) \
9547            BFD_SEND ((info)->output_bfd, _bfd_merge_private_bfd_data, \
9548                      (ibfd, info))
9549
95502.17.3.14 '_bfd_generic_verify_endian_match'
9551............................................
9552
9553*Synopsis*
9554     bfd_boolean _bfd_generic_verify_endian_match
9555        (bfd *ibfd, struct bfd_link_info *info);
9556   *Description*
9557Can be used from / for bfd_merge_private_bfd_data to check that
9558endianness matches between input and output file.  Returns TRUE for a
9559match, otherwise returns FALSE and emits an error.
9560
9561
9562File: bfd.info,  Node: Hash Tables,  Prev: Linker Functions,  Up: BFD front end
9563
95642.18 Hash Tables
9565================
9566
9567BFD provides a simple set of hash table functions.  Routines are
9568provided to initialize a hash table, to free a hash table, to look up a
9569string in a hash table and optionally create an entry for it, and to
9570traverse a hash table.  There is currently no routine to delete an
9571string from a hash table.
9572
9573   The basic hash table does not permit any data to be stored with a
9574string.  However, a hash table is designed to present a base class from
9575which other types of hash tables may be derived.  These derived types
9576may store additional information with the string.  Hash tables were
9577implemented in this way, rather than simply providing a data pointer in
9578a hash table entry, because they were designed for use by the linker
9579back ends.  The linker may create thousands of hash table entries, and
9580the overhead of allocating private data and storing and following
9581pointers becomes noticeable.
9582
9583   The basic hash table code is in 'hash.c'.
9584
9585* Menu:
9586
9587* Creating and Freeing a Hash Table::
9588* Looking Up or Entering a String::
9589* Traversing a Hash Table::
9590* Deriving a New Hash Table Type::
9591
9592
9593File: bfd.info,  Node: Creating and Freeing a Hash Table,  Next: Looking Up or Entering a String,  Prev: Hash Tables,  Up: Hash Tables
9594
95952.18.1 Creating and freeing a hash table
9596----------------------------------------
9597
9598To create a hash table, create an instance of a 'struct bfd_hash_table'
9599(defined in 'bfd.h') and call 'bfd_hash_table_init' (if you know
9600approximately how many entries you will need, the function
9601'bfd_hash_table_init_n', which takes a SIZE argument, may be used).
9602'bfd_hash_table_init' returns 'FALSE' if some sort of error occurs.
9603
9604   The function 'bfd_hash_table_init' take as an argument a function to
9605use to create new entries.  For a basic hash table, use the function
9606'bfd_hash_newfunc'.  *Note Deriving a New Hash Table Type::, for why you
9607would want to use a different value for this argument.
9608
9609   'bfd_hash_table_init' will create an objalloc which will be used to
9610allocate new entries.  You may allocate memory on this objalloc using
9611'bfd_hash_allocate'.
9612
9613   Use 'bfd_hash_table_free' to free up all the memory that has been
9614allocated for a hash table.  This will not free up the 'struct
9615bfd_hash_table' itself, which you must provide.
9616
9617   Use 'bfd_hash_set_default_size' to set the default size of hash table
9618to use.
9619
9620
9621File: bfd.info,  Node: Looking Up or Entering a String,  Next: Traversing a Hash Table,  Prev: Creating and Freeing a Hash Table,  Up: Hash Tables
9622
96232.18.2 Looking up or entering a string
9624--------------------------------------
9625
9626The function 'bfd_hash_lookup' is used both to look up a string in the
9627hash table and to create a new entry.
9628
9629   If the CREATE argument is 'FALSE', 'bfd_hash_lookup' will look up a
9630string.  If the string is found, it will returns a pointer to a 'struct
9631bfd_hash_entry'.  If the string is not found in the table
9632'bfd_hash_lookup' will return 'NULL'.  You should not modify any of the
9633fields in the returns 'struct bfd_hash_entry'.
9634
9635   If the CREATE argument is 'TRUE', the string will be entered into the
9636hash table if it is not already there.  Either way a pointer to a
9637'struct bfd_hash_entry' will be returned, either to the existing
9638structure or to a newly created one.  In this case, a 'NULL' return
9639means that an error occurred.
9640
9641   If the CREATE argument is 'TRUE', and a new entry is created, the
9642COPY argument is used to decide whether to copy the string onto the hash
9643table objalloc or not.  If COPY is passed as 'FALSE', you must be
9644careful not to deallocate or modify the string as long as the hash table
9645exists.
9646
9647
9648File: bfd.info,  Node: Traversing a Hash Table,  Next: Deriving a New Hash Table Type,  Prev: Looking Up or Entering a String,  Up: Hash Tables
9649
96502.18.3 Traversing a hash table
9651------------------------------
9652
9653The function 'bfd_hash_traverse' may be used to traverse a hash table,
9654calling a function on each element.  The traversal is done in a random
9655order.
9656
9657   'bfd_hash_traverse' takes as arguments a function and a generic 'void
9658*' pointer.  The function is called with a hash table entry (a 'struct
9659bfd_hash_entry *') and the generic pointer passed to
9660'bfd_hash_traverse'.  The function must return a 'boolean' value, which
9661indicates whether to continue traversing the hash table.  If the
9662function returns 'FALSE', 'bfd_hash_traverse' will stop the traversal
9663and return immediately.
9664
9665
9666File: bfd.info,  Node: Deriving a New Hash Table Type,  Prev: Traversing a Hash Table,  Up: Hash Tables
9667
96682.18.4 Deriving a new hash table type
9669-------------------------------------
9670
9671Many uses of hash tables want to store additional information which each
9672entry in the hash table.  Some also find it convenient to store
9673additional information with the hash table itself.  This may be done
9674using a derived hash table.
9675
9676   Since C is not an object oriented language, creating a derived hash
9677table requires sticking together some boilerplate routines with a few
9678differences specific to the type of hash table you want to create.
9679
9680   An example of a derived hash table is the linker hash table.  The
9681structures for this are defined in 'bfdlink.h'.  The functions are in
9682'linker.c'.
9683
9684   You may also derive a hash table from an already derived hash table.
9685For example, the a.out linker backend code uses a hash table derived
9686from the linker hash table.
9687
9688* Menu:
9689
9690* Define the Derived Structures::
9691* Write the Derived Creation Routine::
9692* Write Other Derived Routines::
9693
9694
9695File: 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
9696
96972.18.4.1 Define the derived structures
9698......................................
9699
9700You must define a structure for an entry in the hash table, and a
9701structure for the hash table itself.
9702
9703   The first field in the structure for an entry in the hash table must
9704be of the type used for an entry in the hash table you are deriving
9705from.  If you are deriving from a basic hash table this is 'struct
9706bfd_hash_entry', which is defined in 'bfd.h'.  The first field in the
9707structure for the hash table itself must be of the type of the hash
9708table you are deriving from itself.  If you are deriving from a basic
9709hash table, this is 'struct bfd_hash_table'.
9710
9711   For example, the linker hash table defines 'struct
9712bfd_link_hash_entry' (in 'bfdlink.h').  The first field, 'root', is of
9713type 'struct bfd_hash_entry'.  Similarly, the first field in 'struct
9714bfd_link_hash_table', 'table', is of type 'struct bfd_hash_table'.
9715
9716
9717File: 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
9718
97192.18.4.2 Write the derived creation routine
9720...........................................
9721
9722You must write a routine which will create and initialize an entry in
9723the hash table.  This routine is passed as the function argument to
9724'bfd_hash_table_init'.
9725
9726   In order to permit other hash tables to be derived from the hash
9727table you are creating, this routine must be written in a standard way.
9728
9729   The first argument to the creation routine is a pointer to a hash
9730table entry.  This may be 'NULL', in which case the routine should
9731allocate the right amount of space.  Otherwise the space has already
9732been allocated by a hash table type derived from this one.
9733
9734   After allocating space, the creation routine must call the creation
9735routine of the hash table type it is derived from, passing in a pointer
9736to the space it just allocated.  This will initialize any fields used by
9737the base hash table.
9738
9739   Finally the creation routine must initialize any local fields for the
9740new hash table type.
9741
9742   Here is a boilerplate example of a creation routine.  FUNCTION_NAME
9743is the name of the routine.  ENTRY_TYPE is the type of an entry in the
9744hash table you are creating.  BASE_NEWFUNC is the name of the creation
9745routine of the hash table type your hash table is derived from.
9746
9747     struct bfd_hash_entry *
9748     FUNCTION_NAME (struct bfd_hash_entry *entry,
9749                          struct bfd_hash_table *table,
9750                          const char *string)
9751     {
9752       struct ENTRY_TYPE *ret = (ENTRY_TYPE *) entry;
9753
9754      /* Allocate the structure if it has not already been allocated by a
9755         derived class.  */
9756       if (ret == NULL)
9757         {
9758           ret = bfd_hash_allocate (table, sizeof (* ret));
9759           if (ret == NULL)
9760             return NULL;
9761         }
9762
9763      /* Call the allocation method of the base class.  */
9764       ret = ((ENTRY_TYPE *)
9765              BASE_NEWFUNC ((struct bfd_hash_entry *) ret, table, string));
9766
9767      /* Initialize the local fields here.  */
9768
9769       return (struct bfd_hash_entry *) ret;
9770     }
9771   *Description*
9772The creation routine for the linker hash table, which is in 'linker.c',
9773looks just like this example.  FUNCTION_NAME is
9774'_bfd_link_hash_newfunc'.  ENTRY_TYPE is 'struct bfd_link_hash_entry'.
9775BASE_NEWFUNC is 'bfd_hash_newfunc', the creation routine for a basic
9776hash table.
9777
9778   '_bfd_link_hash_newfunc' also initializes the local fields in a
9779linker hash table entry: 'type', 'written' and 'next'.
9780
9781
9782File: bfd.info,  Node: Write Other Derived Routines,  Prev: Write the Derived Creation Routine,  Up: Deriving a New Hash Table Type
9783
97842.18.4.3 Write other derived routines
9785.....................................
9786
9787You will want to write other routines for your new hash table, as well.
9788
9789   You will want an initialization routine which calls the
9790initialization routine of the hash table you are deriving from and
9791initializes any other local fields.  For the linker hash table, this is
9792'_bfd_link_hash_table_init' in 'linker.c'.
9793
9794   You will want a lookup routine which calls the lookup routine of the
9795hash table you are deriving from and casts the result.  The linker hash
9796table uses 'bfd_link_hash_lookup' in 'linker.c' (this actually takes an
9797additional argument which it uses to decide how to return the looked up
9798value).
9799
9800   You may want a traversal routine.  This should just call the
9801traversal routine of the hash table you are deriving from with
9802appropriate casts.  The linker hash table uses 'bfd_link_hash_traverse'
9803in 'linker.c'.
9804
9805   These routines may simply be defined as macros.  For example, the
9806a.out backend linker hash table, which is derived from the linker hash
9807table, uses macros for the lookup and traversal routines.  These are
9808'aout_link_hash_lookup' and 'aout_link_hash_traverse' in aoutx.h.
9809
9810
9811File: bfd.info,  Node: BFD back ends,  Next: GNU Free Documentation License,  Prev: BFD front end,  Up: Top
9812
98133 BFD back ends
9814***************
9815
9816* Menu:
9817
9818* What to Put Where::
9819* aout ::	a.out backends
9820* coff ::	coff backends
9821* elf  ::	elf backends
9822* mmo  ::	mmo backend
9823
9824
9825File: bfd.info,  Node: What to Put Where,  Next: aout,  Prev: BFD back ends,  Up: BFD back ends
9826
98273.1 What to Put Where
9828=====================
9829
9830All of BFD lives in one directory.
9831
9832
9833File: bfd.info,  Node: aout,  Next: coff,  Prev: What to Put Where,  Up: BFD back ends
9834
98353.2 a.out backends
9836==================
9837
9838*Description*
9839BFD supports a number of different flavours of a.out format, though the
9840major differences are only the sizes of the structures on disk, and the
9841shape of the relocation information.
9842
9843   The support is split into a basic support file 'aoutx.h' and other
9844files which derive functions from the base.  One derivation file is
9845'aoutf1.h' (for a.out flavour 1), and adds to the basic a.out functions
9846support for sun3, sun4, and 386 a.out files, to create a target jump
9847vector for a specific target.
9848
9849   This information is further split out into more specific files for
9850each machine, including 'sunos.c' for sun3 and sun4, and 'demo64.c' for
9851a demonstration of a 64 bit a.out format.
9852
9853   The base file 'aoutx.h' defines general mechanisms for reading and
9854writing records to and from disk and various other methods which BFD
9855requires.  It is included by 'aout32.c' and 'aout64.c' to form the names
9856'aout_32_swap_exec_header_in', 'aout_64_swap_exec_header_in', etc.
9857
9858   As an example, this is what goes on to make the back end for a sun4,
9859from 'aout32.c':
9860
9861            #define ARCH_SIZE 32
9862            #include "aoutx.h"
9863
9864   Which exports names:
9865
9866            ...
9867            aout_32_canonicalize_reloc
9868            aout_32_find_nearest_line
9869            aout_32_get_lineno
9870            aout_32_get_reloc_upper_bound
9871            ...
9872
9873   from 'sunos.c':
9874
9875            #define TARGET_NAME "a.out-sunos-big"
9876            #define VECNAME    sparc_aout_sunos_be_vec
9877            #include "aoutf1.h"
9878
9879   requires all the names from 'aout32.c', and produces the jump vector
9880
9881            sparc_aout_sunos_be_vec
9882
9883   The file 'host-aout.c' is a special case.  It is for a large set of
9884hosts that use "more or less standard" a.out files, and for which
9885cross-debugging is not interesting.  It uses the standard 32-bit a.out
9886support routines, but determines the file offsets and addresses of the
9887text, data, and BSS sections, the machine architecture and machine type,
9888and the entry point address, in a host-dependent manner.  Once these
9889values have been determined, generic code is used to handle the object
9890file.
9891
9892   When porting it to run on a new system, you must supply:
9893
9894             HOST_PAGE_SIZE
9895             HOST_SEGMENT_SIZE
9896             HOST_MACHINE_ARCH       (optional)
9897             HOST_MACHINE_MACHINE    (optional)
9898             HOST_TEXT_START_ADDR
9899             HOST_STACK_END_ADDR
9900
9901   in the file '../include/sys/h-XXX.h' (for your host).  These values,
9902plus the structures and macros defined in 'a.out.h' on your host system,
9903will produce a BFD target that will access ordinary a.out files on your
9904host.  To configure a new machine to use 'host-aout.c', specify:
9905
9906            TDEFAULTS = -DDEFAULT_VECTOR=host_aout_big_vec
9907            TDEPFILES= host-aout.o trad-core.o
9908
9909   in the 'config/XXX.mt' file, and modify 'configure.ac' to use the
9910'XXX.mt' file (by setting "'bfd_target=XXX'") when your configuration is
9911selected.
9912
99133.2.1 Relocations
9914-----------------
9915
9916*Description*
9917The file 'aoutx.h' provides for both the _standard_ and _extended_ forms
9918of a.out relocation records.
9919
9920   The standard records contain only an address, a symbol index, and a
9921type field.  The extended records also have a full integer for an
9922addend.
9923
99243.2.2 Internal entry points
9925---------------------------
9926
9927*Description*
9928'aoutx.h' exports several routines for accessing the contents of an
9929a.out file, which are gathered and exported in turn by various format
9930specific files (eg sunos.c).
9931
99323.2.2.1 'aout_SIZE_swap_exec_header_in'
9933.......................................
9934
9935*Synopsis*
9936     void aout_SIZE_swap_exec_header_in,
9937        (bfd *abfd,
9938         struct external_exec *bytes,
9939         struct internal_exec *execp);
9940   *Description*
9941Swap the information in an executable header RAW_BYTES taken from a raw
9942byte stream memory image into the internal exec header structure EXECP.
9943
99443.2.2.2 'aout_SIZE_swap_exec_header_out'
9945........................................
9946
9947*Synopsis*
9948     void aout_SIZE_swap_exec_header_out
9949        (bfd *abfd,
9950         struct internal_exec *execp,
9951         struct external_exec *raw_bytes);
9952   *Description*
9953Swap the information in an internal exec header structure EXECP into the
9954buffer RAW_BYTES ready for writing to disk.
9955
99563.2.2.3 'aout_SIZE_some_aout_object_p'
9957......................................
9958
9959*Synopsis*
9960     const bfd_target *aout_SIZE_some_aout_object_p
9961        (bfd *abfd,
9962         struct internal_exec *execp,
9963         const bfd_target *(*callback_to_real_object_p) (bfd *));
9964   *Description*
9965Some a.out variant thinks that the file open in ABFD checking is an
9966a.out file.  Do some more checking, and set up for access if it really
9967is.  Call back to the calling environment's "finish up" function just
9968before returning, to handle any last-minute setup.
9969
99703.2.2.4 'aout_SIZE_mkobject'
9971............................
9972
9973*Synopsis*
9974     bfd_boolean aout_SIZE_mkobject, (bfd *abfd);
9975   *Description*
9976Initialize BFD ABFD for use with a.out files.
9977
99783.2.2.5 'aout_SIZE_machine_type'
9979................................
9980
9981*Synopsis*
9982     enum machine_type  aout_SIZE_machine_type
9983        (enum bfd_architecture arch,
9984         unsigned long machine,
9985         bfd_boolean *unknown);
9986   *Description*
9987Keep track of machine architecture and machine type for a.out's.  Return
9988the 'machine_type' for a particular architecture and machine, or
9989'M_UNKNOWN' if that exact architecture and machine can't be represented
9990in a.out format.
9991
9992   If the architecture is understood, machine type 0 (default) is always
9993understood.
9994
99953.2.2.6 'aout_SIZE_set_arch_mach'
9996.................................
9997
9998*Synopsis*
9999     bfd_boolean aout_SIZE_set_arch_mach,
10000        (bfd *,
10001         enum bfd_architecture arch,
10002         unsigned long machine);
10003   *Description*
10004Set the architecture and the machine of the BFD ABFD to the values ARCH
10005and MACHINE.  Verify that ABFD's format can support the architecture
10006required.
10007
100083.2.2.7 'aout_SIZE_new_section_hook'
10009....................................
10010
10011*Synopsis*
10012     bfd_boolean aout_SIZE_new_section_hook,
10013        (bfd *abfd,
10014         asection *newsect);
10015   *Description*
10016Called by the BFD in response to a 'bfd_make_section' request.
10017
10018
10019File: bfd.info,  Node: coff,  Next: elf,  Prev: aout,  Up: BFD back ends
10020
100213.3 coff backends
10022=================
10023
10024BFD supports a number of different flavours of coff format.  The major
10025differences between formats are the sizes and alignments of fields in
10026structures on disk, and the occasional extra field.
10027
10028   Coff in all its varieties is implemented with a few common files and
10029a number of implementation specific files.  For example, the i386 coff
10030format is implemented in the file 'coff-i386.c'.  This file '#include's
10031'coff/i386.h' which defines the external structure of the coff format
10032for the i386, and 'coff/internal.h' which defines the internal
10033structure.  'coff-i386.c' also defines the relocations used by the i386
10034coff format *Note Relocations::.
10035
100363.3.1 Porting to a new version of coff
10037--------------------------------------
10038
10039The recommended method is to select from the existing implementations
10040the version of coff which is most like the one you want to use.  For
10041example, we'll say that i386 coff is the one you select, and that your
10042coff flavour is called foo.  Copy 'i386coff.c' to 'foocoff.c', copy
10043'../include/coff/i386.h' to '../include/coff/foo.h', and add the lines
10044to 'targets.c' and 'Makefile.in' so that your new back end is used.
10045Alter the shapes of the structures in '../include/coff/foo.h' so that
10046they match what you need.  You will probably also have to add '#ifdef's
10047to the code in 'coff/internal.h' and 'coffcode.h' if your version of
10048coff is too wild.
10049
10050   You can verify that your new BFD backend works quite simply by
10051building 'objdump' from the 'binutils' directory, and making sure that
10052its version of what's going on and your host system's idea (assuming it
10053has the pretty standard coff dump utility, usually called 'att-dump' or
10054just 'dump') are the same.  Then clean up your code, and send what
10055you've done to Cygnus.  Then your stuff will be in the next release, and
10056you won't have to keep integrating it.
10057
100583.3.2 How the coff backend works
10059--------------------------------
10060
100613.3.2.1 File layout
10062...................
10063
10064The Coff backend is split into generic routines that are applicable to
10065any Coff target and routines that are specific to a particular target.
10066The target-specific routines are further split into ones which are
10067basically the same for all Coff targets except that they use the
10068external symbol format or use different values for certain constants.
10069
10070   The generic routines are in 'coffgen.c'.  These routines work for any
10071Coff target.  They use some hooks into the target specific code; the
10072hooks are in a 'bfd_coff_backend_data' structure, one of which exists
10073for each target.
10074
10075   The essentially similar target-specific routines are in 'coffcode.h'.
10076This header file includes executable C code.  The various Coff targets
10077first include the appropriate Coff header file, make any special defines
10078that are needed, and then include 'coffcode.h'.
10079
10080   Some of the Coff targets then also have additional routines in the
10081target source file itself.
10082
100833.3.2.2 Coff long section names
10084...............................
10085
10086In the standard Coff object format, section names are limited to the
10087eight bytes available in the 's_name' field of the 'SCNHDR' section
10088header structure.  The format requires the field to be NUL-padded, but
10089not necessarily NUL-terminated, so the longest section names permitted
10090are a full eight characters.
10091
10092   The Microsoft PE variants of the Coff object file format add an
10093extension to support the use of long section names.  This extension is
10094defined in section 4 of the Microsoft PE/COFF specification (rev 8.1).
10095If a section name is too long to fit into the section header's 's_name'
10096field, it is instead placed into the string table, and the 's_name'
10097field is filled with a slash ("/") followed by the ASCII decimal
10098representation of the offset of the full name relative to the string
10099table base.
10100
10101   Note that this implies that the extension can only be used in object
10102files, as executables do not contain a string table.  The standard
10103specifies that long section names from objects emitted into executable
10104images are to be truncated.
10105
10106   However, as a GNU extension, BFD can generate executable images that
10107contain a string table and long section names.  This would appear to be
10108technically valid, as the standard only says that Coff debugging
10109information is deprecated, not forbidden, and in practice it works,
10110although some tools that parse PE files expecting the MS standard format
10111may become confused; 'PEview' is one known example.
10112
10113   The functionality is supported in BFD by code implemented under the
10114control of the macro 'COFF_LONG_SECTION_NAMES'.  If not defined, the
10115format does not support long section names in any way.  If defined, it
10116is used to initialise a flag, '_bfd_coff_long_section_names', and a hook
10117function pointer, '_bfd_coff_set_long_section_names', in the Coff
10118backend data structure.  The flag controls the generation of long
10119section names in output BFDs at runtime; if it is false, as it will be
10120by default when generating an executable image, long section names are
10121truncated; if true, the long section names extension is employed.  The
10122hook points to a function that allows the value of the flag to be
10123altered at runtime, on formats that support long section names at all;
10124on other formats it points to a stub that returns an error indication.
10125
10126   With input BFDs, the flag is set according to whether any long
10127section names are detected while reading the section headers.  For a
10128completely new BFD, the flag is set to the default for the target
10129format.  This information can be used by a client of the BFD library
10130when deciding what output format to generate, and means that a BFD that
10131is opened for read and subsequently converted to a writeable BFD and
10132modified in-place will retain whatever format it had on input.
10133
10134   If 'COFF_LONG_SECTION_NAMES' is simply defined (blank), or is defined
10135to the value "1", then long section names are enabled by default; if it
10136is defined to the value zero, they are disabled by default (but still
10137accepted in input BFDs).  The header 'coffcode.h' defines a macro,
10138'COFF_DEFAULT_LONG_SECTION_NAMES', which is used in the backends to
10139initialise the backend data structure fields appropriately; see the
10140comments for further detail.
10141
101423.3.2.3 Bit twiddling
10143.....................
10144
10145Each flavour of coff supported in BFD has its own header file describing
10146the external layout of the structures.  There is also an internal
10147description of the coff layout, in 'coff/internal.h'.  A major function
10148of the coff backend is swapping the bytes and twiddling the bits to
10149translate the external form of the structures into the normal internal
10150form.  This is all performed in the 'bfd_swap'_thing_direction routines.
10151Some elements are different sizes between different versions of coff; it
10152is the duty of the coff version specific include file to override the
10153definitions of various packing routines in 'coffcode.h'.  E.g., the size
10154of line number entry in coff is sometimes 16 bits, and sometimes 32
10155bits.  '#define'ing 'PUT_LNSZ_LNNO' and 'GET_LNSZ_LNNO' will select the
10156correct one.  No doubt, some day someone will find a version of coff
10157which has a varying field size not catered to at the moment.  To port
10158BFD, that person will have to add more '#defines'.  Three of the bit
10159twiddling routines are exported to 'gdb'; 'coff_swap_aux_in',
10160'coff_swap_sym_in' and 'coff_swap_lineno_in'.  'GDB' reads the symbol
10161table on its own, but uses BFD to fix things up.  More of the bit
10162twiddlers are exported for 'gas'; 'coff_swap_aux_out',
10163'coff_swap_sym_out', 'coff_swap_lineno_out', 'coff_swap_reloc_out',
10164'coff_swap_filehdr_out', 'coff_swap_aouthdr_out',
10165'coff_swap_scnhdr_out'.  'Gas' currently keeps track of all the symbol
10166table and reloc drudgery itself, thereby saving the internal BFD
10167overhead, but uses BFD to swap things on the way out, making cross ports
10168much safer.  Doing so also allows BFD (and thus the linker) to use the
10169same header files as 'gas', which makes one avenue to disaster
10170disappear.
10171
101723.3.2.4 Symbol reading
10173......................
10174
10175The simple canonical form for symbols used by BFD is not rich enough to
10176keep all the information available in a coff symbol table.  The back end
10177gets around this problem by keeping the original symbol table around,
10178"behind the scenes".
10179
10180   When a symbol table is requested (through a call to
10181'bfd_canonicalize_symtab'), a request gets through to
10182'coff_get_normalized_symtab'.  This reads the symbol table from the coff
10183file and swaps all the structures inside into the internal form.  It
10184also fixes up all the pointers in the table (represented in the file by
10185offsets from the first symbol in the table) into physical pointers to
10186elements in the new internal table.  This involves some work since the
10187meanings of fields change depending upon context: a field that is a
10188pointer to another structure in the symbol table at one moment may be
10189the size in bytes of a structure at the next.  Another pass is made over
10190the table.  All symbols which mark file names ('C_FILE' symbols) are
10191modified so that the internal string points to the value in the auxent
10192(the real filename) rather than the normal text associated with the
10193symbol ('".file"').
10194
10195   At this time the symbol names are moved around.  Coff stores all
10196symbols less than nine characters long physically within the symbol
10197table; longer strings are kept at the end of the file in the string
10198table.  This pass moves all strings into memory and replaces them with
10199pointers to the strings.
10200
10201   The symbol table is massaged once again, this time to create the
10202canonical table used by the BFD application.  Each symbol is inspected
10203in turn, and a decision made (using the 'sclass' field) about the
10204various flags to set in the 'asymbol'.  *Note Symbols::.  The generated
10205canonical table shares strings with the hidden internal symbol table.
10206
10207   Any linenumbers are read from the coff file too, and attached to the
10208symbols which own the functions the linenumbers belong to.
10209
102103.3.2.5 Symbol writing
10211......................
10212
10213Writing a symbol to a coff file which didn't come from a coff file will
10214lose any debugging information.  The 'asymbol' structure remembers the
10215BFD from which the symbol was taken, and on output the back end makes
10216sure that the same destination target as source target is present.
10217
10218   When the symbols have come from a coff file then all the debugging
10219information is preserved.
10220
10221   Symbol tables are provided for writing to the back end in a vector of
10222pointers to pointers.  This allows applications like the linker to
10223accumulate and output large symbol tables without having to do too much
10224byte copying.
10225
10226   This function runs through the provided symbol table and patches each
10227symbol marked as a file place holder ('C_FILE') to point to the next
10228file place holder in the list.  It also marks each 'offset' field in the
10229list with the offset from the first symbol of the current symbol.
10230
10231   Another function of this procedure is to turn the canonical value
10232form of BFD into the form used by coff.  Internally, BFD expects symbol
10233values to be offsets from a section base; so a symbol physically at
102340x120, but in a section starting at 0x100, would have the value 0x20.
10235Coff expects symbols to contain their final value, so symbols have their
10236values changed at this point to reflect their sum with their owning
10237section.  This transformation uses the 'output_section' field of the
10238'asymbol''s 'asection' *Note Sections::.
10239
10240   * 'coff_mangle_symbols'
10241   This routine runs though the provided symbol table and uses the
10242offsets generated by the previous pass and the pointers generated when
10243the symbol table was read in to create the structured hierarchy required
10244by coff.  It changes each pointer to a symbol into the index into the
10245symbol table of the asymbol.
10246
10247   * 'coff_write_symbols'
10248   This routine runs through the symbol table and patches up the symbols
10249from their internal form into the coff way, calls the bit twiddlers, and
10250writes out the table to the file.
10251
102523.3.2.6 'coff_symbol_type'
10253..........................
10254
10255*Description*
10256The hidden information for an 'asymbol' is described in a
10257'combined_entry_type':
10258
10259
10260     typedef struct coff_ptr_struct
10261     {
10262       /* Remembers the offset from the first symbol in the file for
10263          this symbol. Generated by coff_renumber_symbols.  */
10264       unsigned int offset;
10265
10266       /* Should the value of this symbol be renumbered.  Used for
10267          XCOFF C_BSTAT symbols.  Set by coff_slurp_symbol_table.  */
10268       unsigned int fix_value : 1;
10269
10270       /* Should the tag field of this symbol be renumbered.
10271          Created by coff_pointerize_aux.  */
10272       unsigned int fix_tag : 1;
10273
10274       /* Should the endidx field of this symbol be renumbered.
10275          Created by coff_pointerize_aux.  */
10276       unsigned int fix_end : 1;
10277
10278       /* Should the x_csect.x_scnlen field be renumbered.
10279          Created by coff_pointerize_aux.  */
10280       unsigned int fix_scnlen : 1;
10281
10282       /* Fix up an XCOFF C_BINCL/C_EINCL symbol.  The value is the
10283          index into the line number entries.  Set by coff_slurp_symbol_table.  */
10284       unsigned int fix_line : 1;
10285
10286       /* The container for the symbol structure as read and translated
10287          from the file.  */
10288       union
10289       {
10290         union internal_auxent auxent;
10291         struct internal_syment syment;
10292       } u;
10293
10294      /* Selector for the union above.  */
10295      bfd_boolean is_sym;
10296     } combined_entry_type;
10297
10298
10299     /* Each canonical asymbol really looks like this: */
10300
10301     typedef struct coff_symbol_struct
10302     {
10303       /* The actual symbol which the rest of BFD works with */
10304       asymbol symbol;
10305
10306       /* A pointer to the hidden information for this symbol */
10307       combined_entry_type *native;
10308
10309       /* A pointer to the linenumber information for this symbol */
10310       struct lineno_cache_entry *lineno;
10311
10312       /* Have the line numbers been relocated yet ? */
10313       bfd_boolean done_lineno;
10314     } coff_symbol_type;
10315
103163.3.2.7 'bfd_coff_backend_data'
10317...............................
10318
10319     /* COFF symbol classifications.  */
10320
10321     enum coff_symbol_classification
10322     {
10323       /* Global symbol.  */
10324       COFF_SYMBOL_GLOBAL,
10325       /* Common symbol.  */
10326       COFF_SYMBOL_COMMON,
10327       /* Undefined symbol.  */
10328       COFF_SYMBOL_UNDEFINED,
10329       /* Local symbol.  */
10330       COFF_SYMBOL_LOCAL,
10331       /* PE section symbol.  */
10332       COFF_SYMBOL_PE_SECTION
10333     };
10334
10335     typedef asection * (*coff_gc_mark_hook_fn)
10336       (asection *, struct bfd_link_info *, struct internal_reloc *,
10337        struct coff_link_hash_entry *, struct internal_syment *);
10338
10339   Special entry points for gdb to swap in coff symbol table parts:
10340     typedef struct
10341     {
10342       void (*_bfd_coff_swap_aux_in)
10343         (bfd *, void *, int, int, int, int, void *);
10344
10345       void (*_bfd_coff_swap_sym_in)
10346         (bfd *, void *, void *);
10347
10348       void (*_bfd_coff_swap_lineno_in)
10349         (bfd *, void *, void *);
10350
10351       unsigned int (*_bfd_coff_swap_aux_out)
10352         (bfd *, void *, int, int, int, int, void *);
10353
10354       unsigned int (*_bfd_coff_swap_sym_out)
10355         (bfd *, void *, void *);
10356
10357       unsigned int (*_bfd_coff_swap_lineno_out)
10358         (bfd *, void *, void *);
10359
10360       unsigned int (*_bfd_coff_swap_reloc_out)
10361         (bfd *, void *, void *);
10362
10363       unsigned int (*_bfd_coff_swap_filehdr_out)
10364         (bfd *, void *, void *);
10365
10366       unsigned int (*_bfd_coff_swap_aouthdr_out)
10367         (bfd *, void *, void *);
10368
10369       unsigned int (*_bfd_coff_swap_scnhdr_out)
10370         (bfd *, void *, void *);
10371
10372       unsigned int _bfd_filhsz;
10373       unsigned int _bfd_aoutsz;
10374       unsigned int _bfd_scnhsz;
10375       unsigned int _bfd_symesz;
10376       unsigned int _bfd_auxesz;
10377       unsigned int _bfd_relsz;
10378       unsigned int _bfd_linesz;
10379       unsigned int _bfd_filnmlen;
10380       bfd_boolean _bfd_coff_long_filenames;
10381
10382       bfd_boolean _bfd_coff_long_section_names;
10383       bfd_boolean (*_bfd_coff_set_long_section_names)
10384         (bfd *, int);
10385
10386       unsigned int _bfd_coff_default_section_alignment_power;
10387       bfd_boolean _bfd_coff_force_symnames_in_strings;
10388       unsigned int _bfd_coff_debug_string_prefix_length;
10389       unsigned int _bfd_coff_max_nscns;
10390
10391       void (*_bfd_coff_swap_filehdr_in)
10392         (bfd *, void *, void *);
10393
10394       void (*_bfd_coff_swap_aouthdr_in)
10395         (bfd *, void *, void *);
10396
10397       void (*_bfd_coff_swap_scnhdr_in)
10398         (bfd *, void *, void *);
10399
10400       void (*_bfd_coff_swap_reloc_in)
10401         (bfd *abfd, void *, void *);
10402
10403       bfd_boolean (*_bfd_coff_bad_format_hook)
10404         (bfd *, void *);
10405
10406       bfd_boolean (*_bfd_coff_set_arch_mach_hook)
10407         (bfd *, void *);
10408
10409       void * (*_bfd_coff_mkobject_hook)
10410         (bfd *, void *, void *);
10411
10412       bfd_boolean (*_bfd_styp_to_sec_flags_hook)
10413         (bfd *, void *, const char *, asection *, flagword *);
10414
10415       void (*_bfd_set_alignment_hook)
10416         (bfd *, asection *, void *);
10417
10418       bfd_boolean (*_bfd_coff_slurp_symbol_table)
10419         (bfd *);
10420
10421       bfd_boolean (*_bfd_coff_symname_in_debug)
10422         (bfd *, struct internal_syment *);
10423
10424       bfd_boolean (*_bfd_coff_pointerize_aux_hook)
10425         (bfd *, combined_entry_type *, combined_entry_type *,
10426          unsigned int, combined_entry_type *);
10427
10428       bfd_boolean (*_bfd_coff_print_aux)
10429         (bfd *, FILE *, combined_entry_type *, combined_entry_type *,
10430          combined_entry_type *, unsigned int);
10431
10432       void (*_bfd_coff_reloc16_extra_cases)
10433         (bfd *, struct bfd_link_info *, struct bfd_link_order *, arelent *,
10434          bfd_byte *, unsigned int *, unsigned int *);
10435
10436       int (*_bfd_coff_reloc16_estimate)
10437         (bfd *, asection *, arelent *, unsigned int,
10438          struct bfd_link_info *);
10439
10440       enum coff_symbol_classification (*_bfd_coff_classify_symbol)
10441         (bfd *, struct internal_syment *);
10442
10443       bfd_boolean (*_bfd_coff_compute_section_file_positions)
10444         (bfd *);
10445
10446       bfd_boolean (*_bfd_coff_start_final_link)
10447         (bfd *, struct bfd_link_info *);
10448
10449       bfd_boolean (*_bfd_coff_relocate_section)
10450         (bfd *, struct bfd_link_info *, bfd *, asection *, bfd_byte *,
10451          struct internal_reloc *, struct internal_syment *, asection **);
10452
10453       reloc_howto_type *(*_bfd_coff_rtype_to_howto)
10454         (bfd *, asection *, struct internal_reloc *,
10455          struct coff_link_hash_entry *, struct internal_syment *, bfd_vma *);
10456
10457       bfd_boolean (*_bfd_coff_adjust_symndx)
10458         (bfd *, struct bfd_link_info *, bfd *, asection *,
10459          struct internal_reloc *, bfd_boolean *);
10460
10461       bfd_boolean (*_bfd_coff_link_add_one_symbol)
10462         (struct bfd_link_info *, bfd *, const char *, flagword,
10463          asection *, bfd_vma, const char *, bfd_boolean, bfd_boolean,
10464          struct bfd_link_hash_entry **);
10465
10466       bfd_boolean (*_bfd_coff_link_output_has_begun)
10467         (bfd *, struct coff_final_link_info *);
10468
10469       bfd_boolean (*_bfd_coff_final_link_postscript)
10470         (bfd *, struct coff_final_link_info *);
10471
10472       bfd_boolean (*_bfd_coff_print_pdata)
10473         (bfd *, void *);
10474
10475     } bfd_coff_backend_data;
10476
10477     #define coff_backend_info(abfd) \
10478       ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
10479
10480     #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
10481       ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
10482
10483     #define bfd_coff_swap_sym_in(a,e,i) \
10484       ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
10485
10486     #define bfd_coff_swap_lineno_in(a,e,i) \
10487       ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
10488
10489     #define bfd_coff_swap_reloc_out(abfd, i, o) \
10490       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
10491
10492     #define bfd_coff_swap_lineno_out(abfd, i, o) \
10493       ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
10494
10495     #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
10496       ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
10497
10498     #define bfd_coff_swap_sym_out(abfd, i,o) \
10499       ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
10500
10501     #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
10502       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
10503
10504     #define bfd_coff_swap_filehdr_out(abfd, i,o) \
10505       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
10506
10507     #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
10508       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
10509
10510     #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
10511     #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
10512     #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
10513     #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
10514     #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
10515     #define bfd_coff_relsz(abfd)  (coff_backend_info (abfd)->_bfd_relsz)
10516     #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
10517     #define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
10518     #define bfd_coff_long_filenames(abfd) \
10519       (coff_backend_info (abfd)->_bfd_coff_long_filenames)
10520     #define bfd_coff_long_section_names(abfd) \
10521       (coff_backend_info (abfd)->_bfd_coff_long_section_names)
10522     #define bfd_coff_set_long_section_names(abfd, enable) \
10523       ((coff_backend_info (abfd)->_bfd_coff_set_long_section_names) (abfd, enable))
10524     #define bfd_coff_default_section_alignment_power(abfd) \
10525       (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
10526     #define bfd_coff_max_nscns(abfd) \
10527       (coff_backend_info (abfd)->_bfd_coff_max_nscns)
10528
10529     #define bfd_coff_swap_filehdr_in(abfd, i,o) \
10530       ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
10531
10532     #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
10533       ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
10534
10535     #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
10536       ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
10537
10538     #define bfd_coff_swap_reloc_in(abfd, i, o) \
10539       ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
10540
10541     #define bfd_coff_bad_format_hook(abfd, filehdr) \
10542       ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
10543
10544     #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
10545       ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
10546     #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
10547       ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook)\
10548        (abfd, filehdr, aouthdr))
10549
10550     #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section, flags_ptr)\
10551       ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
10552        (abfd, scnhdr, name, section, flags_ptr))
10553
10554     #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
10555       ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
10556
10557     #define bfd_coff_slurp_symbol_table(abfd)\
10558       ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
10559
10560     #define bfd_coff_symname_in_debug(abfd, sym)\
10561       ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
10562
10563     #define bfd_coff_force_symnames_in_strings(abfd)\
10564       (coff_backend_info (abfd)->_bfd_coff_force_symnames_in_strings)
10565
10566     #define bfd_coff_debug_string_prefix_length(abfd)\
10567       (coff_backend_info (abfd)->_bfd_coff_debug_string_prefix_length)
10568
10569     #define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
10570       ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
10571        (abfd, file, base, symbol, aux, indaux))
10572
10573     #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order,\
10574                                          reloc, data, src_ptr, dst_ptr)\
10575       ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
10576        (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
10577
10578     #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
10579       ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
10580        (abfd, section, reloc, shrink, link_info))
10581
10582     #define bfd_coff_classify_symbol(abfd, sym)\
10583       ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
10584        (abfd, sym))
10585
10586     #define bfd_coff_compute_section_file_positions(abfd)\
10587       ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
10588        (abfd))
10589
10590     #define bfd_coff_start_final_link(obfd, info)\
10591       ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
10592        (obfd, info))
10593     #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
10594       ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
10595        (obfd, info, ibfd, o, con, rel, isyms, secs))
10596     #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
10597       ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
10598        (abfd, sec, rel, h, sym, addendp))
10599     #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
10600       ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
10601        (obfd, info, ibfd, sec, rel, adjustedp))
10602     #define bfd_coff_link_add_one_symbol(info, abfd, name, flags, section,\
10603                                          value, string, cp, coll, hashp)\
10604       ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
10605        (info, abfd, name, flags, section, value, string, cp, coll, hashp))
10606
10607     #define bfd_coff_link_output_has_begun(a,p) \
10608       ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a, p))
10609     #define bfd_coff_final_link_postscript(a,p) \
10610       ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a, p))
10611
10612     #define bfd_coff_have_print_pdata(a) \
10613       (coff_backend_info (a)->_bfd_coff_print_pdata)
10614     #define bfd_coff_print_pdata(a,p) \
10615       ((coff_backend_info (a)->_bfd_coff_print_pdata) (a, p))
10616
10617     /* Macro: Returns true if the bfd is a PE executable as opposed to a
10618        PE object file.  */
10619     #define bfd_pei_p(abfd) \
10620       (CONST_STRNEQ ((abfd)->xvec->name, "pei-"))
10621
106223.3.2.8 Writing relocations
10623...........................
10624
10625To write relocations, the back end steps though the canonical relocation
10626table and create an 'internal_reloc'.  The symbol index to use is
10627removed from the 'offset' field in the symbol table supplied.  The
10628address comes directly from the sum of the section base address and the
10629relocation offset; the type is dug directly from the howto field.  Then
10630the 'internal_reloc' is swapped into the shape of an 'external_reloc'
10631and written out to disk.
10632
106333.3.2.9 Reading linenumbers
10634...........................
10635
10636Creating the linenumber table is done by reading in the entire coff
10637linenumber table, and creating another table for internal use.
10638
10639   A coff linenumber table is structured so that each function is marked
10640as having a line number of 0.  Each line within the function is an
10641offset from the first line in the function.  The base of the line number
10642information for the table is stored in the symbol associated with the
10643function.
10644
10645   Note: The PE format uses line number 0 for a flag indicating a new
10646source file.
10647
10648   The information is copied from the external to the internal table,
10649and each symbol which marks a function is marked by pointing its...
10650
10651   How does this work ?
10652
106533.3.2.10 Reading relocations
10654............................
10655
10656Coff relocations are easily transformed into the internal BFD form
10657('arelent').
10658
10659   Reading a coff relocation table is done in the following stages:
10660
10661   * Read the entire coff relocation table into memory.
10662
10663   * Process each relocation in turn; first swap it from the external to
10664     the internal form.
10665
10666   * Turn the symbol referenced in the relocation's symbol index into a
10667     pointer into the canonical symbol table.  This table is the same as
10668     the one returned by a call to 'bfd_canonicalize_symtab'.  The back
10669     end will call that routine and save the result if a
10670     canonicalization hasn't been done.
10671
10672   * The reloc index is turned into a pointer to a howto structure, in a
10673     back end specific way.  For instance, the 386 uses the 'r_type' to
10674     directly produce an index into a howto table vector.
10675
10676
10677File: bfd.info,  Node: elf,  Next: mmo,  Prev: coff,  Up: BFD back ends
10678
106793.4 ELF backends
10680================
10681
10682BFD support for ELF formats is being worked on.  Currently, the best
10683supported back ends are for sparc and i386 (running svr4 or Solaris 2).
10684
10685   Documentation of the internals of the support code still needs to be
10686written.  The code is changing quickly enough that we haven't bothered
10687yet.
10688
10689
10690File: bfd.info,  Node: mmo,  Prev: elf,  Up: BFD back ends
10691
106923.5 mmo backend
10693===============
10694
10695The mmo object format is used exclusively together with Professor Donald
10696E. Knuth's educational 64-bit processor MMIX. The simulator 'mmix' which
10697is available at <http://mmix.cs.hm.edu/src/index.html> understands this
10698format.  That package also includes a combined assembler and linker
10699called 'mmixal'.  The mmo format has no advantages feature-wise compared
10700to e.g.  ELF. It is a simple non-relocatable object format with no
10701support for archives or debugging information, except for symbol value
10702information and line numbers (which is not yet implemented in BFD). See
10703<http://mmix.cs.hm.edu/> for more information about MMIX. The ELF format
10704is used for intermediate object files in the BFD implementation.
10705
10706* Menu:
10707
10708* File layout::
10709* Symbol-table::
10710* mmo section mapping::
10711
10712
10713File: bfd.info,  Node: File layout,  Next: Symbol-table,  Prev: mmo,  Up: mmo
10714
107153.5.1 File layout
10716-----------------
10717
10718The mmo file contents is not partitioned into named sections as with
10719e.g. ELF. Memory areas is formed by specifying the location of the data
10720that follows.  Only the memory area '0x0000...00' to '0x01ff...ff' is
10721executable, so it is used for code (and constants) and the area
10722'0x2000...00' to '0x20ff...ff' is used for writable data.  *Note mmo
10723section mapping::.
10724
10725   There is provision for specifying "special data" of 65536 different
10726types.  We use type 80 (decimal), arbitrarily chosen the same as the ELF
10727'e_machine' number for MMIX, filling it with section information
10728normally found in ELF objects.  *Note mmo section mapping::.
10729
10730   Contents is entered as 32-bit words, xor:ed over previous contents,
10731always zero-initialized.  A word that starts with the byte '0x98' forms
10732a command called a 'lopcode', where the next byte distinguished between
10733the thirteen lopcodes.  The two remaining bytes, called the 'Y' and 'Z'
10734fields, or the 'YZ' field (a 16-bit big-endian number), are used for
10735various purposes different for each lopcode.  As documented in
10736<http://mmix.cs.hm.edu/doc/mmixal.pdf>, the lopcodes are:
10737
10738'lop_quote'
10739     0x98000001.  The next word is contents, regardless of whether it
10740     starts with 0x98 or not.
10741
10742'lop_loc'
10743     0x9801YYZZ, where 'Z' is 1 or 2.  This is a location directive,
10744     setting the location for the next data to the next 32-bit word (for
10745     Z = 1) or 64-bit word (for Z = 2), plus Y * 2^56.  Normally 'Y' is
10746     0 for the text segment and 2 for the data segment.  Beware that the
10747     low bits of non- tetrabyte-aligned values are silently discarded
10748     when being automatically incremented and when storing contents (in
10749     contrast to e.g.  its use as current location when followed by
10750     lop_fixo et al before the next possibly-quoted tetrabyte contents).
10751
10752'lop_skip'
10753     0x9802YYZZ. Increase the current location by 'YZ' bytes.
10754
10755'lop_fixo'
10756     0x9803YYZZ, where 'Z' is 1 or 2.  Store the current location as 64
10757     bits into the location pointed to by the next 32-bit (Z = 1) or
10758     64-bit (Z = 2) word, plus Y * 2^56.
10759
10760'lop_fixr'
10761     0x9804YYZZ. 'YZ' is stored into the current location plus 2 - 4 *
10762     YZ.
10763
10764'lop_fixrx'
10765     0x980500ZZ. 'Z' is 16 or 24.  A value 'L' derived from the
10766     following 32-bit word are used in a manner similar to 'YZ' in
10767     lop_fixr: it is xor:ed into the current location minus 4 * L. The
10768     first byte of the word is 0 or 1.  If it is 1, then L = (LOWEST 24
10769     BITS OF WORD) - 2^Z, if 0, then L = (LOWEST 24 BITS OF WORD).
10770
10771'lop_file'
10772     0x9806YYZZ. 'Y' is the file number, 'Z' is count of 32-bit words.
10773     Set the file number to 'Y' and the line counter to 0.  The next Z *
10774     4 bytes contain the file name, padded with zeros if the count is
10775     not a multiple of four.  The same 'Y' may occur multiple times, but
10776     'Z' must be 0 for all but the first occurrence.
10777
10778'lop_line'
10779     0x9807YYZZ. 'YZ' is the line number.  Together with lop_file, it
10780     forms the source location for the next 32-bit word.  Note that for
10781     each non-lopcode 32-bit word, line numbers are assumed incremented
10782     by one.
10783
10784'lop_spec'
10785     0x9808YYZZ. 'YZ' is the type number.  Data until the next lopcode
10786     other than lop_quote forms special data of type 'YZ'.  *Note mmo
10787     section mapping::.
10788
10789     Other types than 80, (or type 80 with a content that does not
10790     parse) is stored in sections named '.MMIX.spec_data.N' where N is
10791     the 'YZ'-type.  The flags for such a sections say not to allocate
10792     or load the data.  The vma is 0.  Contents of multiple occurrences
10793     of special data N is concatenated to the data of the previous
10794     lop_spec Ns.  The location in data or code at which the lop_spec
10795     occurred is lost.
10796
10797'lop_pre'
10798     0x980901ZZ. The first lopcode in a file.  The 'Z' field forms the
10799     length of header information in 32-bit words, where the first word
10800     tells the time in seconds since '00:00:00 GMT Jan 1 1970'.
10801
10802'lop_post'
10803     0x980a00ZZ. Z > 32.  This lopcode follows after all
10804     content-generating lopcodes in a program.  The 'Z' field denotes
10805     the value of 'rG' at the beginning of the program.  The following
10806     256 - Z big-endian 64-bit words are loaded into global registers
10807     '$G' ... '$255'.
10808
10809'lop_stab'
10810     0x980b0000.  The next-to-last lopcode in a program.  Must follow
10811     immediately after the lop_post lopcode and its data.  After this
10812     lopcode follows all symbols in a compressed format (*note
10813     Symbol-table::).
10814
10815'lop_end'
10816     0x980cYYZZ. The last lopcode in a program.  It must follow the
10817     lop_stab lopcode and its data.  The 'YZ' field contains the number
10818     of 32-bit words of symbol table information after the preceding
10819     lop_stab lopcode.
10820
10821   Note that the lopcode "fixups"; 'lop_fixr', 'lop_fixrx' and
10822'lop_fixo' are not generated by BFD, but are handled.  They are
10823generated by 'mmixal'.
10824
10825   This trivial one-label, one-instruction file:
10826
10827      :Main TRAP 1,2,3
10828
10829   can be represented this way in mmo:
10830
10831      0x98090101 - lop_pre, one 32-bit word with timestamp.
10832      <timestamp>
10833      0x98010002 - lop_loc, text segment, using a 64-bit address.
10834                   Note that mmixal does not emit this for the file above.
10835      0x00000000 - Address, high 32 bits.
10836      0x00000000 - Address, low 32 bits.
10837      0x98060002 - lop_file, 2 32-bit words for file-name.
10838      0x74657374 - "test"
10839      0x2e730000 - ".s\0\0"
10840      0x98070001 - lop_line, line 1.
10841      0x00010203 - TRAP 1,2,3
10842      0x980a00ff - lop_post, setting $255 to 0.
10843      0x00000000
10844      0x00000000
10845      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10846      0x203a4040   *Note Symbol-table::.
10847      0x10404020
10848      0x4d206120
10849      0x69016e00
10850      0x81000000
10851      0x980c0005 - lop_end; symbol table contained five 32-bit words.
10852
10853
10854File: bfd.info,  Node: Symbol-table,  Next: mmo section mapping,  Prev: File layout,  Up: mmo
10855
108563.5.2 Symbol table format
10857-------------------------
10858
10859From mmixal.w (or really, the generated mmixal.tex) in the MMIXware
10860package which also contains the 'mmix' simulator: "Symbols are stored
10861and retrieved by means of a 'ternary search trie', following ideas of
10862Bentley and Sedgewick.  (See ACM-SIAM Symp. on Discrete Algorithms '8'
10863(1997), 360-369; R.Sedgewick, 'Algorithms in C' (Reading, Mass.
10864Addison-Wesley, 1998), '15.4'.)  Each trie node stores a character, and
10865there are branches to subtries for the cases where a given character is
10866less than, equal to, or greater than the character in the trie.  There
10867also is a pointer to a symbol table entry if a symbol ends at the
10868current node."
10869
10870   So it's a tree encoded as a stream of bytes.  The stream of bytes
10871acts on a single virtual global symbol, adding and removing characters
10872and signalling complete symbol points.  Here, we read the stream and
10873create symbols at the completion points.
10874
10875   First, there's a control byte 'm'.  If any of the listed bits in 'm'
10876is nonzero, we execute what stands at the right, in the listed order:
10877
10878      (MMO3_LEFT)
10879      0x40 - Traverse left trie.
10880             (Read a new command byte and recurse.)
10881
10882      (MMO3_SYMBITS)
10883      0x2f - Read the next byte as a character and store it in the
10884             current character position; increment character position.
10885             Test the bits of m:
10886
10887             (MMO3_WCHAR)
10888             0x80 - The character is 16-bit (so read another byte,
10889                    merge into current character.
10890
10891             (MMO3_TYPEBITS)
10892             0xf  - We have a complete symbol; parse the type, value
10893                    and serial number and do what should be done
10894                    with a symbol.  The type and length information
10895                    is in j = (m & 0xf).
10896
10897                    (MMO3_REGQUAL_BITS)
10898                    j == 0xf: A register variable.  The following
10899                              byte tells which register.
10900                    j <= 8:   An absolute symbol.  Read j bytes as the
10901                              big-endian number the symbol equals.
10902                              A j = 2 with two zero bytes denotes an
10903                              unknown symbol.
10904                    j > 8:    As with j <= 8, but add (0x20 << 56)
10905                              to the value in the following j - 8
10906                              bytes.
10907
10908                    Then comes the serial number, as a variant of
10909                    uleb128, but better named ubeb128:
10910                    Read bytes and shift the previous value left 7
10911                    (multiply by 128).  Add in the new byte, repeat
10912                    until a byte has bit 7 set.  The serial number
10913                    is the computed value minus 128.
10914
10915             (MMO3_MIDDLE)
10916             0x20 - Traverse middle trie.  (Read a new command byte
10917                    and recurse.)  Decrement character position.
10918
10919      (MMO3_RIGHT)
10920      0x10 - Traverse right trie.  (Read a new command byte and
10921             recurse.)
10922
10923   Let's look again at the 'lop_stab' for the trivial file (*note File
10924layout::).
10925
10926      0x980b0000 - lop_stab for ":Main" = 0, serial 1.
10927      0x203a4040
10928      0x10404020
10929      0x4d206120
10930      0x69016e00
10931      0x81000000
10932
10933   This forms the trivial trie (note that the path between ":" and "M"
10934is redundant):
10935
10936      203a     ":"
10937      40       /
10938      40      /
10939      10      \
10940      40      /
10941      40     /
10942      204d  "M"
10943      2061  "a"
10944      2069  "i"
10945      016e  "n" is the last character in a full symbol, and
10946            with a value represented in one byte.
10947      00    The value is 0.
10948      81    The serial number is 1.
10949
10950
10951File: bfd.info,  Node: mmo section mapping,  Prev: Symbol-table,  Up: mmo
10952
109533.5.3 mmo section mapping
10954-------------------------
10955
10956The implementation in BFD uses special data type 80 (decimal) to
10957encapsulate and describe named sections, containing e.g. debug
10958information.  If needed, any datum in the encapsulation will be quoted
10959using lop_quote.  First comes a 32-bit word holding the number of 32-bit
10960words containing the zero-terminated zero-padded segment name.  After
10961the name there's a 32-bit word holding flags describing the section
10962type.  Then comes a 64-bit big-endian word with the section length (in
10963bytes), then another with the section start address.  Depending on the
10964type of section, the contents might follow, zero-padded to 32-bit
10965boundary.  For a loadable section (such as data or code), the contents
10966might follow at some later point, not necessarily immediately, as a
10967lop_loc with the same start address as in the section description,
10968followed by the contents.  This in effect forms a descriptor that must
10969be emitted before the actual contents.  Sections described this way must
10970not overlap.
10971
10972   For areas that don't have such descriptors, synthetic sections are
10973formed by BFD. Consecutive contents in the two memory areas
10974'0x0000...00' to '0x01ff...ff' and '0x2000...00' to '0x20ff...ff' are
10975entered in sections named '.text' and '.data' respectively.  If an area
10976is not otherwise described, but would together with a neighboring lower
10977area be less than '0x40000000' bytes long, it is joined with the lower
10978area and the gap is zero-filled.  For other cases, a new section is
10979formed, named '.MMIX.sec.N'.  Here, N is a number, a running count
10980through the mmo file, starting at 0.
10981
10982   A loadable section specified as:
10983
10984      .section secname,"ax"
10985      TETRA 1,2,3,4,-1,-2009
10986      BYTE 80
10987
10988   and linked to address '0x4', is represented by the sequence:
10989
10990      0x98080050 - lop_spec 80
10991      0x00000002 - two 32-bit words for the section name
10992      0x7365636e - "secn"
10993      0x616d6500 - "ame\0"
10994      0x00000033 - flags CODE, READONLY, LOAD, ALLOC
10995      0x00000000 - high 32 bits of section length
10996      0x0000001c - section length is 28 bytes; 6 * 4 + 1 + alignment to 32 bits
10997      0x00000000 - high 32 bits of section address
10998      0x00000004 - section address is 4
10999      0x98010002 - 64 bits with address of following data
11000      0x00000000 - high 32 bits of address
11001      0x00000004 - low 32 bits: data starts at address 4
11002      0x00000001 - 1
11003      0x00000002 - 2
11004      0x00000003 - 3
11005      0x00000004 - 4
11006      0xffffffff - -1
11007      0xfffff827 - -2009
11008      0x50000000 - 80 as a byte, padded with zeros.
11009
11010   Note that the lop_spec wrapping does not include the section
11011contents.  Compare this to a non-loaded section specified as:
11012
11013      .section thirdsec
11014      TETRA 200001,100002
11015      BYTE 38,40
11016
11017   This, when linked to address '0x200000000000001c', is represented by:
11018
11019      0x98080050 - lop_spec 80
11020      0x00000002 - two 32-bit words for the section name
11021      0x7365636e - "thir"
11022      0x616d6500 - "dsec"
11023      0x00000010 - flag READONLY
11024      0x00000000 - high 32 bits of section length
11025      0x0000000c - section length is 12 bytes; 2 * 4 + 2 + alignment to 32 bits
11026      0x20000000 - high 32 bits of address
11027      0x0000001c - low 32 bits of address 0x200000000000001c
11028      0x00030d41 - 200001
11029      0x000186a2 - 100002
11030      0x26280000 - 38, 40 as bytes, padded with zeros
11031
11032   For the latter example, the section contents must not be loaded in
11033memory, and is therefore specified as part of the special data.  The
11034address is usually unimportant but might provide information for e.g.
11035the DWARF 2 debugging format.
11036
11037
11038File: bfd.info,  Node: GNU Free Documentation License,  Next: BFD Index,  Prev: BFD back ends,  Up: Top
11039
11040                     Version 1.3, 3 November 2008
11041
11042     Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
11043     <http://fsf.org/>
11044
11045     Everyone is permitted to copy and distribute verbatim copies
11046     of this license document, but changing it is not allowed.
11047
11048  0. PREAMBLE
11049
11050     The purpose of this License is to make a manual, textbook, or other
11051     functional and useful document "free" in the sense of freedom: to
11052     assure everyone the effective freedom to copy and redistribute it,
11053     with or without modifying it, either commercially or
11054     noncommercially.  Secondarily, this License preserves for the
11055     author and publisher a way to get credit for their work, while not
11056     being considered responsible for modifications made by others.
11057
11058     This License is a kind of "copyleft", which means that derivative
11059     works of the document must themselves be free in the same sense.
11060     It complements the GNU General Public License, which is a copyleft
11061     license designed for free software.
11062
11063     We have designed this License in order to use it for manuals for
11064     free software, because free software needs free documentation: a
11065     free program should come with manuals providing the same freedoms
11066     that the software does.  But this License is not limited to
11067     software manuals; it can be used for any textual work, regardless
11068     of subject matter or whether it is published as a printed book.  We
11069     recommend this License principally for works whose purpose is
11070     instruction or reference.
11071
11072  1. APPLICABILITY AND DEFINITIONS
11073
11074     This License applies to any manual or other work, in any medium,
11075     that contains a notice placed by the copyright holder saying it can
11076     be distributed under the terms of this License.  Such a notice
11077     grants a world-wide, royalty-free license, unlimited in duration,
11078     to use that work under the conditions stated herein.  The
11079     "Document", below, refers to any such manual or work.  Any member
11080     of the public is a licensee, and is addressed as "you".  You accept
11081     the license if you copy, modify or distribute the work in a way
11082     requiring permission under copyright law.
11083
11084     A "Modified Version" of the Document means any work containing the
11085     Document or a portion of it, either copied verbatim, or with
11086     modifications and/or translated into another language.
11087
11088     A "Secondary Section" is a named appendix or a front-matter section
11089     of the Document that deals exclusively with the relationship of the
11090     publishers or authors of the Document to the Document's overall
11091     subject (or to related matters) and contains nothing that could
11092     fall directly within that overall subject.  (Thus, if the Document
11093     is in part a textbook of mathematics, a Secondary Section may not
11094     explain any mathematics.)  The relationship could be a matter of
11095     historical connection with the subject or with related matters, or
11096     of legal, commercial, philosophical, ethical or political position
11097     regarding them.
11098
11099     The "Invariant Sections" are certain Secondary Sections whose
11100     titles are designated, as being those of Invariant Sections, in the
11101     notice that says that the Document is released under this License.
11102     If a section does not fit the above definition of Secondary then it
11103     is not allowed to be designated as Invariant.  The Document may
11104     contain zero Invariant Sections.  If the Document does not identify
11105     any Invariant Sections then there are none.
11106
11107     The "Cover Texts" are certain short passages of text that are
11108     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
11109     that says that the Document is released under this License.  A
11110     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
11111     be at most 25 words.
11112
11113     A "Transparent" copy of the Document means a machine-readable copy,
11114     represented in a format whose specification is available to the
11115     general public, that is suitable for revising the document
11116     straightforwardly with generic text editors or (for images composed
11117     of pixels) generic paint programs or (for drawings) some widely
11118     available drawing editor, and that is suitable for input to text
11119     formatters or for automatic translation to a variety of formats
11120     suitable for input to text formatters.  A copy made in an otherwise
11121     Transparent file format whose markup, or absence of markup, has
11122     been arranged to thwart or discourage subsequent modification by
11123     readers is not Transparent.  An image format is not Transparent if
11124     used for any substantial amount of text.  A copy that is not
11125     "Transparent" is called "Opaque".
11126
11127     Examples of suitable formats for Transparent copies include plain
11128     ASCII without markup, Texinfo input format, LaTeX input format,
11129     SGML or XML using a publicly available DTD, and standard-conforming
11130     simple HTML, PostScript or PDF designed for human modification.
11131     Examples of transparent image formats include PNG, XCF and JPG.
11132     Opaque formats include proprietary formats that can be read and
11133     edited only by proprietary word processors, SGML or XML for which
11134     the DTD and/or processing tools are not generally available, and
11135     the machine-generated HTML, PostScript or PDF produced by some word
11136     processors for output purposes only.
11137
11138     The "Title Page" means, for a printed book, the title page itself,
11139     plus such following pages as are needed to hold, legibly, the
11140     material this License requires to appear in the title page.  For
11141     works in formats which do not have any title page as such, "Title
11142     Page" means the text near the most prominent appearance of the
11143     work's title, preceding the beginning of the body of the text.
11144
11145     The "publisher" means any person or entity that distributes copies
11146     of the Document to the public.
11147
11148     A section "Entitled XYZ" means a named subunit of the Document
11149     whose title either is precisely XYZ or contains XYZ in parentheses
11150     following text that translates XYZ in another language.  (Here XYZ
11151     stands for a specific section name mentioned below, such as
11152     "Acknowledgements", "Dedications", "Endorsements", or "History".)
11153     To "Preserve the Title" of such a section when you modify the
11154     Document means that it remains a section "Entitled XYZ" according
11155     to this definition.
11156
11157     The Document may include Warranty Disclaimers next to the notice
11158     which states that this License applies to the Document.  These
11159     Warranty Disclaimers are considered to be included by reference in
11160     this License, but only as regards disclaiming warranties: any other
11161     implication that these Warranty Disclaimers may have is void and
11162     has no effect on the meaning of this License.
11163
11164  2. VERBATIM COPYING
11165
11166     You may copy and distribute the Document in any medium, either
11167     commercially or noncommercially, provided that this License, the
11168     copyright notices, and the license notice saying this License
11169     applies to the Document are reproduced in all copies, and that you
11170     add no other conditions whatsoever to those of this License.  You
11171     may not use technical measures to obstruct or control the reading
11172     or further copying of the copies you make or distribute.  However,
11173     you may accept compensation in exchange for copies.  If you
11174     distribute a large enough number of copies you must also follow the
11175     conditions in section 3.
11176
11177     You may also lend copies, under the same conditions stated above,
11178     and you may publicly display copies.
11179
11180  3. COPYING IN QUANTITY
11181
11182     If you publish printed copies (or copies in media that commonly
11183     have printed covers) of the Document, numbering more than 100, and
11184     the Document's license notice requires Cover Texts, you must
11185     enclose the copies in covers that carry, clearly and legibly, all
11186     these Cover Texts: Front-Cover Texts on the front cover, and
11187     Back-Cover Texts on the back cover.  Both covers must also clearly
11188     and legibly identify you as the publisher of these copies.  The
11189     front cover must present the full title with all words of the title
11190     equally prominent and visible.  You may add other material on the
11191     covers in addition.  Copying with changes limited to the covers, as
11192     long as they preserve the title of the Document and satisfy these
11193     conditions, can be treated as verbatim copying in other respects.
11194
11195     If the required texts for either cover are too voluminous to fit
11196     legibly, you should put the first ones listed (as many as fit
11197     reasonably) on the actual cover, and continue the rest onto
11198     adjacent pages.
11199
11200     If you publish or distribute Opaque copies of the Document
11201     numbering more than 100, you must either include a machine-readable
11202     Transparent copy along with each Opaque copy, or state in or with
11203     each Opaque copy a computer-network location from which the general
11204     network-using public has access to download using public-standard
11205     network protocols a complete Transparent copy of the Document, free
11206     of added material.  If you use the latter option, you must take
11207     reasonably prudent steps, when you begin distribution of Opaque
11208     copies in quantity, to ensure that this Transparent copy will
11209     remain thus accessible at the stated location until at least one
11210     year after the last time you distribute an Opaque copy (directly or
11211     through your agents or retailers) of that edition to the public.
11212
11213     It is requested, but not required, that you contact the authors of
11214     the Document well before redistributing any large number of copies,
11215     to give them a chance to provide you with an updated version of the
11216     Document.
11217
11218  4. MODIFICATIONS
11219
11220     You may copy and distribute a Modified Version of the Document
11221     under the conditions of sections 2 and 3 above, provided that you
11222     release the Modified Version under precisely this License, with the
11223     Modified Version filling the role of the Document, thus licensing
11224     distribution and modification of the Modified Version to whoever
11225     possesses a copy of it.  In addition, you must do these things in
11226     the Modified Version:
11227
11228       A. Use in the Title Page (and on the covers, if any) a title
11229          distinct from that of the Document, and from those of previous
11230          versions (which should, if there were any, be listed in the
11231          History section of the Document).  You may use the same title
11232          as a previous version if the original publisher of that
11233          version gives permission.
11234
11235       B. List on the Title Page, as authors, one or more persons or
11236          entities responsible for authorship of the modifications in
11237          the Modified Version, together with at least five of the
11238          principal authors of the Document (all of its principal
11239          authors, if it has fewer than five), unless they release you
11240          from this requirement.
11241
11242       C. State on the Title page the name of the publisher of the
11243          Modified Version, as the publisher.
11244
11245       D. Preserve all the copyright notices of the Document.
11246
11247       E. Add an appropriate copyright notice for your modifications
11248          adjacent to the other copyright notices.
11249
11250       F. Include, immediately after the copyright notices, a license
11251          notice giving the public permission to use the Modified
11252          Version under the terms of this License, in the form shown in
11253          the Addendum below.
11254
11255       G. Preserve in that license notice the full lists of Invariant
11256          Sections and required Cover Texts given in the Document's
11257          license notice.
11258
11259       H. Include an unaltered copy of this License.
11260
11261       I. Preserve the section Entitled "History", Preserve its Title,
11262          and add to it an item stating at least the title, year, new
11263          authors, and publisher of the Modified Version as given on the
11264          Title Page.  If there is no section Entitled "History" in the
11265          Document, create one stating the title, year, authors, and
11266          publisher of the Document as given on its Title Page, then add
11267          an item describing the Modified Version as stated in the
11268          previous sentence.
11269
11270       J. Preserve the network location, if any, given in the Document
11271          for public access to a Transparent copy of the Document, and
11272          likewise the network locations given in the Document for
11273          previous versions it was based on.  These may be placed in the
11274          "History" section.  You may omit a network location for a work
11275          that was published at least four years before the Document
11276          itself, or if the original publisher of the version it refers
11277          to gives permission.
11278
11279       K. For any section Entitled "Acknowledgements" or "Dedications",
11280          Preserve the Title of the section, and preserve in the section
11281          all the substance and tone of each of the contributor
11282          acknowledgements and/or dedications given therein.
11283
11284       L. Preserve all the Invariant Sections of the Document, unaltered
11285          in their text and in their titles.  Section numbers or the
11286          equivalent are not considered part of the section titles.
11287
11288       M. Delete any section Entitled "Endorsements".  Such a section
11289          may not be included in the Modified Version.
11290
11291       N. Do not retitle any existing section to be Entitled
11292          "Endorsements" or to conflict in title with any Invariant
11293          Section.
11294
11295       O. Preserve any Warranty Disclaimers.
11296
11297     If the Modified Version includes new front-matter sections or
11298     appendices that qualify as Secondary Sections and contain no
11299     material copied from the Document, you may at your option designate
11300     some or all of these sections as invariant.  To do this, add their
11301     titles to the list of Invariant Sections in the Modified Version's
11302     license notice.  These titles must be distinct from any other
11303     section titles.
11304
11305     You may add a section Entitled "Endorsements", provided it contains
11306     nothing but endorsements of your Modified Version by various
11307     parties--for example, statements of peer review or that the text
11308     has been approved by an organization as the authoritative
11309     definition of a standard.
11310
11311     You may add a passage of up to five words as a Front-Cover Text,
11312     and a passage of up to 25 words as a Back-Cover Text, to the end of
11313     the list of Cover Texts in the Modified Version.  Only one passage
11314     of Front-Cover Text and one of Back-Cover Text may be added by (or
11315     through arrangements made by) any one entity.  If the Document
11316     already includes a cover text for the same cover, previously added
11317     by you or by arrangement made by the same entity you are acting on
11318     behalf of, you may not add another; but you may replace the old
11319     one, on explicit permission from the previous publisher that added
11320     the old one.
11321
11322     The author(s) and publisher(s) of the Document do not by this
11323     License give permission to use their names for publicity for or to
11324     assert or imply endorsement of any Modified Version.
11325
11326  5. COMBINING DOCUMENTS
11327
11328     You may combine the Document with other documents released under
11329     this License, under the terms defined in section 4 above for
11330     modified versions, provided that you include in the combination all
11331     of the Invariant Sections of all of the original documents,
11332     unmodified, and list them all as Invariant Sections of your
11333     combined work in its license notice, and that you preserve all
11334     their Warranty Disclaimers.
11335
11336     The combined work need only contain one copy of this License, and
11337     multiple identical Invariant Sections may be replaced with a single
11338     copy.  If there are multiple Invariant Sections with the same name
11339     but different contents, make the title of each such section unique
11340     by adding at the end of it, in parentheses, the name of the
11341     original author or publisher of that section if known, or else a
11342     unique number.  Make the same adjustment to the section titles in
11343     the list of Invariant Sections in the license notice of the
11344     combined work.
11345
11346     In the combination, you must combine any sections Entitled
11347     "History" in the various original documents, forming one section
11348     Entitled "History"; likewise combine any sections Entitled
11349     "Acknowledgements", and any sections Entitled "Dedications".  You
11350     must delete all sections Entitled "Endorsements."
11351
11352  6. COLLECTIONS OF DOCUMENTS
11353
11354     You may make a collection consisting of the Document and other
11355     documents released under this License, and replace the individual
11356     copies of this License in the various documents with a single copy
11357     that is included in the collection, provided that you follow the
11358     rules of this License for verbatim copying of each of the documents
11359     in all other respects.
11360
11361     You may extract a single document from such a collection, and
11362     distribute it individually under this License, provided you insert
11363     a copy of this License into the extracted document, and follow this
11364     License in all other respects regarding verbatim copying of that
11365     document.
11366
11367  7. AGGREGATION WITH INDEPENDENT WORKS
11368
11369     A compilation of the Document or its derivatives with other
11370     separate and independent documents or works, in or on a volume of a
11371     storage or distribution medium, is called an "aggregate" if the
11372     copyright resulting from the compilation is not used to limit the
11373     legal rights of the compilation's users beyond what the individual
11374     works permit.  When the Document is included in an aggregate, this
11375     License does not apply to the other works in the aggregate which
11376     are not themselves derivative works of the Document.
11377
11378     If the Cover Text requirement of section 3 is applicable to these
11379     copies of the Document, then if the Document is less than one half
11380     of the entire aggregate, the Document's Cover Texts may be placed
11381     on covers that bracket the Document within the aggregate, or the
11382     electronic equivalent of covers if the Document is in electronic
11383     form.  Otherwise they must appear on printed covers that bracket
11384     the whole aggregate.
11385
11386  8. TRANSLATION
11387
11388     Translation is considered a kind of modification, so you may
11389     distribute translations of the Document under the terms of section
11390     4.  Replacing Invariant Sections with translations requires special
11391     permission from their copyright holders, but you may include
11392     translations of some or all Invariant Sections in addition to the
11393     original versions of these Invariant Sections.  You may include a
11394     translation of this License, and all the license notices in the
11395     Document, and any Warranty Disclaimers, provided that you also
11396     include the original English version of this License and the
11397     original versions of those notices and disclaimers.  In case of a
11398     disagreement between the translation and the original version of
11399     this License or a notice or disclaimer, the original version will
11400     prevail.
11401
11402     If a section in the Document is Entitled "Acknowledgements",
11403     "Dedications", or "History", the requirement (section 4) to
11404     Preserve its Title (section 1) will typically require changing the
11405     actual title.
11406
11407  9. TERMINATION
11408
11409     You may not copy, modify, sublicense, or distribute the Document
11410     except as expressly provided under this License.  Any attempt
11411     otherwise to copy, modify, sublicense, or distribute it is void,
11412     and will automatically terminate your rights under this License.
11413
11414     However, if you cease all violation of this License, then your
11415     license from a particular copyright holder is reinstated (a)
11416     provisionally, unless and until the copyright holder explicitly and
11417     finally terminates your license, and (b) permanently, if the
11418     copyright holder fails to notify you of the violation by some
11419     reasonable means prior to 60 days after the cessation.
11420
11421     Moreover, your license from a particular copyright holder is
11422     reinstated permanently if the copyright holder notifies you of the
11423     violation by some reasonable means, this is the first time you have
11424     received notice of violation of this License (for any work) from
11425     that copyright holder, and you cure the violation prior to 30 days
11426     after your receipt of the notice.
11427
11428     Termination of your rights under this section does not terminate
11429     the licenses of parties who have received copies or rights from you
11430     under this License.  If your rights have been terminated and not
11431     permanently reinstated, receipt of a copy of some or all of the
11432     same material does not give you any rights to use it.
11433
11434  10. FUTURE REVISIONS OF THIS LICENSE
11435
11436     The Free Software Foundation may publish new, revised versions of
11437     the GNU Free Documentation License from time to time.  Such new
11438     versions will be similar in spirit to the present version, but may
11439     differ in detail to address new problems or concerns.  See
11440     <http://www.gnu.org/copyleft/>.
11441
11442     Each version of the License is given a distinguishing version
11443     number.  If the Document specifies that a particular numbered
11444     version of this License "or any later version" applies to it, you
11445     have the option of following the terms and conditions either of
11446     that specified version or of any later version that has been
11447     published (not as a draft) by the Free Software Foundation.  If the
11448     Document does not specify a version number of this License, you may
11449     choose any version ever published (not as a draft) by the Free
11450     Software Foundation.  If the Document specifies that a proxy can
11451     decide which future versions of this License can be used, that
11452     proxy's public statement of acceptance of a version permanently
11453     authorizes you to choose that version for the Document.
11454
11455  11. RELICENSING
11456
11457     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
11458     World Wide Web server that publishes copyrightable works and also
11459     provides prominent facilities for anybody to edit those works.  A
11460     public wiki that anybody can edit is an example of such a server.
11461     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
11462     site means any set of copyrightable works thus published on the MMC
11463     site.
11464
11465     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
11466     license published by Creative Commons Corporation, a not-for-profit
11467     corporation with a principal place of business in San Francisco,
11468     California, as well as future copyleft versions of that license
11469     published by that same organization.
11470
11471     "Incorporate" means to publish or republish a Document, in whole or
11472     in part, as part of another Document.
11473
11474     An MMC is "eligible for relicensing" if it is licensed under this
11475     License, and if all works that were first published under this
11476     License somewhere other than this MMC, and subsequently
11477     incorporated in whole or in part into the MMC, (1) had no cover
11478     texts or invariant sections, and (2) were thus incorporated prior
11479     to November 1, 2008.
11480
11481     The operator of an MMC Site may republish an MMC contained in the
11482     site under CC-BY-SA on the same site at any time before August 1,
11483     2009, provided the MMC is eligible for relicensing.
11484
11485ADDENDUM: How to use this License for your documents
11486====================================================
11487
11488To use this License in a document you have written, include a copy of
11489the License in the document and put the following copyright and license
11490notices just after the title page:
11491
11492       Copyright (C)  YEAR  YOUR NAME.
11493       Permission is granted to copy, distribute and/or modify this document
11494       under the terms of the GNU Free Documentation License, Version 1.3
11495       or any later version published by the Free Software Foundation;
11496       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
11497       Texts.  A copy of the license is included in the section entitled ``GNU
11498       Free Documentation License''.
11499
11500   If you have Invariant Sections, Front-Cover Texts and Back-Cover
11501Texts, replace the "with...Texts."  line with this:
11502
11503         with the Invariant Sections being LIST THEIR TITLES, with
11504         the Front-Cover Texts being LIST, and with the Back-Cover Texts
11505         being LIST.
11506
11507   If you have Invariant Sections without Cover Texts, or some other
11508combination of the three, merge those two alternatives to suit the
11509situation.
11510
11511   If your document contains nontrivial examples of program code, we
11512recommend releasing these examples in parallel under your choice of free
11513software license, such as the GNU General Public License, to permit
11514their use in free software.
11515
11516
11517File: bfd.info,  Node: BFD Index,  Prev: GNU Free Documentation License,  Up: Top
11518
11519BFD Index
11520*********
11521
11522[index]
11523* Menu:
11524
11525* _bfd_error_handler:                    Error reporting.    (line  111)
11526* _bfd_final_link_relocate:              Relocating the section contents.
11527                                                             (line   22)
11528* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
11529                                                             (line   15)
11530* _bfd_generic_link_add_one_symbol:      Adding symbols from an object file.
11531                                                             (line   19)
11532* _bfd_generic_link_check_relocs:        Writing the symbol table.
11533                                                             (line  144)
11534* _bfd_generic_link_hide_symbol:         Writing the symbol table.
11535                                                             (line   83)
11536* _bfd_generic_make_empty_symbol:        symbol handling functions.
11537                                                             (line   96)
11538* _bfd_generic_set_reloc:                howto manager.      (line 3387)
11539* _bfd_generic_verify_endian_match:      Writing the symbol table.
11540                                                             (line  172)
11541* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
11542                                                             (line    6)
11543* _bfd_link_final_link in target vector: Performing the Final Link.
11544                                                             (line    6)
11545* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
11546                                                             (line    6)
11547* _bfd_relocate_contents:                Relocating the section contents.
11548                                                             (line   22)
11549* _bfd_unrecognized_reloc:               howto manager.      (line 3399)
11550* aout_SIZE_machine_type:                aout.               (line  145)
11551* aout_SIZE_mkobject:                    aout.               (line  137)
11552* aout_SIZE_new_section_hook:            aout.               (line  175)
11553* aout_SIZE_set_arch_mach:               aout.               (line  162)
11554* aout_SIZE_some_aout_object_p:          aout.               (line  123)
11555* aout_SIZE_swap_exec_header_in:         aout.               (line   99)
11556* aout_SIZE_swap_exec_header_out:        aout.               (line  111)
11557* arelent_chain:                         typedef arelent.    (line  339)
11558* BFD:                                   Overview.           (line    6)
11559* BFD canonical format:                  Canonical format.   (line   11)
11560* bfd_alloc:                             Opening and Closing.
11561                                                             (line  239)
11562* bfd_alloc2:                            Opening and Closing.
11563                                                             (line  248)
11564* bfd_alt_mach_code:                     Miscellaneous.      (line  288)
11565* bfd_arch_bits_per_address:             Architectures.      (line  618)
11566* bfd_arch_bits_per_byte:                Architectures.      (line  610)
11567* bfd_arch_default_fill:                 Architectures.      (line  699)
11568* bfd_arch_get_compatible:               Architectures.      (line  553)
11569* bfd_arch_list:                         Architectures.      (line  544)
11570* bfd_arch_mach_octets_per_byte:         Architectures.      (line  687)
11571* BFD_ARELOC_BFIN_ADD:                   howto manager.      (line 1100)
11572* BFD_ARELOC_BFIN_ADDR:                  howto manager.      (line 1134)
11573* BFD_ARELOC_BFIN_AND:                   howto manager.      (line 1114)
11574* BFD_ARELOC_BFIN_COMP:                  howto manager.      (line 1128)
11575* BFD_ARELOC_BFIN_CONST:                 howto manager.      (line 1098)
11576* BFD_ARELOC_BFIN_DIV:                   howto manager.      (line 1106)
11577* BFD_ARELOC_BFIN_HWPAGE:                howto manager.      (line 1132)
11578* BFD_ARELOC_BFIN_LAND:                  howto manager.      (line 1120)
11579* BFD_ARELOC_BFIN_LEN:                   howto manager.      (line 1124)
11580* BFD_ARELOC_BFIN_LOR:                   howto manager.      (line 1122)
11581* BFD_ARELOC_BFIN_LSHIFT:                howto manager.      (line 1110)
11582* BFD_ARELOC_BFIN_MOD:                   howto manager.      (line 1108)
11583* BFD_ARELOC_BFIN_MULT:                  howto manager.      (line 1104)
11584* BFD_ARELOC_BFIN_NEG:                   howto manager.      (line 1126)
11585* BFD_ARELOC_BFIN_OR:                    howto manager.      (line 1116)
11586* BFD_ARELOC_BFIN_PAGE:                  howto manager.      (line 1130)
11587* BFD_ARELOC_BFIN_PUSH:                  howto manager.      (line 1096)
11588* BFD_ARELOC_BFIN_RSHIFT:                howto manager.      (line 1112)
11589* BFD_ARELOC_BFIN_SUB:                   howto manager.      (line 1102)
11590* BFD_ARELOC_BFIN_XOR:                   howto manager.      (line 1118)
11591* bfd_cache_close:                       File Caching.       (line   25)
11592* bfd_cache_close_all:                   File Caching.       (line   38)
11593* bfd_cache_init:                        File Caching.       (line   17)
11594* bfd_calc_gnu_debuglink_crc32:          Opening and Closing.
11595                                                             (line  275)
11596* bfd_canonicalize_reloc:                Miscellaneous.      (line   18)
11597* bfd_canonicalize_symtab:               symbol handling functions.
11598                                                             (line   52)
11599* bfd_check_compression_header:          Miscellaneous.      (line  360)
11600* bfd_check_format:                      Formats.            (line   20)
11601* bfd_check_format_matches:              Formats.            (line   51)
11602* bfd_check_overflow:                    typedef arelent.    (line  352)
11603* bfd_close:                             Opening and Closing.
11604                                                             (line  161)
11605* bfd_close_all_done:                    Opening and Closing.
11606                                                             (line  179)
11607* bfd_coff_backend_data:                 coff.               (line  296)
11608* bfd_convert_section_contents:          Miscellaneous.      (line  396)
11609* bfd_convert_section_size:              Miscellaneous.      (line  386)
11610* bfd_copy_private_bfd_data:             Miscellaneous.      (line  159)
11611* bfd_copy_private_header_data:          Miscellaneous.      (line  142)
11612* bfd_copy_private_section_data:         section prototypes. (line  279)
11613* bfd_copy_private_symbol_data:          symbol handling functions.
11614                                                             (line  145)
11615* bfd_core_file_failing_command:         Core Files.         (line   11)
11616* bfd_core_file_failing_signal:          Core Files.         (line   20)
11617* bfd_core_file_pid:                     Core Files.         (line   29)
11618* bfd_create:                            Opening and Closing.
11619                                                             (line  198)
11620* bfd_create_gnu_debuglink_section:      Opening and Closing.
11621                                                             (line  431)
11622* bfd_decode_symclass:                   symbol handling functions.
11623                                                             (line  116)
11624* bfd_default_arch_struct:               Architectures.      (line  565)
11625* bfd_default_compatible:                Architectures.      (line  627)
11626* bfd_default_reloc_type_lookup:         howto manager.      (line 3311)
11627* bfd_default_scan:                      Architectures.      (line  636)
11628* bfd_default_set_arch_mach:             Architectures.      (line  583)
11629* bfd_demangle:                          Miscellaneous.      (line  339)
11630* bfd_emul_get_commonpagesize:           Miscellaneous.      (line  319)
11631* bfd_emul_get_maxpagesize:              Miscellaneous.      (line  299)
11632* bfd_emul_set_commonpagesize:           Miscellaneous.      (line  330)
11633* bfd_emul_set_maxpagesize:              Miscellaneous.      (line  310)
11634* bfd_errmsg:                            Error reporting.    (line   78)
11635* bfd_fdopenr:                           Opening and Closing.
11636                                                             (line   56)
11637* bfd_fill_in_gnu_debuglink_section:     Opening and Closing.
11638                                                             (line  445)
11639* bfd_find_target:                       bfd_target.         (line  495)
11640* bfd_find_version_for_sym:              Writing the symbol table.
11641                                                             (line  111)
11642* bfd_flavour_name:                      bfd_target.         (line  558)
11643* bfd_follow_build_id_debuglink:         Opening and Closing.
11644                                                             (line  505)
11645* bfd_follow_gnu_debugaltlink:           Opening and Closing.
11646                                                             (line  411)
11647* bfd_follow_gnu_debuglink:              Opening and Closing.
11648                                                             (line  390)
11649* bfd_fopen:                             Opening and Closing.
11650                                                             (line   11)
11651* bfd_format_string:                     Formats.            (line   78)
11652* bfd_generic_define_common_symbol:      Writing the symbol table.
11653                                                             (line   69)
11654* bfd_generic_define_start_stop:         Writing the symbol table.
11655                                                             (line   97)
11656* bfd_generic_discard_group:             section prototypes. (line  304)
11657* bfd_generic_gc_sections:               howto manager.      (line 3342)
11658* bfd_generic_get_relocated_section_contents: howto manager. (line 3372)
11659* bfd_generic_is_group_section:          section prototypes. (line  296)
11660* bfd_generic_lookup_section_flags:      howto manager.      (line 3352)
11661* bfd_generic_merge_sections:            howto manager.      (line 3362)
11662* bfd_generic_relax_section:             howto manager.      (line 3329)
11663* bfd_get_alt_debug_link_info:           Opening and Closing.
11664                                                             (line  329)
11665* bfd_get_arch:                          Architectures.      (line  594)
11666* bfd_get_arch_info:                     Architectures.      (line  646)
11667* bfd_get_arch_size:                     Miscellaneous.      (line   63)
11668* bfd_get_compression_header_size:       Miscellaneous.      (line  375)
11669* bfd_get_debug_link_info:               Opening and Closing.
11670                                                             (line  311)
11671* bfd_get_debug_link_info_1:             Opening and Closing.
11672                                                             (line  289)
11673* bfd_get_error:                         Error reporting.    (line   48)
11674* bfd_get_file_size:                     Miscellaneous.      (line  485)
11675* bfd_get_gp_size:                       Miscellaneous.      (line  106)
11676* bfd_get_linker_section:                section prototypes. (line   37)
11677* bfd_get_mach:                          Architectures.      (line  602)
11678* bfd_get_mtime:                         Miscellaneous.      (line  448)
11679* bfd_get_next_mapent:                   Archives.           (line   57)
11680* bfd_get_next_section_by_name:          section prototypes. (line   25)
11681* bfd_get_reloc_code_name:               howto manager.      (line 3320)
11682* bfd_get_reloc_size:                    typedef arelent.    (line  330)
11683* bfd_get_reloc_upper_bound:             Miscellaneous.      (line    8)
11684* bfd_get_section_by_name:               section prototypes. (line   16)
11685* bfd_get_section_by_name_if:            section prototypes. (line   46)
11686* bfd_get_section_contents:              section prototypes. (line  252)
11687* bfd_get_sign_extend_vma:               Miscellaneous.      (line   78)
11688* bfd_get_size:                          Miscellaneous.      (line  457)
11689* bfd_get_size <1>:                      Internal.           (line   24)
11690* bfd_get_symtab_upper_bound:            symbol handling functions.
11691                                                             (line    5)
11692* bfd_get_target_info:                   bfd_target.         (line  511)
11693* bfd_get_unique_section_name:           section prototypes. (line   65)
11694* bfd_hash_allocate:                     Creating and Freeing a Hash Table.
11695                                                             (line   17)
11696* bfd_hash_lookup:                       Looking Up or Entering a String.
11697                                                             (line    6)
11698* bfd_hash_newfunc:                      Creating and Freeing a Hash Table.
11699                                                             (line   12)
11700* bfd_hash_set_default_size:             Creating and Freeing a Hash Table.
11701                                                             (line   25)
11702* bfd_hash_table_free:                   Creating and Freeing a Hash Table.
11703                                                             (line   21)
11704* bfd_hash_table_init:                   Creating and Freeing a Hash Table.
11705                                                             (line    6)
11706* bfd_hash_table_init_n:                 Creating and Freeing a Hash Table.
11707                                                             (line    6)
11708* bfd_hash_traverse:                     Traversing a Hash Table.
11709                                                             (line    6)
11710* bfd_hide_sym_by_version:               Writing the symbol table.
11711                                                             (line  123)
11712* bfd_h_put_size:                        Internal.           (line   97)
11713* bfd_init:                              Initialization.     (line   10)
11714* bfd_install_relocation:                typedef arelent.    (line  406)
11715* bfd_is_local_label:                    symbol handling functions.
11716                                                             (line   17)
11717* bfd_is_local_label_name:               symbol handling functions.
11718                                                             (line   26)
11719* bfd_is_target_special_symbol:          symbol handling functions.
11720                                                             (line   39)
11721* bfd_is_undefined_symclass:             symbol handling functions.
11722                                                             (line  125)
11723* bfd_iterate_over_targets:              bfd_target.         (line  546)
11724* bfd_link_check_relocs:                 Writing the symbol table.
11725                                                             (line  133)
11726* bfd_link_split_section:                Writing the symbol table.
11727                                                             (line   43)
11728* bfd_log2:                              Internal.           (line  166)
11729* bfd_lookup_arch:                       Architectures.      (line  654)
11730* bfd_make_debug_symbol:                 symbol handling functions.
11731                                                             (line  106)
11732* bfd_make_empty_symbol:                 symbol handling functions.
11733                                                             (line   81)
11734* bfd_make_readable:                     Opening and Closing.
11735                                                             (line  225)
11736* bfd_make_section:                      section prototypes. (line  143)
11737* bfd_make_section_anyway:               section prototypes. (line  115)
11738* bfd_make_section_anyway_with_flags:    section prototypes. (line   97)
11739* bfd_make_section_old_way:              section prototypes. (line   77)
11740* bfd_make_section_with_flags:           section prototypes. (line  131)
11741* bfd_make_writable:                     Opening and Closing.
11742                                                             (line  211)
11743* bfd_malloc_and_get_section:            section prototypes. (line  269)
11744* bfd_map_over_sections:                 section prototypes. (line  178)
11745* bfd_merge_private_bfd_data:            Writing the symbol table.
11746                                                             (line  155)
11747* bfd_mmap:                              Miscellaneous.      (line  494)
11748* bfd_octets_per_byte:                   Architectures.      (line  677)
11749* bfd_openr:                             Opening and Closing.
11750                                                             (line   37)
11751* bfd_openr_iovec:                       Opening and Closing.
11752                                                             (line   95)
11753* bfd_openr_next_archived_file:          Archives.           (line   83)
11754* bfd_openstreamr:                       Opening and Closing.
11755                                                             (line   82)
11756* bfd_openw:                             Opening and Closing.
11757                                                             (line  146)
11758* bfd_open_file:                         File Caching.       (line   51)
11759* bfd_perform_relocation:                typedef arelent.    (line  381)
11760* bfd_perror:                            Error reporting.    (line   87)
11761* bfd_printable_arch_mach:               Architectures.      (line  665)
11762* bfd_printable_name:                    Architectures.      (line  525)
11763* bfd_print_symbol_vandf:                symbol handling functions.
11764                                                             (line   73)
11765* bfd_put_size:                          Internal.           (line   21)
11766* BFD_RELOC_12_PCREL:                    howto manager.      (line   37)
11767* BFD_RELOC_14:                          howto manager.      (line   30)
11768* BFD_RELOC_16:                          howto manager.      (line   29)
11769* BFD_RELOC_16C_ABS20:                   howto manager.      (line 2229)
11770* BFD_RELOC_16C_ABS20_C:                 howto manager.      (line 2230)
11771* BFD_RELOC_16C_ABS24:                   howto manager.      (line 2231)
11772* BFD_RELOC_16C_ABS24_C:                 howto manager.      (line 2232)
11773* BFD_RELOC_16C_DISP04:                  howto manager.      (line 2209)
11774* BFD_RELOC_16C_DISP04_C:                howto manager.      (line 2210)
11775* BFD_RELOC_16C_DISP08:                  howto manager.      (line 2211)
11776* BFD_RELOC_16C_DISP08_C:                howto manager.      (line 2212)
11777* BFD_RELOC_16C_DISP16:                  howto manager.      (line 2213)
11778* BFD_RELOC_16C_DISP16_C:                howto manager.      (line 2214)
11779* BFD_RELOC_16C_DISP24:                  howto manager.      (line 2215)
11780* BFD_RELOC_16C_DISP24a:                 howto manager.      (line 2217)
11781* BFD_RELOC_16C_DISP24a_C:               howto manager.      (line 2218)
11782* BFD_RELOC_16C_DISP24_C:                howto manager.      (line 2216)
11783* BFD_RELOC_16C_IMM04:                   howto manager.      (line 2233)
11784* BFD_RELOC_16C_IMM04_C:                 howto manager.      (line 2234)
11785* BFD_RELOC_16C_IMM16:                   howto manager.      (line 2235)
11786* BFD_RELOC_16C_IMM16_C:                 howto manager.      (line 2236)
11787* BFD_RELOC_16C_IMM20:                   howto manager.      (line 2237)
11788* BFD_RELOC_16C_IMM20_C:                 howto manager.      (line 2238)
11789* BFD_RELOC_16C_IMM24:                   howto manager.      (line 2239)
11790* BFD_RELOC_16C_IMM24_C:                 howto manager.      (line 2240)
11791* BFD_RELOC_16C_IMM32:                   howto manager.      (line 2241)
11792* BFD_RELOC_16C_IMM32_C:                 howto manager.      (line 2242)
11793* BFD_RELOC_16C_NUM08:                   howto manager.      (line 2203)
11794* BFD_RELOC_16C_NUM08_C:                 howto manager.      (line 2204)
11795* BFD_RELOC_16C_NUM16:                   howto manager.      (line 2205)
11796* BFD_RELOC_16C_NUM16_C:                 howto manager.      (line 2206)
11797* BFD_RELOC_16C_NUM32:                   howto manager.      (line 2207)
11798* BFD_RELOC_16C_NUM32_C:                 howto manager.      (line 2208)
11799* BFD_RELOC_16C_REG04:                   howto manager.      (line 2219)
11800* BFD_RELOC_16C_REG04a:                  howto manager.      (line 2221)
11801* BFD_RELOC_16C_REG04a_C:                howto manager.      (line 2222)
11802* BFD_RELOC_16C_REG04_C:                 howto manager.      (line 2220)
11803* BFD_RELOC_16C_REG14:                   howto manager.      (line 2223)
11804* BFD_RELOC_16C_REG14_C:                 howto manager.      (line 2224)
11805* BFD_RELOC_16C_REG16:                   howto manager.      (line 2225)
11806* BFD_RELOC_16C_REG16_C:                 howto manager.      (line 2226)
11807* BFD_RELOC_16C_REG20:                   howto manager.      (line 2227)
11808* BFD_RELOC_16C_REG20_C:                 howto manager.      (line 2228)
11809* BFD_RELOC_16_BASEREL:                  howto manager.      (line   90)
11810* BFD_RELOC_16_GOTOFF:                   howto manager.      (line   49)
11811* BFD_RELOC_16_GOT_PCREL:                howto manager.      (line   46)
11812* BFD_RELOC_16_PCREL:                    howto manager.      (line   36)
11813* BFD_RELOC_16_PCREL_S2:                 howto manager.      (line  100)
11814* BFD_RELOC_16_PLTOFF:                   howto manager.      (line   61)
11815* BFD_RELOC_16_PLT_PCREL:                howto manager.      (line   57)
11816* BFD_RELOC_23_PCREL_S2:                 howto manager.      (line  101)
11817* BFD_RELOC_24:                          howto manager.      (line   28)
11818* BFD_RELOC_24_PCREL:                    howto manager.      (line   35)
11819* BFD_RELOC_24_PLT_PCREL:                howto manager.      (line   56)
11820* BFD_RELOC_26:                          howto manager.      (line   27)
11821* BFD_RELOC_32:                          howto manager.      (line   26)
11822* BFD_RELOC_32_BASEREL:                  howto manager.      (line   89)
11823* BFD_RELOC_32_GOTOFF:                   howto manager.      (line   48)
11824* BFD_RELOC_32_GOT_PCREL:                howto manager.      (line   45)
11825* BFD_RELOC_32_PCREL:                    howto manager.      (line   34)
11826* BFD_RELOC_32_PCREL_S2:                 howto manager.      (line   99)
11827* BFD_RELOC_32_PLTOFF:                   howto manager.      (line   60)
11828* BFD_RELOC_32_PLT_PCREL:                howto manager.      (line   55)
11829* BFD_RELOC_32_SECREL:                   howto manager.      (line   43)
11830* BFD_RELOC_386_COPY:                    howto manager.      (line  523)
11831* BFD_RELOC_386_GLOB_DAT:                howto manager.      (line  524)
11832* BFD_RELOC_386_GOT32:                   howto manager.      (line  521)
11833* BFD_RELOC_386_GOT32X:                  howto manager.      (line  545)
11834* BFD_RELOC_386_GOTOFF:                  howto manager.      (line  527)
11835* BFD_RELOC_386_GOTPC:                   howto manager.      (line  528)
11836* BFD_RELOC_386_IRELATIVE:               howto manager.      (line  544)
11837* BFD_RELOC_386_JUMP_SLOT:               howto manager.      (line  525)
11838* BFD_RELOC_386_PLT32:                   howto manager.      (line  522)
11839* BFD_RELOC_386_RELATIVE:                howto manager.      (line  526)
11840* BFD_RELOC_386_TLS_DESC:                howto manager.      (line  543)
11841* BFD_RELOC_386_TLS_DESC_CALL:           howto manager.      (line  542)
11842* BFD_RELOC_386_TLS_DTPMOD32:            howto manager.      (line  538)
11843* BFD_RELOC_386_TLS_DTPOFF32:            howto manager.      (line  539)
11844* BFD_RELOC_386_TLS_GD:                  howto manager.      (line  533)
11845* BFD_RELOC_386_TLS_GOTDESC:             howto manager.      (line  541)
11846* BFD_RELOC_386_TLS_GOTIE:               howto manager.      (line  531)
11847* BFD_RELOC_386_TLS_IE:                  howto manager.      (line  530)
11848* BFD_RELOC_386_TLS_IE_32:               howto manager.      (line  536)
11849* BFD_RELOC_386_TLS_LDM:                 howto manager.      (line  534)
11850* BFD_RELOC_386_TLS_LDO_32:              howto manager.      (line  535)
11851* BFD_RELOC_386_TLS_LE:                  howto manager.      (line  532)
11852* BFD_RELOC_386_TLS_LE_32:               howto manager.      (line  537)
11853* BFD_RELOC_386_TLS_TPOFF:               howto manager.      (line  529)
11854* BFD_RELOC_386_TLS_TPOFF32:             howto manager.      (line  540)
11855* BFD_RELOC_390_12:                      howto manager.      (line 1889)
11856* BFD_RELOC_390_20:                      howto manager.      (line 1970)
11857* BFD_RELOC_390_COPY:                    howto manager.      (line 1895)
11858* BFD_RELOC_390_GLOB_DAT:                howto manager.      (line 1897)
11859* BFD_RELOC_390_GOT12:                   howto manager.      (line 1891)
11860* BFD_RELOC_390_GOT16:                   howto manager.      (line 1905)
11861* BFD_RELOC_390_GOT20:                   howto manager.      (line 1971)
11862* BFD_RELOC_390_GOT64:                   howto manager.      (line 1925)
11863* BFD_RELOC_390_GOTENT:                  howto manager.      (line 1929)
11864* BFD_RELOC_390_GOTOFF64:                howto manager.      (line 1931)
11865* BFD_RELOC_390_GOTPC:                   howto manager.      (line 1903)
11866* BFD_RELOC_390_GOTPCDBL:                howto manager.      (line 1923)
11867* BFD_RELOC_390_GOTPLT12:                howto manager.      (line 1933)
11868* BFD_RELOC_390_GOTPLT16:                howto manager.      (line 1935)
11869* BFD_RELOC_390_GOTPLT20:                howto manager.      (line 1972)
11870* BFD_RELOC_390_GOTPLT32:                howto manager.      (line 1937)
11871* BFD_RELOC_390_GOTPLT64:                howto manager.      (line 1939)
11872* BFD_RELOC_390_GOTPLTENT:               howto manager.      (line 1941)
11873* BFD_RELOC_390_IRELATIVE:               howto manager.      (line 1975)
11874* BFD_RELOC_390_JMP_SLOT:                howto manager.      (line 1899)
11875* BFD_RELOC_390_PC12DBL:                 howto manager.      (line 1907)
11876* BFD_RELOC_390_PC16DBL:                 howto manager.      (line 1911)
11877* BFD_RELOC_390_PC24DBL:                 howto manager.      (line 1915)
11878* BFD_RELOC_390_PC32DBL:                 howto manager.      (line 1919)
11879* BFD_RELOC_390_PLT12DBL:                howto manager.      (line 1909)
11880* BFD_RELOC_390_PLT16DBL:                howto manager.      (line 1913)
11881* BFD_RELOC_390_PLT24DBL:                howto manager.      (line 1917)
11882* BFD_RELOC_390_PLT32:                   howto manager.      (line 1893)
11883* BFD_RELOC_390_PLT32DBL:                howto manager.      (line 1921)
11884* BFD_RELOC_390_PLT64:                   howto manager.      (line 1927)
11885* BFD_RELOC_390_PLTOFF16:                howto manager.      (line 1943)
11886* BFD_RELOC_390_PLTOFF32:                howto manager.      (line 1945)
11887* BFD_RELOC_390_PLTOFF64:                howto manager.      (line 1947)
11888* BFD_RELOC_390_RELATIVE:                howto manager.      (line 1901)
11889* BFD_RELOC_390_TLS_DTPMOD:              howto manager.      (line 1966)
11890* BFD_RELOC_390_TLS_DTPOFF:              howto manager.      (line 1967)
11891* BFD_RELOC_390_TLS_GD32:                howto manager.      (line 1952)
11892* BFD_RELOC_390_TLS_GD64:                howto manager.      (line 1953)
11893* BFD_RELOC_390_TLS_GDCALL:              howto manager.      (line 1950)
11894* BFD_RELOC_390_TLS_GOTIE12:             howto manager.      (line 1954)
11895* BFD_RELOC_390_TLS_GOTIE20:             howto manager.      (line 1973)
11896* BFD_RELOC_390_TLS_GOTIE32:             howto manager.      (line 1955)
11897* BFD_RELOC_390_TLS_GOTIE64:             howto manager.      (line 1956)
11898* BFD_RELOC_390_TLS_IE32:                howto manager.      (line 1959)
11899* BFD_RELOC_390_TLS_IE64:                howto manager.      (line 1960)
11900* BFD_RELOC_390_TLS_IEENT:               howto manager.      (line 1961)
11901* BFD_RELOC_390_TLS_LDCALL:              howto manager.      (line 1951)
11902* BFD_RELOC_390_TLS_LDM32:               howto manager.      (line 1957)
11903* BFD_RELOC_390_TLS_LDM64:               howto manager.      (line 1958)
11904* BFD_RELOC_390_TLS_LDO32:               howto manager.      (line 1964)
11905* BFD_RELOC_390_TLS_LDO64:               howto manager.      (line 1965)
11906* BFD_RELOC_390_TLS_LE32:                howto manager.      (line 1962)
11907* BFD_RELOC_390_TLS_LE64:                howto manager.      (line 1963)
11908* BFD_RELOC_390_TLS_LOAD:                howto manager.      (line 1949)
11909* BFD_RELOC_390_TLS_TPOFF:               howto manager.      (line 1968)
11910* BFD_RELOC_64:                          howto manager.      (line   25)
11911* BFD_RELOC_64_PCREL:                    howto manager.      (line   33)
11912* BFD_RELOC_64_PLTOFF:                   howto manager.      (line   59)
11913* BFD_RELOC_64_PLT_PCREL:                howto manager.      (line   54)
11914* BFD_RELOC_68K_GLOB_DAT:                howto manager.      (line   70)
11915* BFD_RELOC_68K_JMP_SLOT:                howto manager.      (line   71)
11916* BFD_RELOC_68K_RELATIVE:                howto manager.      (line   72)
11917* BFD_RELOC_68K_TLS_GD16:                howto manager.      (line   74)
11918* BFD_RELOC_68K_TLS_GD32:                howto manager.      (line   73)
11919* BFD_RELOC_68K_TLS_GD8:                 howto manager.      (line   75)
11920* BFD_RELOC_68K_TLS_IE16:                howto manager.      (line   83)
11921* BFD_RELOC_68K_TLS_IE32:                howto manager.      (line   82)
11922* BFD_RELOC_68K_TLS_IE8:                 howto manager.      (line   84)
11923* BFD_RELOC_68K_TLS_LDM16:               howto manager.      (line   77)
11924* BFD_RELOC_68K_TLS_LDM32:               howto manager.      (line   76)
11925* BFD_RELOC_68K_TLS_LDM8:                howto manager.      (line   78)
11926* BFD_RELOC_68K_TLS_LDO16:               howto manager.      (line   80)
11927* BFD_RELOC_68K_TLS_LDO32:               howto manager.      (line   79)
11928* BFD_RELOC_68K_TLS_LDO8:                howto manager.      (line   81)
11929* BFD_RELOC_68K_TLS_LE16:                howto manager.      (line   86)
11930* BFD_RELOC_68K_TLS_LE32:                howto manager.      (line   85)
11931* BFD_RELOC_68K_TLS_LE8:                 howto manager.      (line   87)
11932* BFD_RELOC_8:                           howto manager.      (line   31)
11933* BFD_RELOC_8_BASEREL:                   howto manager.      (line   94)
11934* BFD_RELOC_8_FFnn:                      howto manager.      (line   97)
11935* BFD_RELOC_8_GOTOFF:                    howto manager.      (line   53)
11936* BFD_RELOC_8_GOT_PCREL:                 howto manager.      (line   47)
11937* BFD_RELOC_8_PCREL:                     howto manager.      (line   38)
11938* BFD_RELOC_8_PLTOFF:                    howto manager.      (line   65)
11939* BFD_RELOC_8_PLT_PCREL:                 howto manager.      (line   58)
11940* BFD_RELOC_AARCH64_16:                  howto manager.      (line 2726)
11941* BFD_RELOC_AARCH64_16_PCREL:            howto manager.      (line 2732)
11942* BFD_RELOC_AARCH64_32:                  howto manager.      (line 2725)
11943* BFD_RELOC_AARCH64_32_PCREL:            howto manager.      (line 2731)
11944* BFD_RELOC_AARCH64_64:                  howto manager.      (line 2724)
11945* BFD_RELOC_AARCH64_64_PCREL:            howto manager.      (line 2730)
11946* BFD_RELOC_AARCH64_ADD_LO12:            howto manager.      (line 2805)
11947* BFD_RELOC_AARCH64_ADR_GOT_PAGE:        howto manager.      (line 2851)
11948* BFD_RELOC_AARCH64_ADR_HI21_NC_PCREL:   howto manager.      (line 2801)
11949* BFD_RELOC_AARCH64_ADR_HI21_PCREL:      howto manager.      (line 2798)
11950* BFD_RELOC_AARCH64_ADR_LO21_PCREL:      howto manager.      (line 2795)
11951* BFD_RELOC_AARCH64_BRANCH19:            howto manager.      (line 2817)
11952* BFD_RELOC_AARCH64_CALL26:              howto manager.      (line 2825)
11953* BFD_RELOC_AARCH64_COPY:                howto manager.      (line 3018)
11954* BFD_RELOC_AARCH64_GAS_INTERNAL_FIXUP:  howto manager.      (line 3042)
11955* BFD_RELOC_AARCH64_GLOB_DAT:            howto manager.      (line 3020)
11956* BFD_RELOC_AARCH64_GOT_LD_PREL19:       howto manager.      (line 2845)
11957* BFD_RELOC_AARCH64_IRELATIVE:           howto manager.      (line 3034)
11958* BFD_RELOC_AARCH64_JUMP26:              howto manager.      (line 2821)
11959* BFD_RELOC_AARCH64_JUMP_SLOT:           howto manager.      (line 3022)
11960* BFD_RELOC_AARCH64_LD32_GOTPAGE_LO14:   howto manager.      (line 2872)
11961* BFD_RELOC_AARCH64_LD32_GOT_LO12_NC:    howto manager.      (line 2859)
11962* BFD_RELOC_AARCH64_LD64_GOTOFF_LO15:    howto manager.      (line 2869)
11963* BFD_RELOC_AARCH64_LD64_GOTPAGE_LO15:   howto manager.      (line 2875)
11964* BFD_RELOC_AARCH64_LD64_GOT_LO12_NC:    howto manager.      (line 2855)
11965* BFD_RELOC_AARCH64_LDST128_LO12:        howto manager.      (line 2841)
11966* BFD_RELOC_AARCH64_LDST16_LO12:         howto manager.      (line 2829)
11967* BFD_RELOC_AARCH64_LDST32_LO12:         howto manager.      (line 2833)
11968* BFD_RELOC_AARCH64_LDST64_LO12:         howto manager.      (line 2837)
11969* BFD_RELOC_AARCH64_LDST8_LO12:          howto manager.      (line 2809)
11970* BFD_RELOC_AARCH64_LDST_LO12:           howto manager.      (line 3045)
11971* BFD_RELOC_AARCH64_LD_GOT_LO12_NC:      howto manager.      (line 3063)
11972* BFD_RELOC_AARCH64_LD_LO19_PCREL:       howto manager.      (line 2791)
11973* BFD_RELOC_AARCH64_MOVW_G0:             howto manager.      (line 2735)
11974* BFD_RELOC_AARCH64_MOVW_G0_NC:          howto manager.      (line 2738)
11975* BFD_RELOC_AARCH64_MOVW_G0_S:           howto manager.      (line 2756)
11976* BFD_RELOC_AARCH64_MOVW_G1:             howto manager.      (line 2741)
11977* BFD_RELOC_AARCH64_MOVW_G1_NC:          howto manager.      (line 2744)
11978* BFD_RELOC_AARCH64_MOVW_G1_S:           howto manager.      (line 2760)
11979* BFD_RELOC_AARCH64_MOVW_G2:             howto manager.      (line 2747)
11980* BFD_RELOC_AARCH64_MOVW_G2_NC:          howto manager.      (line 2750)
11981* BFD_RELOC_AARCH64_MOVW_G2_S:           howto manager.      (line 2764)
11982* BFD_RELOC_AARCH64_MOVW_G3:             howto manager.      (line 2753)
11983* BFD_RELOC_AARCH64_MOVW_GOTOFF_G0_NC:   howto manager.      (line 2863)
11984* BFD_RELOC_AARCH64_MOVW_GOTOFF_G1:      howto manager.      (line 2866)
11985* BFD_RELOC_AARCH64_MOVW_PREL_G0:        howto manager.      (line 2768)
11986* BFD_RELOC_AARCH64_MOVW_PREL_G0_NC:     howto manager.      (line 2772)
11987* BFD_RELOC_AARCH64_MOVW_PREL_G1:        howto manager.      (line 2776)
11988* BFD_RELOC_AARCH64_MOVW_PREL_G1_NC:     howto manager.      (line 2779)
11989* BFD_RELOC_AARCH64_MOVW_PREL_G2:        howto manager.      (line 2782)
11990* BFD_RELOC_AARCH64_MOVW_PREL_G2_NC:     howto manager.      (line 2785)
11991* BFD_RELOC_AARCH64_MOVW_PREL_G3:        howto manager.      (line 2788)
11992* BFD_RELOC_AARCH64_NONE:                howto manager.      (line 2722)
11993* BFD_RELOC_AARCH64_NULL:                howto manager.      (line 2720)
11994* BFD_RELOC_AARCH64_RELATIVE:            howto manager.      (line 3024)
11995* BFD_RELOC_AARCH64_RELOC_END:           howto manager.      (line 3036)
11996* BFD_RELOC_AARCH64_RELOC_START:         howto manager.      (line 2715)
11997* BFD_RELOC_AARCH64_TLSDESC:             howto manager.      (line 3032)
11998* BFD_RELOC_AARCH64_TLSDESC_ADD:         howto manager.      (line 3014)
11999* BFD_RELOC_AARCH64_TLSDESC_ADD_LO12:    howto manager.      (line 3006)
12000* BFD_RELOC_AARCH64_TLSDESC_ADR_PAGE21:  howto manager.      (line 3000)
12001* BFD_RELOC_AARCH64_TLSDESC_ADR_PREL21:  howto manager.      (line 2998)
12002* BFD_RELOC_AARCH64_TLSDESC_CALL:        howto manager.      (line 3016)
12003* BFD_RELOC_AARCH64_TLSDESC_LD32_LO12_NC: howto manager.     (line 3004)
12004* BFD_RELOC_AARCH64_TLSDESC_LD64_LO12:   howto manager.      (line 3002)
12005* BFD_RELOC_AARCH64_TLSDESC_LDR:         howto manager.      (line 3012)
12006* BFD_RELOC_AARCH64_TLSDESC_LD_LO12_NC:  howto manager.      (line 3069)
12007* BFD_RELOC_AARCH64_TLSDESC_LD_PREL19:   howto manager.      (line 2996)
12008* BFD_RELOC_AARCH64_TLSDESC_OFF_G0_NC:   howto manager.      (line 3010)
12009* BFD_RELOC_AARCH64_TLSDESC_OFF_G1:      howto manager.      (line 3008)
12010* BFD_RELOC_AARCH64_TLSGD_ADD_LO12_NC:   howto manager.      (line 2885)
12011* BFD_RELOC_AARCH64_TLSGD_ADR_PAGE21:    howto manager.      (line 2878)
12012* BFD_RELOC_AARCH64_TLSGD_ADR_PREL21:    howto manager.      (line 2883)
12013* BFD_RELOC_AARCH64_TLSGD_MOVW_G0_NC:    howto manager.      (line 2889)
12014* BFD_RELOC_AARCH64_TLSGD_MOVW_G1:       howto manager.      (line 2891)
12015* BFD_RELOC_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21: howto manager.
12016                                                             (line 2893)
12017* BFD_RELOC_AARCH64_TLSIE_LD32_GOTTPREL_LO12_NC: howto manager.
12018                                                             (line 2897)
12019* BFD_RELOC_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC: howto manager.
12020                                                             (line 2895)
12021* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_LO12_NC: howto manager.
12022                                                             (line 3066)
12023* BFD_RELOC_AARCH64_TLSIE_LD_GOTTPREL_PREL19: howto manager. (line 2899)
12024* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC: howto manager.
12025                                                             (line 2901)
12026* BFD_RELOC_AARCH64_TLSIE_MOVW_GOTTPREL_G1: howto manager.   (line 2903)
12027* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_HI12: howto manager.    (line 2905)
12028* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12: howto manager.    (line 2907)
12029* BFD_RELOC_AARCH64_TLSLD_ADD_DTPREL_LO12_NC: howto manager. (line 2909)
12030* BFD_RELOC_AARCH64_TLSLD_ADD_LO12_NC:   howto manager.      (line 2912)
12031* BFD_RELOC_AARCH64_TLSLD_ADR_PAGE21:    howto manager.      (line 2916)
12032* BFD_RELOC_AARCH64_TLSLD_ADR_PREL21:    howto manager.      (line 2919)
12033* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12: howto manager. (line 2922)
12034* BFD_RELOC_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC: howto manager.
12035                                                             (line 2925)
12036* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12: howto manager. (line 2928)
12037* BFD_RELOC_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC: howto manager.
12038                                                             (line 2931)
12039* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12: howto manager. (line 2934)
12040* BFD_RELOC_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC: howto manager.
12041                                                             (line 2937)
12042* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12: howto manager.  (line 2940)
12043* BFD_RELOC_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC: howto manager.
12044                                                             (line 2943)
12045* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12: howto manager.   (line 3049)
12046* BFD_RELOC_AARCH64_TLSLD_LDST_DTPREL_LO12_NC: howto manager.
12047                                                             (line 3053)
12048* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0: howto manager.     (line 2946)
12049* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G0_NC: howto manager.  (line 2948)
12050* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1: howto manager.     (line 2950)
12051* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G1_NC: howto manager.  (line 2952)
12052* BFD_RELOC_AARCH64_TLSLD_MOVW_DTPREL_G2: howto manager.     (line 2954)
12053* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_HI12: howto manager.     (line 2966)
12054* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12: howto manager.     (line 2968)
12055* BFD_RELOC_AARCH64_TLSLE_ADD_TPREL_LO12_NC: howto manager.  (line 2970)
12056* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12: howto manager.  (line 2972)
12057* BFD_RELOC_AARCH64_TLSLE_LDST16_TPREL_LO12_NC: howto manager.
12058                                                             (line 2975)
12059* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12: howto manager.  (line 2978)
12060* BFD_RELOC_AARCH64_TLSLE_LDST32_TPREL_LO12_NC: howto manager.
12061                                                             (line 2981)
12062* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12: howto manager.  (line 2984)
12063* BFD_RELOC_AARCH64_TLSLE_LDST64_TPREL_LO12_NC: howto manager.
12064                                                             (line 2987)
12065* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12: howto manager.   (line 2990)
12066* BFD_RELOC_AARCH64_TLSLE_LDST8_TPREL_LO12_NC: howto manager.
12067                                                             (line 2993)
12068* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12: howto manager.    (line 3056)
12069* BFD_RELOC_AARCH64_TLSLE_LDST_TPREL_LO12_NC: howto manager. (line 3060)
12070* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0: howto manager.      (line 2962)
12071* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G0_NC: howto manager.   (line 2964)
12072* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1: howto manager.      (line 2958)
12073* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G1_NC: howto manager.   (line 2960)
12074* BFD_RELOC_AARCH64_TLSLE_MOVW_TPREL_G2: howto manager.      (line 2956)
12075* BFD_RELOC_AARCH64_TLS_DTPMOD:          howto manager.      (line 3026)
12076* BFD_RELOC_AARCH64_TLS_DTPREL:          howto manager.      (line 3028)
12077* BFD_RELOC_AARCH64_TLS_TPREL:           howto manager.      (line 3030)
12078* BFD_RELOC_AARCH64_TSTBR14:             howto manager.      (line 2813)
12079* BFD_RELOC_AC_SECTOFF_S9:               howto manager.      (line 1018)
12080* BFD_RELOC_AC_SECTOFF_S9_1:             howto manager.      (line 1019)
12081* BFD_RELOC_AC_SECTOFF_S9_2:             howto manager.      (line 1020)
12082* BFD_RELOC_AC_SECTOFF_U8:               howto manager.      (line 1015)
12083* BFD_RELOC_AC_SECTOFF_U8_1:             howto manager.      (line 1016)
12084* BFD_RELOC_AC_SECTOFF_U8_2:             howto manager.      (line 1017)
12085* BFD_RELOC_ALPHA_BOH:                   howto manager.      (line  288)
12086* BFD_RELOC_ALPHA_BRSGP:                 howto manager.      (line  275)
12087* BFD_RELOC_ALPHA_BSR:                   howto manager.      (line  282)
12088* BFD_RELOC_ALPHA_CODEADDR:              howto manager.      (line  268)
12089* BFD_RELOC_ALPHA_DTPMOD64:              howto manager.      (line  293)
12090* BFD_RELOC_ALPHA_DTPREL16:              howto manager.      (line  298)
12091* BFD_RELOC_ALPHA_DTPREL64:              howto manager.      (line  295)
12092* BFD_RELOC_ALPHA_DTPREL_HI16:           howto manager.      (line  296)
12093* BFD_RELOC_ALPHA_DTPREL_LO16:           howto manager.      (line  297)
12094* BFD_RELOC_ALPHA_ELF_LITERAL:           howto manager.      (line  236)
12095* BFD_RELOC_ALPHA_GOTDTPREL16:           howto manager.      (line  294)
12096* BFD_RELOC_ALPHA_GOTTPREL16:            howto manager.      (line  299)
12097* BFD_RELOC_ALPHA_GPDISP:                howto manager.      (line  231)
12098* BFD_RELOC_ALPHA_GPDISP_HI16:           howto manager.      (line  219)
12099* BFD_RELOC_ALPHA_GPDISP_LO16:           howto manager.      (line  226)
12100* BFD_RELOC_ALPHA_GPREL_HI16:            howto manager.      (line  271)
12101* BFD_RELOC_ALPHA_GPREL_LO16:            howto manager.      (line  272)
12102* BFD_RELOC_ALPHA_HINT:                  howto manager.      (line  261)
12103* BFD_RELOC_ALPHA_LDA:                   howto manager.      (line  285)
12104* BFD_RELOC_ALPHA_LINKAGE:               howto manager.      (line  265)
12105* BFD_RELOC_ALPHA_LITERAL:               howto manager.      (line  235)
12106* BFD_RELOC_ALPHA_LITUSE:                howto manager.      (line  237)
12107* BFD_RELOC_ALPHA_NOP:                   howto manager.      (line  279)
12108* BFD_RELOC_ALPHA_TLSGD:                 howto manager.      (line  291)
12109* BFD_RELOC_ALPHA_TLSLDM:                howto manager.      (line  292)
12110* BFD_RELOC_ALPHA_TPREL16:               howto manager.      (line  303)
12111* BFD_RELOC_ALPHA_TPREL64:               howto manager.      (line  300)
12112* BFD_RELOC_ALPHA_TPREL_HI16:            howto manager.      (line  301)
12113* BFD_RELOC_ALPHA_TPREL_LO16:            howto manager.      (line  302)
12114* BFD_RELOC_ARC_16:                      howto manager.      (line  987)
12115* BFD_RELOC_ARC_24:                      howto manager.      (line  988)
12116* BFD_RELOC_ARC_32:                      howto manager.      (line  989)
12117* BFD_RELOC_ARC_32_ME:                   howto manager.      (line 1009)
12118* BFD_RELOC_ARC_32_ME_S:                 howto manager.      (line 1010)
12119* BFD_RELOC_ARC_32_PCREL:                howto manager.      (line 1027)
12120* BFD_RELOC_ARC_8:                       howto manager.      (line  986)
12121* BFD_RELOC_ARC_COPY:                    howto manager.      (line 1032)
12122* BFD_RELOC_ARC_GLOB_DAT:                howto manager.      (line 1033)
12123* BFD_RELOC_ARC_GOT32:                   howto manager.      (line 1029)
12124* BFD_RELOC_ARC_GOTOFF:                  howto manager.      (line 1036)
12125* BFD_RELOC_ARC_GOTPC:                   howto manager.      (line 1037)
12126* BFD_RELOC_ARC_GOTPC32:                 howto manager.      (line 1030)
12127* BFD_RELOC_ARC_JLI_SECTOFF:             howto manager.      (line 1053)
12128* BFD_RELOC_ARC_JMP_SLOT:                howto manager.      (line 1034)
12129* BFD_RELOC_ARC_N16:                     howto manager.      (line  991)
12130* BFD_RELOC_ARC_N24:                     howto manager.      (line  992)
12131* BFD_RELOC_ARC_N32:                     howto manager.      (line  993)
12132* BFD_RELOC_ARC_N32_ME:                  howto manager.      (line 1011)
12133* BFD_RELOC_ARC_N8:                      howto manager.      (line  990)
12134* BFD_RELOC_ARC_NONE:                    howto manager.      (line  985)
12135* BFD_RELOC_ARC_NPS_CMEM16:              howto manager.      (line 1052)
12136* BFD_RELOC_ARC_PC32:                    howto manager.      (line 1028)
12137* BFD_RELOC_ARC_PLT32:                   howto manager.      (line 1031)
12138* BFD_RELOC_ARC_RELATIVE:                howto manager.      (line 1035)
12139* BFD_RELOC_ARC_S13_PCREL:               howto manager.      (line 1007)
12140* BFD_RELOC_ARC_S21H_PCREL:              howto manager.      (line  996)
12141* BFD_RELOC_ARC_S21H_PCREL_PLT:          howto manager.      (line 1051)
12142* BFD_RELOC_ARC_S21W_PCREL:              howto manager.      (line  997)
12143* BFD_RELOC_ARC_S21W_PCREL_PLT:          howto manager.      (line 1038)
12144* BFD_RELOC_ARC_S25H_PCREL:              howto manager.      (line  998)
12145* BFD_RELOC_ARC_S25H_PCREL_PLT:          howto manager.      (line 1039)
12146* BFD_RELOC_ARC_S25W_PCREL:              howto manager.      (line  999)
12147* BFD_RELOC_ARC_S25W_PCREL_PLT:          howto manager.      (line 1050)
12148* BFD_RELOC_ARC_SDA:                     howto manager.      (line  994)
12149* BFD_RELOC_ARC_SDA16_LD:                howto manager.      (line 1004)
12150* BFD_RELOC_ARC_SDA16_LD1:               howto manager.      (line 1005)
12151* BFD_RELOC_ARC_SDA16_LD2:               howto manager.      (line 1006)
12152* BFD_RELOC_ARC_SDA16_ST2:               howto manager.      (line 1026)
12153* BFD_RELOC_ARC_SDA32:                   howto manager.      (line 1000)
12154* BFD_RELOC_ARC_SDA32_ME:                howto manager.      (line 1013)
12155* BFD_RELOC_ARC_SDA_12:                  howto manager.      (line 1025)
12156* BFD_RELOC_ARC_SDA_LDST:                howto manager.      (line 1001)
12157* BFD_RELOC_ARC_SDA_LDST1:               howto manager.      (line 1002)
12158* BFD_RELOC_ARC_SDA_LDST2:               howto manager.      (line 1003)
12159* BFD_RELOC_ARC_SECTOFF:                 howto manager.      (line  995)
12160* BFD_RELOC_ARC_SECTOFF_1:               howto manager.      (line 1023)
12161* BFD_RELOC_ARC_SECTOFF_2:               howto manager.      (line 1024)
12162* BFD_RELOC_ARC_SECTOFF_ME:              howto manager.      (line 1012)
12163* BFD_RELOC_ARC_SECTOFF_ME_1:            howto manager.      (line 1021)
12164* BFD_RELOC_ARC_SECTOFF_ME_2:            howto manager.      (line 1022)
12165* BFD_RELOC_ARC_TLS_DTPMOD:              howto manager.      (line 1040)
12166* BFD_RELOC_ARC_TLS_DTPOFF:              howto manager.      (line 1046)
12167* BFD_RELOC_ARC_TLS_DTPOFF_S9:           howto manager.      (line 1047)
12168* BFD_RELOC_ARC_TLS_GD_CALL:             howto manager.      (line 1044)
12169* BFD_RELOC_ARC_TLS_GD_GOT:              howto manager.      (line 1042)
12170* BFD_RELOC_ARC_TLS_GD_LD:               howto manager.      (line 1043)
12171* BFD_RELOC_ARC_TLS_IE_GOT:              howto manager.      (line 1045)
12172* BFD_RELOC_ARC_TLS_LE_32:               howto manager.      (line 1049)
12173* BFD_RELOC_ARC_TLS_LE_S9:               howto manager.      (line 1048)
12174* BFD_RELOC_ARC_TLS_TPOFF:               howto manager.      (line 1041)
12175* BFD_RELOC_ARC_W:                       howto manager.      (line 1008)
12176* BFD_RELOC_ARC_W_ME:                    howto manager.      (line 1014)
12177* BFD_RELOC_ARM_ADRL_IMMEDIATE:          howto manager.      (line  859)
12178* BFD_RELOC_ARM_ADR_IMM:                 howto manager.      (line  873)
12179* BFD_RELOC_ARM_ALU_PC_G0:               howto manager.      (line  821)
12180* BFD_RELOC_ARM_ALU_PC_G0_NC:            howto manager.      (line  820)
12181* BFD_RELOC_ARM_ALU_PC_G1:               howto manager.      (line  823)
12182* BFD_RELOC_ARM_ALU_PC_G1_NC:            howto manager.      (line  822)
12183* BFD_RELOC_ARM_ALU_PC_G2:               howto manager.      (line  824)
12184* BFD_RELOC_ARM_ALU_SB_G0:               howto manager.      (line  835)
12185* BFD_RELOC_ARM_ALU_SB_G0_NC:            howto manager.      (line  834)
12186* BFD_RELOC_ARM_ALU_SB_G1:               howto manager.      (line  837)
12187* BFD_RELOC_ARM_ALU_SB_G1_NC:            howto manager.      (line  836)
12188* BFD_RELOC_ARM_ALU_SB_G2:               howto manager.      (line  838)
12189* BFD_RELOC_ARM_CP_OFF_IMM:              howto manager.      (line  869)
12190* BFD_RELOC_ARM_CP_OFF_IMM_S2:           howto manager.      (line  870)
12191* BFD_RELOC_ARM_FUNCDESC:                howto manager.      (line  790)
12192* BFD_RELOC_ARM_FUNCDESC_VALUE:          howto manager.      (line  791)
12193* BFD_RELOC_ARM_GLOB_DAT:                howto manager.      (line  797)
12194* BFD_RELOC_ARM_GOT32:                   howto manager.      (line  798)
12195* BFD_RELOC_ARM_GOTFUNCDESC:             howto manager.      (line  788)
12196* BFD_RELOC_ARM_GOTOFF:                  howto manager.      (line  801)
12197* BFD_RELOC_ARM_GOTOFFFUNCDESC:          howto manager.      (line  789)
12198* BFD_RELOC_ARM_GOTPC:                   howto manager.      (line  802)
12199* BFD_RELOC_ARM_GOT_PREL:                howto manager.      (line  803)
12200* BFD_RELOC_ARM_HVC:                     howto manager.      (line  866)
12201* BFD_RELOC_ARM_HWLITERAL:               howto manager.      (line  880)
12202* BFD_RELOC_ARM_IMMEDIATE:               howto manager.      (line  858)
12203* BFD_RELOC_ARM_IN_POOL:                 howto manager.      (line  876)
12204* BFD_RELOC_ARM_IRELATIVE:               howto manager.      (line  851)
12205* BFD_RELOC_ARM_JUMP_SLOT:               howto manager.      (line  796)
12206* BFD_RELOC_ARM_LDC_PC_G0:               howto manager.      (line  831)
12207* BFD_RELOC_ARM_LDC_PC_G1:               howto manager.      (line  832)
12208* BFD_RELOC_ARM_LDC_PC_G2:               howto manager.      (line  833)
12209* BFD_RELOC_ARM_LDC_SB_G0:               howto manager.      (line  845)
12210* BFD_RELOC_ARM_LDC_SB_G1:               howto manager.      (line  846)
12211* BFD_RELOC_ARM_LDC_SB_G2:               howto manager.      (line  847)
12212* BFD_RELOC_ARM_LDRS_PC_G0:              howto manager.      (line  828)
12213* BFD_RELOC_ARM_LDRS_PC_G1:              howto manager.      (line  829)
12214* BFD_RELOC_ARM_LDRS_PC_G2:              howto manager.      (line  830)
12215* BFD_RELOC_ARM_LDRS_SB_G0:              howto manager.      (line  842)
12216* BFD_RELOC_ARM_LDRS_SB_G1:              howto manager.      (line  843)
12217* BFD_RELOC_ARM_LDRS_SB_G2:              howto manager.      (line  844)
12218* BFD_RELOC_ARM_LDR_IMM:                 howto manager.      (line  874)
12219* BFD_RELOC_ARM_LDR_PC_G0:               howto manager.      (line  825)
12220* BFD_RELOC_ARM_LDR_PC_G1:               howto manager.      (line  826)
12221* BFD_RELOC_ARM_LDR_PC_G2:               howto manager.      (line  827)
12222* BFD_RELOC_ARM_LDR_SB_G0:               howto manager.      (line  839)
12223* BFD_RELOC_ARM_LDR_SB_G1:               howto manager.      (line  840)
12224* BFD_RELOC_ARM_LDR_SB_G2:               howto manager.      (line  841)
12225* BFD_RELOC_ARM_LITERAL:                 howto manager.      (line  875)
12226* BFD_RELOC_ARM_MOVT:                    howto manager.      (line  780)
12227* BFD_RELOC_ARM_MOVT_PCREL:              howto manager.      (line  782)
12228* BFD_RELOC_ARM_MOVW:                    howto manager.      (line  779)
12229* BFD_RELOC_ARM_MOVW_PCREL:              howto manager.      (line  781)
12230* BFD_RELOC_ARM_MULTI:                   howto manager.      (line  868)
12231* BFD_RELOC_ARM_OFFSET_IMM:              howto manager.      (line  760)
12232* BFD_RELOC_ARM_OFFSET_IMM8:             howto manager.      (line  877)
12233* BFD_RELOC_ARM_PCREL_BLX:               howto manager.      (line  736)
12234* BFD_RELOC_ARM_PCREL_BRANCH:            howto manager.      (line  733)
12235* BFD_RELOC_ARM_PCREL_CALL:              howto manager.      (line  744)
12236* BFD_RELOC_ARM_PCREL_JUMP:              howto manager.      (line  747)
12237* BFD_RELOC_ARM_PLT32:                   howto manager.      (line  799)
12238* BFD_RELOC_ARM_PREL31:                  howto manager.      (line  777)
12239* BFD_RELOC_ARM_RELATIVE:                howto manager.      (line  800)
12240* BFD_RELOC_ARM_ROSEGREL32:              howto manager.      (line  769)
12241* BFD_RELOC_ARM_SBREL32:                 howto manager.      (line  771)
12242* BFD_RELOC_ARM_SHIFT_IMM:               howto manager.      (line  864)
12243* BFD_RELOC_ARM_SMC:                     howto manager.      (line  865)
12244* BFD_RELOC_ARM_SWI:                     howto manager.      (line  867)
12245* BFD_RELOC_ARM_T32_ADD_IMM:             howto manager.      (line  861)
12246* BFD_RELOC_ARM_T32_ADD_PC12:            howto manager.      (line  863)
12247* BFD_RELOC_ARM_T32_CP_OFF_IMM:          howto manager.      (line  871)
12248* BFD_RELOC_ARM_T32_CP_OFF_IMM_S2:       howto manager.      (line  872)
12249* BFD_RELOC_ARM_T32_IMM12:               howto manager.      (line  862)
12250* BFD_RELOC_ARM_T32_IMMEDIATE:           howto manager.      (line  860)
12251* BFD_RELOC_ARM_T32_OFFSET_IMM:          howto manager.      (line  879)
12252* BFD_RELOC_ARM_T32_OFFSET_U8:           howto manager.      (line  878)
12253* BFD_RELOC_ARM_TARGET1:                 howto manager.      (line  766)
12254* BFD_RELOC_ARM_TARGET2:                 howto manager.      (line  773)
12255* BFD_RELOC_ARM_THM_TLS_CALL:            howto manager.      (line  815)
12256* BFD_RELOC_ARM_THM_TLS_DESCSEQ:         howto manager.      (line  817)
12257* BFD_RELOC_ARM_THUMB_ADD:               howto manager.      (line  881)
12258* BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC:     howto manager.      (line  853)
12259* BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC:     howto manager.      (line  854)
12260* BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC:     howto manager.      (line  855)
12261* BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC:     howto manager.      (line  856)
12262* BFD_RELOC_ARM_THUMB_IMM:               howto manager.      (line  882)
12263* BFD_RELOC_ARM_THUMB_MOVT:              howto manager.      (line  784)
12264* BFD_RELOC_ARM_THUMB_MOVT_PCREL:        howto manager.      (line  786)
12265* BFD_RELOC_ARM_THUMB_MOVW:              howto manager.      (line  783)
12266* BFD_RELOC_ARM_THUMB_MOVW_PCREL:        howto manager.      (line  785)
12267* BFD_RELOC_ARM_THUMB_OFFSET:            howto manager.      (line  763)
12268* BFD_RELOC_ARM_THUMB_SHIFT:             howto manager.      (line  883)
12269* BFD_RELOC_ARM_TLS_CALL:                howto manager.      (line  814)
12270* BFD_RELOC_ARM_TLS_DESC:                howto manager.      (line  818)
12271* BFD_RELOC_ARM_TLS_DESCSEQ:             howto manager.      (line  816)
12272* BFD_RELOC_ARM_TLS_DTPMOD32:            howto manager.      (line  809)
12273* BFD_RELOC_ARM_TLS_DTPOFF32:            howto manager.      (line  808)
12274* BFD_RELOC_ARM_TLS_GD32:                howto manager.      (line  805)
12275* BFD_RELOC_ARM_TLS_GD32_FDPIC:          howto manager.      (line  792)
12276* BFD_RELOC_ARM_TLS_GOTDESC:             howto manager.      (line  813)
12277* BFD_RELOC_ARM_TLS_IE32:                howto manager.      (line  811)
12278* BFD_RELOC_ARM_TLS_IE32_FDPIC:          howto manager.      (line  794)
12279* BFD_RELOC_ARM_TLS_LDM32:               howto manager.      (line  807)
12280* BFD_RELOC_ARM_TLS_LDM32_FDPIC:         howto manager.      (line  793)
12281* BFD_RELOC_ARM_TLS_LDO32:               howto manager.      (line  806)
12282* BFD_RELOC_ARM_TLS_LE32:                howto manager.      (line  812)
12283* BFD_RELOC_ARM_TLS_TPOFF32:             howto manager.      (line  810)
12284* BFD_RELOC_ARM_V4BX:                    howto manager.      (line  849)
12285* BFD_RELOC_AVR_13_PCREL:                howto manager.      (line 1673)
12286* BFD_RELOC_AVR_16_PM:                   howto manager.      (line 1676)
12287* BFD_RELOC_AVR_6:                       howto manager.      (line 1744)
12288* BFD_RELOC_AVR_6_ADIW:                  howto manager.      (line 1747)
12289* BFD_RELOC_AVR_7_PCREL:                 howto manager.      (line 1670)
12290* BFD_RELOC_AVR_8_HI:                    howto manager.      (line 1753)
12291* BFD_RELOC_AVR_8_HLO:                   howto manager.      (line 1756)
12292* BFD_RELOC_AVR_8_LO:                    howto manager.      (line 1750)
12293* BFD_RELOC_AVR_CALL:                    howto manager.      (line 1738)
12294* BFD_RELOC_AVR_DIFF16:                  howto manager.      (line 1760)
12295* BFD_RELOC_AVR_DIFF32:                  howto manager.      (line 1761)
12296* BFD_RELOC_AVR_DIFF8:                   howto manager.      (line 1759)
12297* BFD_RELOC_AVR_HH8_LDI:                 howto manager.      (line 1685)
12298* BFD_RELOC_AVR_HH8_LDI_NEG:             howto manager.      (line 1700)
12299* BFD_RELOC_AVR_HH8_LDI_PM:              howto manager.      (line 1723)
12300* BFD_RELOC_AVR_HH8_LDI_PM_NEG:          howto manager.      (line 1734)
12301* BFD_RELOC_AVR_HI8_LDI:                 howto manager.      (line 1682)
12302* BFD_RELOC_AVR_HI8_LDI_GS:              howto manager.      (line 1718)
12303* BFD_RELOC_AVR_HI8_LDI_NEG:             howto manager.      (line 1696)
12304* BFD_RELOC_AVR_HI8_LDI_PM:              howto manager.      (line 1715)
12305* BFD_RELOC_AVR_HI8_LDI_PM_NEG:          howto manager.      (line 1730)
12306* BFD_RELOC_AVR_LDI:                     howto manager.      (line 1741)
12307* BFD_RELOC_AVR_LDS_STS_16:              howto manager.      (line 1768)
12308* BFD_RELOC_AVR_LO8_LDI:                 howto manager.      (line 1679)
12309* BFD_RELOC_AVR_LO8_LDI_GS:              howto manager.      (line 1710)
12310* BFD_RELOC_AVR_LO8_LDI_NEG:             howto manager.      (line 1692)
12311* BFD_RELOC_AVR_LO8_LDI_PM:              howto manager.      (line 1707)
12312* BFD_RELOC_AVR_LO8_LDI_PM_NEG:          howto manager.      (line 1727)
12313* BFD_RELOC_AVR_MS8_LDI:                 howto manager.      (line 1689)
12314* BFD_RELOC_AVR_MS8_LDI_NEG:             howto manager.      (line 1704)
12315* BFD_RELOC_AVR_PORT5:                   howto manager.      (line 1774)
12316* BFD_RELOC_AVR_PORT6:                   howto manager.      (line 1771)
12317* BFD_RELOC_BFIN_10_PCREL:               howto manager.      (line 1065)
12318* BFD_RELOC_BFIN_11_PCREL:               howto manager.      (line 1067)
12319* BFD_RELOC_BFIN_12_PCREL_JUMP:          howto manager.      (line 1069)
12320* BFD_RELOC_BFIN_12_PCREL_JUMP_S:        howto manager.      (line 1071)
12321* BFD_RELOC_BFIN_16_HIGH:                howto manager.      (line 1057)
12322* BFD_RELOC_BFIN_16_IMM:                 howto manager.      (line 1055)
12323* BFD_RELOC_BFIN_16_LOW:                 howto manager.      (line 1063)
12324* BFD_RELOC_BFIN_24_PCREL_CALL_X:        howto manager.      (line 1073)
12325* BFD_RELOC_BFIN_24_PCREL_JUMP_L:        howto manager.      (line 1075)
12326* BFD_RELOC_BFIN_4_PCREL:                howto manager.      (line 1059)
12327* BFD_RELOC_BFIN_5_PCREL:                howto manager.      (line 1061)
12328* BFD_RELOC_BFIN_FUNCDESC:               howto manager.      (line 1080)
12329* BFD_RELOC_BFIN_FUNCDESC_GOT17M4:       howto manager.      (line 1081)
12330* BFD_RELOC_BFIN_FUNCDESC_GOTHI:         howto manager.      (line 1082)
12331* BFD_RELOC_BFIN_FUNCDESC_GOTLO:         howto manager.      (line 1083)
12332* BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4:    howto manager.      (line 1085)
12333* BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI:      howto manager.      (line 1086)
12334* BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO:      howto manager.      (line 1087)
12335* BFD_RELOC_BFIN_FUNCDESC_VALUE:         howto manager.      (line 1084)
12336* BFD_RELOC_BFIN_GOT:                    howto manager.      (line 1092)
12337* BFD_RELOC_BFIN_GOT17M4:                howto manager.      (line 1077)
12338* BFD_RELOC_BFIN_GOTHI:                  howto manager.      (line 1078)
12339* BFD_RELOC_BFIN_GOTLO:                  howto manager.      (line 1079)
12340* BFD_RELOC_BFIN_GOTOFF17M4:             howto manager.      (line 1088)
12341* BFD_RELOC_BFIN_GOTOFFHI:               howto manager.      (line 1089)
12342* BFD_RELOC_BFIN_GOTOFFLO:               howto manager.      (line 1090)
12343* BFD_RELOC_BFIN_PLTPC:                  howto manager.      (line 1094)
12344* BFD_RELOC_C6000_ABS_H16:               howto manager.      (line 1515)
12345* BFD_RELOC_C6000_ABS_L16:               howto manager.      (line 1514)
12346* BFD_RELOC_C6000_ABS_S16:               howto manager.      (line 1513)
12347* BFD_RELOC_C6000_ALIGN:                 howto manager.      (line 1536)
12348* BFD_RELOC_C6000_COPY:                  howto manager.      (line 1531)
12349* BFD_RELOC_C6000_DSBT_INDEX:            howto manager.      (line 1529)
12350* BFD_RELOC_C6000_EHTYPE:                howto manager.      (line 1533)
12351* BFD_RELOC_C6000_FPHEAD:                howto manager.      (line 1537)
12352* BFD_RELOC_C6000_JUMP_SLOT:             howto manager.      (line 1532)
12353* BFD_RELOC_C6000_NOCMP:                 howto manager.      (line 1538)
12354* BFD_RELOC_C6000_PCR_H16:               howto manager.      (line 1534)
12355* BFD_RELOC_C6000_PCR_L16:               howto manager.      (line 1535)
12356* BFD_RELOC_C6000_PCR_S10:               howto manager.      (line 1511)
12357* BFD_RELOC_C6000_PCR_S12:               howto manager.      (line 1510)
12358* BFD_RELOC_C6000_PCR_S21:               howto manager.      (line 1509)
12359* BFD_RELOC_C6000_PCR_S7:                howto manager.      (line 1512)
12360* BFD_RELOC_C6000_PREL31:                howto manager.      (line 1530)
12361* BFD_RELOC_C6000_SBR_GOT_H16_W:         howto manager.      (line 1528)
12362* BFD_RELOC_C6000_SBR_GOT_L16_W:         howto manager.      (line 1527)
12363* BFD_RELOC_C6000_SBR_GOT_U15_W:         howto manager.      (line 1526)
12364* BFD_RELOC_C6000_SBR_H16_B:             howto manager.      (line 1523)
12365* BFD_RELOC_C6000_SBR_H16_H:             howto manager.      (line 1524)
12366* BFD_RELOC_C6000_SBR_H16_W:             howto manager.      (line 1525)
12367* BFD_RELOC_C6000_SBR_L16_B:             howto manager.      (line 1520)
12368* BFD_RELOC_C6000_SBR_L16_H:             howto manager.      (line 1521)
12369* BFD_RELOC_C6000_SBR_L16_W:             howto manager.      (line 1522)
12370* BFD_RELOC_C6000_SBR_S16:               howto manager.      (line 1519)
12371* BFD_RELOC_C6000_SBR_U15_B:             howto manager.      (line 1516)
12372* BFD_RELOC_C6000_SBR_U15_H:             howto manager.      (line 1517)
12373* BFD_RELOC_C6000_SBR_U15_W:             howto manager.      (line 1518)
12374* bfd_reloc_code_type:                   howto manager.      (line    9)
12375* BFD_RELOC_CR16_ABS20:                  howto manager.      (line 2256)
12376* BFD_RELOC_CR16_ABS24:                  howto manager.      (line 2257)
12377* BFD_RELOC_CR16_DISP16:                 howto manager.      (line 2267)
12378* BFD_RELOC_CR16_DISP20:                 howto manager.      (line 2268)
12379* BFD_RELOC_CR16_DISP24:                 howto manager.      (line 2269)
12380* BFD_RELOC_CR16_DISP24a:                howto manager.      (line 2270)
12381* BFD_RELOC_CR16_DISP4:                  howto manager.      (line 2265)
12382* BFD_RELOC_CR16_DISP8:                  howto manager.      (line 2266)
12383* BFD_RELOC_CR16_GLOB_DAT:               howto manager.      (line 2276)
12384* BFD_RELOC_CR16_GOTC_REGREL20:          howto manager.      (line 2275)
12385* BFD_RELOC_CR16_GOT_REGREL20:           howto manager.      (line 2274)
12386* BFD_RELOC_CR16_IMM16:                  howto manager.      (line 2260)
12387* BFD_RELOC_CR16_IMM20:                  howto manager.      (line 2261)
12388* BFD_RELOC_CR16_IMM24:                  howto manager.      (line 2262)
12389* BFD_RELOC_CR16_IMM32:                  howto manager.      (line 2263)
12390* BFD_RELOC_CR16_IMM32a:                 howto manager.      (line 2264)
12391* BFD_RELOC_CR16_IMM4:                   howto manager.      (line 2258)
12392* BFD_RELOC_CR16_IMM8:                   howto manager.      (line 2259)
12393* BFD_RELOC_CR16_NUM16:                  howto manager.      (line 2245)
12394* BFD_RELOC_CR16_NUM32:                  howto manager.      (line 2246)
12395* BFD_RELOC_CR16_NUM32a:                 howto manager.      (line 2247)
12396* BFD_RELOC_CR16_NUM8:                   howto manager.      (line 2244)
12397* BFD_RELOC_CR16_REGREL0:                howto manager.      (line 2248)
12398* BFD_RELOC_CR16_REGREL14:               howto manager.      (line 2251)
12399* BFD_RELOC_CR16_REGREL14a:              howto manager.      (line 2252)
12400* BFD_RELOC_CR16_REGREL16:               howto manager.      (line 2253)
12401* BFD_RELOC_CR16_REGREL20:               howto manager.      (line 2254)
12402* BFD_RELOC_CR16_REGREL20a:              howto manager.      (line 2255)
12403* BFD_RELOC_CR16_REGREL4:                howto manager.      (line 2249)
12404* BFD_RELOC_CR16_REGREL4a:               howto manager.      (line 2250)
12405* BFD_RELOC_CR16_SWITCH16:               howto manager.      (line 2272)
12406* BFD_RELOC_CR16_SWITCH32:               howto manager.      (line 2273)
12407* BFD_RELOC_CR16_SWITCH8:                howto manager.      (line 2271)
12408* BFD_RELOC_CRIS_16_DTPREL:              howto manager.      (line 2336)
12409* BFD_RELOC_CRIS_16_GOT:                 howto manager.      (line 2318)
12410* BFD_RELOC_CRIS_16_GOTPLT:              howto manager.      (line 2322)
12411* BFD_RELOC_CRIS_16_GOT_GD:              howto manager.      (line 2332)
12412* BFD_RELOC_CRIS_16_GOT_TPREL:           howto manager.      (line 2338)
12413* BFD_RELOC_CRIS_16_TPREL:               howto manager.      (line 2340)
12414* BFD_RELOC_CRIS_32_DTPREL:              howto manager.      (line 2335)
12415* BFD_RELOC_CRIS_32_GD:                  howto manager.      (line 2333)
12416* BFD_RELOC_CRIS_32_GOT:                 howto manager.      (line 2316)
12417* BFD_RELOC_CRIS_32_GOTPLT:              howto manager.      (line 2320)
12418* BFD_RELOC_CRIS_32_GOTREL:              howto manager.      (line 2324)
12419* BFD_RELOC_CRIS_32_GOT_GD:              howto manager.      (line 2331)
12420* BFD_RELOC_CRIS_32_GOT_TPREL:           howto manager.      (line 2337)
12421* BFD_RELOC_CRIS_32_IE:                  howto manager.      (line 2342)
12422* BFD_RELOC_CRIS_32_PLT_GOTREL:          howto manager.      (line 2326)
12423* BFD_RELOC_CRIS_32_PLT_PCREL:           howto manager.      (line 2328)
12424* BFD_RELOC_CRIS_32_TPREL:               howto manager.      (line 2339)
12425* BFD_RELOC_CRIS_BDISP8:                 howto manager.      (line 2299)
12426* BFD_RELOC_CRIS_COPY:                   howto manager.      (line 2311)
12427* BFD_RELOC_CRIS_DTP:                    howto manager.      (line 2334)
12428* BFD_RELOC_CRIS_DTPMOD:                 howto manager.      (line 2341)
12429* BFD_RELOC_CRIS_GLOB_DAT:               howto manager.      (line 2312)
12430* BFD_RELOC_CRIS_JUMP_SLOT:              howto manager.      (line 2313)
12431* BFD_RELOC_CRIS_LAPCQ_OFFSET:           howto manager.      (line 2307)
12432* BFD_RELOC_CRIS_RELATIVE:               howto manager.      (line 2314)
12433* BFD_RELOC_CRIS_SIGNED_16:              howto manager.      (line 2305)
12434* BFD_RELOC_CRIS_SIGNED_6:               howto manager.      (line 2301)
12435* BFD_RELOC_CRIS_SIGNED_8:               howto manager.      (line 2303)
12436* BFD_RELOC_CRIS_UNSIGNED_16:            howto manager.      (line 2306)
12437* BFD_RELOC_CRIS_UNSIGNED_4:             howto manager.      (line 2308)
12438* BFD_RELOC_CRIS_UNSIGNED_5:             howto manager.      (line 2300)
12439* BFD_RELOC_CRIS_UNSIGNED_6:             howto manager.      (line 2302)
12440* BFD_RELOC_CRIS_UNSIGNED_8:             howto manager.      (line 2304)
12441* BFD_RELOC_CRX_ABS16:                   howto manager.      (line 2288)
12442* BFD_RELOC_CRX_ABS32:                   howto manager.      (line 2289)
12443* BFD_RELOC_CRX_IMM16:                   howto manager.      (line 2293)
12444* BFD_RELOC_CRX_IMM32:                   howto manager.      (line 2294)
12445* BFD_RELOC_CRX_NUM16:                   howto manager.      (line 2291)
12446* BFD_RELOC_CRX_NUM32:                   howto manager.      (line 2292)
12447* BFD_RELOC_CRX_NUM8:                    howto manager.      (line 2290)
12448* BFD_RELOC_CRX_REGREL12:                howto manager.      (line 2284)
12449* BFD_RELOC_CRX_REGREL22:                howto manager.      (line 2285)
12450* BFD_RELOC_CRX_REGREL28:                howto manager.      (line 2286)
12451* BFD_RELOC_CRX_REGREL32:                howto manager.      (line 2287)
12452* BFD_RELOC_CRX_REL16:                   howto manager.      (line 2281)
12453* BFD_RELOC_CRX_REL24:                   howto manager.      (line 2282)
12454* BFD_RELOC_CRX_REL32:                   howto manager.      (line 2283)
12455* BFD_RELOC_CRX_REL4:                    howto manager.      (line 2278)
12456* BFD_RELOC_CRX_REL8:                    howto manager.      (line 2279)
12457* BFD_RELOC_CRX_REL8_CMP:                howto manager.      (line 2280)
12458* BFD_RELOC_CRX_SWITCH16:                howto manager.      (line 2296)
12459* BFD_RELOC_CRX_SWITCH32:                howto manager.      (line 2297)
12460* BFD_RELOC_CRX_SWITCH8:                 howto manager.      (line 2295)
12461* BFD_RELOC_CTOR:                        howto manager.      (line  728)
12462* BFD_RELOC_D10V_10_PCREL_L:             howto manager.      (line 1139)
12463* BFD_RELOC_D10V_10_PCREL_R:             howto manager.      (line 1136)
12464* BFD_RELOC_D10V_18:                     howto manager.      (line 1143)
12465* BFD_RELOC_D10V_18_PCREL:               howto manager.      (line 1145)
12466* BFD_RELOC_D30V_15:                     howto manager.      (line 1156)
12467* BFD_RELOC_D30V_15_PCREL:               howto manager.      (line 1159)
12468* BFD_RELOC_D30V_15_PCREL_R:             howto manager.      (line 1162)
12469* BFD_RELOC_D30V_21:                     howto manager.      (line 1166)
12470* BFD_RELOC_D30V_21_PCREL:               howto manager.      (line 1169)
12471* BFD_RELOC_D30V_21_PCREL_R:             howto manager.      (line 1172)
12472* BFD_RELOC_D30V_32:                     howto manager.      (line 1176)
12473* BFD_RELOC_D30V_32_PCREL:               howto manager.      (line 1178)
12474* BFD_RELOC_D30V_6:                      howto manager.      (line 1147)
12475* BFD_RELOC_D30V_9_PCREL:                howto manager.      (line 1149)
12476* BFD_RELOC_D30V_9_PCREL_R:              howto manager.      (line 1152)
12477* BFD_RELOC_DLX_HI16_S:                  howto manager.      (line 1180)
12478* BFD_RELOC_DLX_JMP26:                   howto manager.      (line 1184)
12479* BFD_RELOC_DLX_LO16:                    howto manager.      (line 1182)
12480* BFD_RELOC_EPIPHANY_HIGH:               howto manager.      (line 3266)
12481* BFD_RELOC_EPIPHANY_IMM11:              howto manager.      (line 3272)
12482* BFD_RELOC_EPIPHANY_IMM8:               howto manager.      (line 3275)
12483* BFD_RELOC_EPIPHANY_LOW:                howto manager.      (line 3268)
12484* BFD_RELOC_EPIPHANY_SIMM11:             howto manager.      (line 3270)
12485* BFD_RELOC_EPIPHANY_SIMM24:             howto manager.      (line 3264)
12486* BFD_RELOC_EPIPHANY_SIMM8:              howto manager.      (line 3262)
12487* BFD_RELOC_FR30_10_IN_8:                howto manager.      (line 1554)
12488* BFD_RELOC_FR30_12_PCREL:               howto manager.      (line 1560)
12489* BFD_RELOC_FR30_20:                     howto manager.      (line 1542)
12490* BFD_RELOC_FR30_48:                     howto manager.      (line 1540)
12491* BFD_RELOC_FR30_6_IN_4:                 howto manager.      (line 1545)
12492* BFD_RELOC_FR30_8_IN_8:                 howto manager.      (line 1548)
12493* BFD_RELOC_FR30_9_IN_8:                 howto manager.      (line 1551)
12494* BFD_RELOC_FR30_9_PCREL:                howto manager.      (line 1557)
12495* BFD_RELOC_FRV_FUNCDESC:                howto manager.      (line  451)
12496* BFD_RELOC_FRV_FUNCDESC_GOT12:          howto manager.      (line  452)
12497* BFD_RELOC_FRV_FUNCDESC_GOTHI:          howto manager.      (line  453)
12498* BFD_RELOC_FRV_FUNCDESC_GOTLO:          howto manager.      (line  454)
12499* BFD_RELOC_FRV_FUNCDESC_GOTOFF12:       howto manager.      (line  456)
12500* BFD_RELOC_FRV_FUNCDESC_GOTOFFHI:       howto manager.      (line  457)
12501* BFD_RELOC_FRV_FUNCDESC_GOTOFFLO:       howto manager.      (line  458)
12502* BFD_RELOC_FRV_FUNCDESC_VALUE:          howto manager.      (line  455)
12503* BFD_RELOC_FRV_GETTLSOFF:               howto manager.      (line  462)
12504* BFD_RELOC_FRV_GETTLSOFF_RELAX:         howto manager.      (line  475)
12505* BFD_RELOC_FRV_GOT12:                   howto manager.      (line  448)
12506* BFD_RELOC_FRV_GOTHI:                   howto manager.      (line  449)
12507* BFD_RELOC_FRV_GOTLO:                   howto manager.      (line  450)
12508* BFD_RELOC_FRV_GOTOFF12:                howto manager.      (line  459)
12509* BFD_RELOC_FRV_GOTOFFHI:                howto manager.      (line  460)
12510* BFD_RELOC_FRV_GOTOFFLO:                howto manager.      (line  461)
12511* BFD_RELOC_FRV_GOTTLSDESC12:            howto manager.      (line  464)
12512* BFD_RELOC_FRV_GOTTLSDESCHI:            howto manager.      (line  465)
12513* BFD_RELOC_FRV_GOTTLSDESCLO:            howto manager.      (line  466)
12514* BFD_RELOC_FRV_GOTTLSOFF12:             howto manager.      (line  470)
12515* BFD_RELOC_FRV_GOTTLSOFFHI:             howto manager.      (line  471)
12516* BFD_RELOC_FRV_GOTTLSOFFLO:             howto manager.      (line  472)
12517* BFD_RELOC_FRV_GPREL12:                 howto manager.      (line  443)
12518* BFD_RELOC_FRV_GPREL32:                 howto manager.      (line  445)
12519* BFD_RELOC_FRV_GPRELHI:                 howto manager.      (line  446)
12520* BFD_RELOC_FRV_GPRELLO:                 howto manager.      (line  447)
12521* BFD_RELOC_FRV_GPRELU12:                howto manager.      (line  444)
12522* BFD_RELOC_FRV_HI16:                    howto manager.      (line  442)
12523* BFD_RELOC_FRV_LABEL16:                 howto manager.      (line  439)
12524* BFD_RELOC_FRV_LABEL24:                 howto manager.      (line  440)
12525* BFD_RELOC_FRV_LO16:                    howto manager.      (line  441)
12526* BFD_RELOC_FRV_TLSDESC_RELAX:           howto manager.      (line  474)
12527* BFD_RELOC_FRV_TLSDESC_VALUE:           howto manager.      (line  463)
12528* BFD_RELOC_FRV_TLSMOFF:                 howto manager.      (line  477)
12529* BFD_RELOC_FRV_TLSMOFF12:               howto manager.      (line  467)
12530* BFD_RELOC_FRV_TLSMOFFHI:               howto manager.      (line  468)
12531* BFD_RELOC_FRV_TLSMOFFLO:               howto manager.      (line  469)
12532* BFD_RELOC_FRV_TLSOFF:                  howto manager.      (line  473)
12533* BFD_RELOC_FRV_TLSOFF_RELAX:            howto manager.      (line  476)
12534* BFD_RELOC_FT32_10:                     howto manager.      (line  429)
12535* BFD_RELOC_FT32_15:                     howto manager.      (line  436)
12536* BFD_RELOC_FT32_17:                     howto manager.      (line  431)
12537* BFD_RELOC_FT32_18:                     howto manager.      (line  432)
12538* BFD_RELOC_FT32_20:                     howto manager.      (line  430)
12539* BFD_RELOC_FT32_DIFF32:                 howto manager.      (line  437)
12540* BFD_RELOC_FT32_RELAX:                  howto manager.      (line  433)
12541* BFD_RELOC_FT32_SC0:                    howto manager.      (line  434)
12542* BFD_RELOC_FT32_SC1:                    howto manager.      (line  435)
12543* BFD_RELOC_GPREL16:                     howto manager.      (line  112)
12544* BFD_RELOC_GPREL32:                     howto manager.      (line  113)
12545* BFD_RELOC_H8_DIR16A8:                  howto manager.      (line 2369)
12546* BFD_RELOC_H8_DIR16R8:                  howto manager.      (line 2370)
12547* BFD_RELOC_H8_DIR24A8:                  howto manager.      (line 2371)
12548* BFD_RELOC_H8_DIR24R8:                  howto manager.      (line 2372)
12549* BFD_RELOC_H8_DIR32A16:                 howto manager.      (line 2373)
12550* BFD_RELOC_H8_DISP32A16:                howto manager.      (line 2374)
12551* BFD_RELOC_HI16:                        howto manager.      (line  312)
12552* BFD_RELOC_HI16_BASEREL:                howto manager.      (line   92)
12553* BFD_RELOC_HI16_GOTOFF:                 howto manager.      (line   51)
12554* BFD_RELOC_HI16_PCREL:                  howto manager.      (line  321)
12555* BFD_RELOC_HI16_PLTOFF:                 howto manager.      (line   63)
12556* BFD_RELOC_HI16_S:                      howto manager.      (line  314)
12557* BFD_RELOC_HI16_S_BASEREL:              howto manager.      (line   93)
12558* BFD_RELOC_HI16_S_GOTOFF:               howto manager.      (line   52)
12559* BFD_RELOC_HI16_S_PCREL:                howto manager.      (line  323)
12560* BFD_RELOC_HI16_S_PLTOFF:               howto manager.      (line   64)
12561* BFD_RELOC_HI22:                        howto manager.      (line  108)
12562* BFD_RELOC_I370_D12:                    howto manager.      (line  726)
12563* BFD_RELOC_IA64_COPY:                   howto manager.      (line 2101)
12564* BFD_RELOC_IA64_DIR32LSB:               howto manager.      (line 2046)
12565* BFD_RELOC_IA64_DIR32MSB:               howto manager.      (line 2045)
12566* BFD_RELOC_IA64_DIR64LSB:               howto manager.      (line 2048)
12567* BFD_RELOC_IA64_DIR64MSB:               howto manager.      (line 2047)
12568* BFD_RELOC_IA64_DTPMOD64LSB:            howto manager.      (line 2111)
12569* BFD_RELOC_IA64_DTPMOD64MSB:            howto manager.      (line 2110)
12570* BFD_RELOC_IA64_DTPREL14:               howto manager.      (line 2113)
12571* BFD_RELOC_IA64_DTPREL22:               howto manager.      (line 2114)
12572* BFD_RELOC_IA64_DTPREL32LSB:            howto manager.      (line 2117)
12573* BFD_RELOC_IA64_DTPREL32MSB:            howto manager.      (line 2116)
12574* BFD_RELOC_IA64_DTPREL64I:              howto manager.      (line 2115)
12575* BFD_RELOC_IA64_DTPREL64LSB:            howto manager.      (line 2119)
12576* BFD_RELOC_IA64_DTPREL64MSB:            howto manager.      (line 2118)
12577* BFD_RELOC_IA64_FPTR32LSB:              howto manager.      (line 2063)
12578* BFD_RELOC_IA64_FPTR32MSB:              howto manager.      (line 2062)
12579* BFD_RELOC_IA64_FPTR64I:                howto manager.      (line 2061)
12580* BFD_RELOC_IA64_FPTR64LSB:              howto manager.      (line 2065)
12581* BFD_RELOC_IA64_FPTR64MSB:              howto manager.      (line 2064)
12582* BFD_RELOC_IA64_GPREL22:                howto manager.      (line 2049)
12583* BFD_RELOC_IA64_GPREL32LSB:             howto manager.      (line 2052)
12584* BFD_RELOC_IA64_GPREL32MSB:             howto manager.      (line 2051)
12585* BFD_RELOC_IA64_GPREL64I:               howto manager.      (line 2050)
12586* BFD_RELOC_IA64_GPREL64LSB:             howto manager.      (line 2054)
12587* BFD_RELOC_IA64_GPREL64MSB:             howto manager.      (line 2053)
12588* BFD_RELOC_IA64_IMM14:                  howto manager.      (line 2042)
12589* BFD_RELOC_IA64_IMM22:                  howto manager.      (line 2043)
12590* BFD_RELOC_IA64_IMM64:                  howto manager.      (line 2044)
12591* BFD_RELOC_IA64_IPLTLSB:                howto manager.      (line 2100)
12592* BFD_RELOC_IA64_IPLTMSB:                howto manager.      (line 2099)
12593* BFD_RELOC_IA64_LDXMOV:                 howto manager.      (line 2103)
12594* BFD_RELOC_IA64_LTOFF22:                howto manager.      (line 2055)
12595* BFD_RELOC_IA64_LTOFF22X:               howto manager.      (line 2102)
12596* BFD_RELOC_IA64_LTOFF64I:               howto manager.      (line 2056)
12597* BFD_RELOC_IA64_LTOFF_DTPMOD22:         howto manager.      (line 2112)
12598* BFD_RELOC_IA64_LTOFF_DTPREL22:         howto manager.      (line 2120)
12599* BFD_RELOC_IA64_LTOFF_FPTR22:           howto manager.      (line 2077)
12600* BFD_RELOC_IA64_LTOFF_FPTR32LSB:        howto manager.      (line 2080)
12601* BFD_RELOC_IA64_LTOFF_FPTR32MSB:        howto manager.      (line 2079)
12602* BFD_RELOC_IA64_LTOFF_FPTR64I:          howto manager.      (line 2078)
12603* BFD_RELOC_IA64_LTOFF_FPTR64LSB:        howto manager.      (line 2082)
12604* BFD_RELOC_IA64_LTOFF_FPTR64MSB:        howto manager.      (line 2081)
12605* BFD_RELOC_IA64_LTOFF_TPREL22:          howto manager.      (line 2109)
12606* BFD_RELOC_IA64_LTV32LSB:               howto manager.      (line 2096)
12607* BFD_RELOC_IA64_LTV32MSB:               howto manager.      (line 2095)
12608* BFD_RELOC_IA64_LTV64LSB:               howto manager.      (line 2098)
12609* BFD_RELOC_IA64_LTV64MSB:               howto manager.      (line 2097)
12610* BFD_RELOC_IA64_PCREL21B:               howto manager.      (line 2066)
12611* BFD_RELOC_IA64_PCREL21BI:              howto manager.      (line 2067)
12612* BFD_RELOC_IA64_PCREL21F:               howto manager.      (line 2069)
12613* BFD_RELOC_IA64_PCREL21M:               howto manager.      (line 2068)
12614* BFD_RELOC_IA64_PCREL22:                howto manager.      (line 2070)
12615* BFD_RELOC_IA64_PCREL32LSB:             howto manager.      (line 2074)
12616* BFD_RELOC_IA64_PCREL32MSB:             howto manager.      (line 2073)
12617* BFD_RELOC_IA64_PCREL60B:               howto manager.      (line 2071)
12618* BFD_RELOC_IA64_PCREL64I:               howto manager.      (line 2072)
12619* BFD_RELOC_IA64_PCREL64LSB:             howto manager.      (line 2076)
12620* BFD_RELOC_IA64_PCREL64MSB:             howto manager.      (line 2075)
12621* BFD_RELOC_IA64_PLTOFF22:               howto manager.      (line 2057)
12622* BFD_RELOC_IA64_PLTOFF64I:              howto manager.      (line 2058)
12623* BFD_RELOC_IA64_PLTOFF64LSB:            howto manager.      (line 2060)
12624* BFD_RELOC_IA64_PLTOFF64MSB:            howto manager.      (line 2059)
12625* BFD_RELOC_IA64_REL32LSB:               howto manager.      (line 2092)
12626* BFD_RELOC_IA64_REL32MSB:               howto manager.      (line 2091)
12627* BFD_RELOC_IA64_REL64LSB:               howto manager.      (line 2094)
12628* BFD_RELOC_IA64_REL64MSB:               howto manager.      (line 2093)
12629* BFD_RELOC_IA64_SECREL32LSB:            howto manager.      (line 2088)
12630* BFD_RELOC_IA64_SECREL32MSB:            howto manager.      (line 2087)
12631* BFD_RELOC_IA64_SECREL64LSB:            howto manager.      (line 2090)
12632* BFD_RELOC_IA64_SECREL64MSB:            howto manager.      (line 2089)
12633* BFD_RELOC_IA64_SEGREL32LSB:            howto manager.      (line 2084)
12634* BFD_RELOC_IA64_SEGREL32MSB:            howto manager.      (line 2083)
12635* BFD_RELOC_IA64_SEGREL64LSB:            howto manager.      (line 2086)
12636* BFD_RELOC_IA64_SEGREL64MSB:            howto manager.      (line 2085)
12637* BFD_RELOC_IA64_TPREL14:                howto manager.      (line 2104)
12638* BFD_RELOC_IA64_TPREL22:                howto manager.      (line 2105)
12639* BFD_RELOC_IA64_TPREL64I:               howto manager.      (line 2106)
12640* BFD_RELOC_IA64_TPREL64LSB:             howto manager.      (line 2108)
12641* BFD_RELOC_IA64_TPREL64MSB:             howto manager.      (line 2107)
12642* BFD_RELOC_IP2K_ADDR16CJP:              howto manager.      (line 2003)
12643* BFD_RELOC_IP2K_BANK:                   howto manager.      (line 2001)
12644* BFD_RELOC_IP2K_EX8DATA:                howto manager.      (line 2009)
12645* BFD_RELOC_IP2K_FR9:                    howto manager.      (line 1999)
12646* BFD_RELOC_IP2K_FR_OFFSET:              howto manager.      (line 2018)
12647* BFD_RELOC_IP2K_HI8DATA:                howto manager.      (line 2008)
12648* BFD_RELOC_IP2K_HI8INSN:                howto manager.      (line 2012)
12649* BFD_RELOC_IP2K_LO8DATA:                howto manager.      (line 2007)
12650* BFD_RELOC_IP2K_LO8INSN:                howto manager.      (line 2011)
12651* BFD_RELOC_IP2K_PAGE3:                  howto manager.      (line 2005)
12652* BFD_RELOC_IP2K_PC_SKIP:                howto manager.      (line 2014)
12653* BFD_RELOC_IP2K_TEXT:                   howto manager.      (line 2016)
12654* BFD_RELOC_IQ2000_OFFSET_16:            howto manager.      (line 2508)
12655* BFD_RELOC_IQ2000_OFFSET_21:            howto manager.      (line 2509)
12656* BFD_RELOC_IQ2000_UHI16:                howto manager.      (line 2510)
12657* BFD_RELOC_LM32_16_GOT:                 howto manager.      (line 2600)
12658* BFD_RELOC_LM32_BRANCH:                 howto manager.      (line 2599)
12659* BFD_RELOC_LM32_CALL:                   howto manager.      (line 2598)
12660* BFD_RELOC_LM32_COPY:                   howto manager.      (line 2603)
12661* BFD_RELOC_LM32_GLOB_DAT:               howto manager.      (line 2604)
12662* BFD_RELOC_LM32_GOTOFF_HI16:            howto manager.      (line 2601)
12663* BFD_RELOC_LM32_GOTOFF_LO16:            howto manager.      (line 2602)
12664* BFD_RELOC_LM32_JMP_SLOT:               howto manager.      (line 2605)
12665* BFD_RELOC_LM32_RELATIVE:               howto manager.      (line 2606)
12666* BFD_RELOC_LO10:                        howto manager.      (line  109)
12667* BFD_RELOC_LO16:                        howto manager.      (line  319)
12668* BFD_RELOC_LO16_BASEREL:                howto manager.      (line   91)
12669* BFD_RELOC_LO16_GOTOFF:                 howto manager.      (line   50)
12670* BFD_RELOC_LO16_PCREL:                  howto manager.      (line  325)
12671* BFD_RELOC_LO16_PLTOFF:                 howto manager.      (line   62)
12672* BFD_RELOC_M32C_HI8:                    howto manager.      (line 1186)
12673* BFD_RELOC_M32C_RL_1ADDR:               howto manager.      (line 1188)
12674* BFD_RELOC_M32C_RL_2ADDR:               howto manager.      (line 1189)
12675* BFD_RELOC_M32C_RL_JUMP:                howto manager.      (line 1187)
12676* BFD_RELOC_M32R_10_PCREL:               howto manager.      (line 1194)
12677* BFD_RELOC_M32R_18_PCREL:               howto manager.      (line 1197)
12678* BFD_RELOC_M32R_24:                     howto manager.      (line 1191)
12679* BFD_RELOC_M32R_26_PCREL:               howto manager.      (line 1199)
12680* BFD_RELOC_M32R_26_PLTREL:              howto manager.      (line 1213)
12681* BFD_RELOC_M32R_COPY:                   howto manager.      (line 1214)
12682* BFD_RELOC_M32R_GLOB_DAT:               howto manager.      (line 1215)
12683* BFD_RELOC_M32R_GOT16_HI_SLO:           howto manager.      (line 1224)
12684* BFD_RELOC_M32R_GOT16_HI_ULO:           howto manager.      (line 1223)
12685* BFD_RELOC_M32R_GOT16_LO:               howto manager.      (line 1225)
12686* BFD_RELOC_M32R_GOT24:                  howto manager.      (line 1212)
12687* BFD_RELOC_M32R_GOTOFF:                 howto manager.      (line 1218)
12688* BFD_RELOC_M32R_GOTOFF_HI_SLO:          howto manager.      (line 1220)
12689* BFD_RELOC_M32R_GOTOFF_HI_ULO:          howto manager.      (line 1219)
12690* BFD_RELOC_M32R_GOTOFF_LO:              howto manager.      (line 1221)
12691* BFD_RELOC_M32R_GOTPC24:                howto manager.      (line 1222)
12692* BFD_RELOC_M32R_GOTPC_HI_SLO:           howto manager.      (line 1227)
12693* BFD_RELOC_M32R_GOTPC_HI_ULO:           howto manager.      (line 1226)
12694* BFD_RELOC_M32R_GOTPC_LO:               howto manager.      (line 1228)
12695* BFD_RELOC_M32R_HI16_SLO:               howto manager.      (line 1204)
12696* BFD_RELOC_M32R_HI16_ULO:               howto manager.      (line 1201)
12697* BFD_RELOC_M32R_JMP_SLOT:               howto manager.      (line 1216)
12698* BFD_RELOC_M32R_LO16:                   howto manager.      (line 1207)
12699* BFD_RELOC_M32R_RELATIVE:               howto manager.      (line 1217)
12700* BFD_RELOC_M32R_SDA16:                  howto manager.      (line 1209)
12701* BFD_RELOC_M68HC11_24:                  howto manager.      (line 2148)
12702* BFD_RELOC_M68HC11_3B:                  howto manager.      (line 2128)
12703* BFD_RELOC_M68HC11_HI8:                 howto manager.      (line 2122)
12704* BFD_RELOC_M68HC11_LO16:                howto manager.      (line 2139)
12705* BFD_RELOC_M68HC11_LO8:                 howto manager.      (line 2125)
12706* BFD_RELOC_M68HC11_PAGE:                howto manager.      (line 2144)
12707* BFD_RELOC_M68HC11_RL_GROUP:            howto manager.      (line 2135)
12708* BFD_RELOC_M68HC11_RL_JUMP:             howto manager.      (line 2130)
12709* BFD_RELOC_M68HC12_10_PCREL:            howto manager.      (line 2191)
12710* BFD_RELOC_M68HC12_16B:                 howto manager.      (line 2187)
12711* BFD_RELOC_M68HC12_5B:                  howto manager.      (line 2153)
12712* BFD_RELOC_M68HC12_9B:                  howto manager.      (line 2185)
12713* BFD_RELOC_M68HC12_9_PCREL:             howto manager.      (line 2189)
12714* BFD_RELOC_M68HC12_HI8XG:               howto manager.      (line 2196)
12715* BFD_RELOC_M68HC12_LO8XG:               howto manager.      (line 2193)
12716* BFD_RELOC_MACH_O_ARM64_ADDEND:         howto manager.      (line 2636)
12717* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGE21: howto manager.     (line 2638)
12718* BFD_RELOC_MACH_O_ARM64_GOT_LOAD_PAGEOFF12: howto manager.  (line 2640)
12719* BFD_RELOC_MACH_O_ARM64_POINTER_TO_GOT: howto manager.      (line 2642)
12720* BFD_RELOC_MACH_O_LOCAL_SECTDIFF:       howto manager.      (line 2611)
12721* BFD_RELOC_MACH_O_PAIR:                 howto manager.      (line 2613)
12722* BFD_RELOC_MACH_O_SECTDIFF:             howto manager.      (line 2608)
12723* BFD_RELOC_MACH_O_SUBTRACTOR32:         howto manager.      (line 2615)
12724* BFD_RELOC_MACH_O_SUBTRACTOR64:         howto manager.      (line 2617)
12725* BFD_RELOC_MACH_O_X86_64_BRANCH32:      howto manager.      (line 2619)
12726* BFD_RELOC_MACH_O_X86_64_BRANCH8:       howto manager.      (line 2620)
12727* BFD_RELOC_MACH_O_X86_64_GOT:           howto manager.      (line 2623)
12728* BFD_RELOC_MACH_O_X86_64_GOT_LOAD:      howto manager.      (line 2625)
12729* BFD_RELOC_MACH_O_X86_64_PCREL32_1:     howto manager.      (line 2628)
12730* BFD_RELOC_MACH_O_X86_64_PCREL32_2:     howto manager.      (line 2630)
12731* BFD_RELOC_MACH_O_X86_64_PCREL32_4:     howto manager.      (line 2632)
12732* BFD_RELOC_MACH_O_X86_64_TLV:           howto manager.      (line 2634)
12733* BFD_RELOC_MCORE_PCREL_32:              howto manager.      (line 1566)
12734* BFD_RELOC_MCORE_PCREL_IMM11BY2:        howto manager.      (line 1564)
12735* BFD_RELOC_MCORE_PCREL_IMM4BY2:         howto manager.      (line 1565)
12736* BFD_RELOC_MCORE_PCREL_IMM8BY4:         howto manager.      (line 1563)
12737* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2:    howto manager.      (line 1567)
12738* BFD_RELOC_MCORE_RVA:                   howto manager.      (line 1568)
12739* BFD_RELOC_MEP_16:                      howto manager.      (line 1571)
12740* BFD_RELOC_MEP_32:                      howto manager.      (line 1572)
12741* BFD_RELOC_MEP_8:                       howto manager.      (line 1570)
12742* BFD_RELOC_MEP_ADDR24A4:                howto manager.      (line 1587)
12743* BFD_RELOC_MEP_GNU_VTENTRY:             howto manager.      (line 1589)
12744* BFD_RELOC_MEP_GNU_VTINHERIT:           howto manager.      (line 1588)
12745* BFD_RELOC_MEP_GPREL:                   howto manager.      (line 1581)
12746* BFD_RELOC_MEP_HI16S:                   howto manager.      (line 1580)
12747* BFD_RELOC_MEP_HI16U:                   howto manager.      (line 1579)
12748* BFD_RELOC_MEP_LOW16:                   howto manager.      (line 1578)
12749* BFD_RELOC_MEP_PCABS24A2:               howto manager.      (line 1577)
12750* BFD_RELOC_MEP_PCREL12A2:               howto manager.      (line 1574)
12751* BFD_RELOC_MEP_PCREL17A2:               howto manager.      (line 1575)
12752* BFD_RELOC_MEP_PCREL24A2:               howto manager.      (line 1576)
12753* BFD_RELOC_MEP_PCREL8A2:                howto manager.      (line 1573)
12754* BFD_RELOC_MEP_TPREL:                   howto manager.      (line 1582)
12755* BFD_RELOC_MEP_TPREL7:                  howto manager.      (line 1583)
12756* BFD_RELOC_MEP_TPREL7A2:                howto manager.      (line 1584)
12757* BFD_RELOC_MEP_TPREL7A4:                howto manager.      (line 1585)
12758* BFD_RELOC_MEP_UIMM24:                  howto manager.      (line 1586)
12759* BFD_RELOC_METAG_COPY:                  howto manager.      (line 1610)
12760* BFD_RELOC_METAG_GETSETOFF:             howto manager.      (line 1594)
12761* BFD_RELOC_METAG_GETSET_GOT:            howto manager.      (line 1602)
12762* BFD_RELOC_METAG_GETSET_GOTOFF:         howto manager.      (line 1601)
12763* BFD_RELOC_METAG_GLOB_DAT:              howto manager.      (line 1613)
12764* BFD_RELOC_METAG_GOTOFF:                howto manager.      (line 1608)
12765* BFD_RELOC_METAG_HI16_GOTOFF:           howto manager.      (line 1599)
12766* BFD_RELOC_METAG_HI16_GOTPC:            howto manager.      (line 1603)
12767* BFD_RELOC_METAG_HI16_PLT:              howto manager.      (line 1605)
12768* BFD_RELOC_METAG_HIADDR16:              howto manager.      (line 1591)
12769* BFD_RELOC_METAG_HIOG:                  howto manager.      (line 1595)
12770* BFD_RELOC_METAG_JMP_SLOT:              howto manager.      (line 1611)
12771* BFD_RELOC_METAG_LO16_GOTOFF:           howto manager.      (line 1600)
12772* BFD_RELOC_METAG_LO16_GOTPC:            howto manager.      (line 1604)
12773* BFD_RELOC_METAG_LO16_PLT:              howto manager.      (line 1606)
12774* BFD_RELOC_METAG_LOADDR16:              howto manager.      (line 1592)
12775* BFD_RELOC_METAG_LOOG:                  howto manager.      (line 1596)
12776* BFD_RELOC_METAG_PLT:                   howto manager.      (line 1609)
12777* BFD_RELOC_METAG_REL16:                 howto manager.      (line 1598)
12778* BFD_RELOC_METAG_REL8:                  howto manager.      (line 1597)
12779* BFD_RELOC_METAG_RELATIVE:              howto manager.      (line 1612)
12780* BFD_RELOC_METAG_RELBRANCH:             howto manager.      (line 1593)
12781* BFD_RELOC_METAG_RELBRANCH_PLT:         howto manager.      (line 1607)
12782* BFD_RELOC_METAG_TLS_DTPMOD:            howto manager.      (line 1624)
12783* BFD_RELOC_METAG_TLS_DTPOFF:            howto manager.      (line 1625)
12784* BFD_RELOC_METAG_TLS_GD:                howto manager.      (line 1614)
12785* BFD_RELOC_METAG_TLS_IE:                howto manager.      (line 1619)
12786* BFD_RELOC_METAG_TLS_IENONPIC:          howto manager.      (line 1620)
12787* BFD_RELOC_METAG_TLS_IENONPIC_HI16:     howto manager.      (line 1621)
12788* BFD_RELOC_METAG_TLS_IENONPIC_LO16:     howto manager.      (line 1622)
12789* BFD_RELOC_METAG_TLS_LDM:               howto manager.      (line 1615)
12790* BFD_RELOC_METAG_TLS_LDO:               howto manager.      (line 1618)
12791* BFD_RELOC_METAG_TLS_LDO_HI16:          howto manager.      (line 1616)
12792* BFD_RELOC_METAG_TLS_LDO_LO16:          howto manager.      (line 1617)
12793* BFD_RELOC_METAG_TLS_LE:                howto manager.      (line 1626)
12794* BFD_RELOC_METAG_TLS_LE_HI16:           howto manager.      (line 1627)
12795* BFD_RELOC_METAG_TLS_LE_LO16:           howto manager.      (line 1628)
12796* BFD_RELOC_METAG_TLS_TPOFF:             howto manager.      (line 1623)
12797* BFD_RELOC_MICROBLAZE_32_GOTOFF:        howto manager.      (line 2678)
12798* BFD_RELOC_MICROBLAZE_32_LO:            howto manager.      (line 2644)
12799* BFD_RELOC_MICROBLAZE_32_LO_PCREL:      howto manager.      (line 2647)
12800* BFD_RELOC_MICROBLAZE_32_ROSDA:         howto manager.      (line 2650)
12801* BFD_RELOC_MICROBLAZE_32_RWSDA:         howto manager.      (line 2653)
12802* BFD_RELOC_MICROBLAZE_32_SYM_OP_SYM:    howto manager.      (line 2656)
12803* BFD_RELOC_MICROBLAZE_32_TLSDTPMOD:     howto manager.      (line 2694)
12804* BFD_RELOC_MICROBLAZE_32_TLSDTPREL:     howto manager.      (line 2696)
12805* BFD_RELOC_MICROBLAZE_64_GOT:           howto manager.      (line 2667)
12806* BFD_RELOC_MICROBLAZE_64_GOTOFF:        howto manager.      (line 2674)
12807* BFD_RELOC_MICROBLAZE_64_GOTPC:         howto manager.      (line 2663)
12808* BFD_RELOC_MICROBLAZE_64_NONE:          howto manager.      (line 2659)
12809* BFD_RELOC_MICROBLAZE_64_PLT:           howto manager.      (line 2670)
12810* BFD_RELOC_MICROBLAZE_64_TEXTPCREL:     howto manager.      (line 2707)
12811* BFD_RELOC_MICROBLAZE_64_TEXTREL:       howto manager.      (line 2711)
12812* BFD_RELOC_MICROBLAZE_64_TLS:           howto manager.      (line 2684)
12813* BFD_RELOC_MICROBLAZE_64_TLSDTPREL:     howto manager.      (line 2698)
12814* BFD_RELOC_MICROBLAZE_64_TLSGD:         howto manager.      (line 2686)
12815* BFD_RELOC_MICROBLAZE_64_TLSGOTTPREL:   howto manager.      (line 2701)
12816* BFD_RELOC_MICROBLAZE_64_TLSLD:         howto manager.      (line 2690)
12817* BFD_RELOC_MICROBLAZE_64_TLSTPREL:      howto manager.      (line 2704)
12818* BFD_RELOC_MICROBLAZE_COPY:             howto manager.      (line 2681)
12819* BFD_RELOC_MICROMIPS_10_PCREL_S1:       howto manager.      (line  352)
12820* BFD_RELOC_MICROMIPS_16_PCREL_S1:       howto manager.      (line  353)
12821* BFD_RELOC_MICROMIPS_7_PCREL_S1:        howto manager.      (line  351)
12822* BFD_RELOC_MICROMIPS_CALL16:            howto manager.      (line  370)
12823* BFD_RELOC_MICROMIPS_CALL_HI16:         howto manager.      (line  376)
12824* BFD_RELOC_MICROMIPS_CALL_LO16:         howto manager.      (line  378)
12825* BFD_RELOC_MICROMIPS_GOT16:             howto manager.      (line  368)
12826* BFD_RELOC_MICROMIPS_GOT_DISP:          howto manager.      (line  386)
12827* BFD_RELOC_MICROMIPS_GOT_HI16:          howto manager.      (line  372)
12828* BFD_RELOC_MICROMIPS_GOT_LO16:          howto manager.      (line  374)
12829* BFD_RELOC_MICROMIPS_GOT_OFST:          howto manager.      (line  384)
12830* BFD_RELOC_MICROMIPS_GOT_PAGE:          howto manager.      (line  382)
12831* BFD_RELOC_MICROMIPS_GPREL16:           howto manager.      (line  362)
12832* BFD_RELOC_MICROMIPS_HI16:              howto manager.      (line  363)
12833* BFD_RELOC_MICROMIPS_HI16_S:            howto manager.      (line  364)
12834* BFD_RELOC_MICROMIPS_HIGHER:            howto manager.      (line  395)
12835* BFD_RELOC_MICROMIPS_HIGHEST:           howto manager.      (line  393)
12836* BFD_RELOC_MICROMIPS_JALR:              howto manager.      (line  401)
12837* BFD_RELOC_MICROMIPS_JMP:               howto manager.      (line  306)
12838* BFD_RELOC_MICROMIPS_LITERAL:           howto manager.      (line  349)
12839* BFD_RELOC_MICROMIPS_LO16:              howto manager.      (line  365)
12840* BFD_RELOC_MICROMIPS_SCN_DISP:          howto manager.      (line  397)
12841* BFD_RELOC_MICROMIPS_SUB:               howto manager.      (line  380)
12842* BFD_RELOC_MICROMIPS_TLS_DTPREL_HI16:   howto manager.      (line  411)
12843* BFD_RELOC_MICROMIPS_TLS_DTPREL_LO16:   howto manager.      (line  413)
12844* BFD_RELOC_MICROMIPS_TLS_GD:            howto manager.      (line  407)
12845* BFD_RELOC_MICROMIPS_TLS_GOTTPREL:      howto manager.      (line  415)
12846* BFD_RELOC_MICROMIPS_TLS_LDM:           howto manager.      (line  409)
12847* BFD_RELOC_MICROMIPS_TLS_TPREL_HI16:    howto manager.      (line  419)
12848* BFD_RELOC_MICROMIPS_TLS_TPREL_LO16:    howto manager.      (line  421)
12849* BFD_RELOC_MIPS16_16_PCREL_S1:          howto manager.      (line  355)
12850* BFD_RELOC_MIPS16_CALL16:               howto manager.      (line  328)
12851* BFD_RELOC_MIPS16_GOT16:                howto manager.      (line  327)
12852* BFD_RELOC_MIPS16_GPREL:                howto manager.      (line  310)
12853* BFD_RELOC_MIPS16_HI16:                 howto manager.      (line  331)
12854* BFD_RELOC_MIPS16_HI16_S:               howto manager.      (line  333)
12855* BFD_RELOC_MIPS16_JMP:                  howto manager.      (line  308)
12856* BFD_RELOC_MIPS16_LO16:                 howto manager.      (line  338)
12857* BFD_RELOC_MIPS16_TLS_DTPREL_HI16:      howto manager.      (line  342)
12858* BFD_RELOC_MIPS16_TLS_DTPREL_LO16:      howto manager.      (line  343)
12859* BFD_RELOC_MIPS16_TLS_GD:               howto manager.      (line  340)
12860* BFD_RELOC_MIPS16_TLS_GOTTPREL:         howto manager.      (line  344)
12861* BFD_RELOC_MIPS16_TLS_LDM:              howto manager.      (line  341)
12862* BFD_RELOC_MIPS16_TLS_TPREL_HI16:       howto manager.      (line  345)
12863* BFD_RELOC_MIPS16_TLS_TPREL_LO16:       howto manager.      (line  346)
12864* BFD_RELOC_MIPS_18_PCREL_S3:            howto manager.      (line  359)
12865* BFD_RELOC_MIPS_19_PCREL_S2:            howto manager.      (line  360)
12866* BFD_RELOC_MIPS_21_PCREL_S2:            howto manager.      (line  357)
12867* BFD_RELOC_MIPS_26_PCREL_S2:            howto manager.      (line  358)
12868* BFD_RELOC_MIPS_CALL16:                 howto manager.      (line  369)
12869* BFD_RELOC_MIPS_CALL_HI16:              howto manager.      (line  375)
12870* BFD_RELOC_MIPS_CALL_LO16:              howto manager.      (line  377)
12871* BFD_RELOC_MIPS_COPY:                   howto manager.      (line  424)
12872* BFD_RELOC_MIPS_DELETE:                 howto manager.      (line  391)
12873* BFD_RELOC_MIPS_EH:                     howto manager.      (line  422)
12874* BFD_RELOC_MIPS_GOT16:                  howto manager.      (line  367)
12875* BFD_RELOC_MIPS_GOT_DISP:               howto manager.      (line  385)
12876* BFD_RELOC_MIPS_GOT_HI16:               howto manager.      (line  371)
12877* BFD_RELOC_MIPS_GOT_LO16:               howto manager.      (line  373)
12878* BFD_RELOC_MIPS_GOT_OFST:               howto manager.      (line  383)
12879* BFD_RELOC_MIPS_GOT_PAGE:               howto manager.      (line  381)
12880* BFD_RELOC_MIPS_HIGHER:                 howto manager.      (line  394)
12881* BFD_RELOC_MIPS_HIGHEST:                howto manager.      (line  392)
12882* BFD_RELOC_MIPS_INSERT_A:               howto manager.      (line  389)
12883* BFD_RELOC_MIPS_INSERT_B:               howto manager.      (line  390)
12884* BFD_RELOC_MIPS_JALR:                   howto manager.      (line  400)
12885* BFD_RELOC_MIPS_JMP:                    howto manager.      (line  305)
12886* BFD_RELOC_MIPS_JUMP_SLOT:              howto manager.      (line  425)
12887* BFD_RELOC_MIPS_LITERAL:                howto manager.      (line  348)
12888* BFD_RELOC_MIPS_REL16:                  howto manager.      (line  398)
12889* BFD_RELOC_MIPS_RELGOT:                 howto manager.      (line  399)
12890* BFD_RELOC_MIPS_SCN_DISP:               howto manager.      (line  396)
12891* BFD_RELOC_MIPS_SHIFT5:                 howto manager.      (line  387)
12892* BFD_RELOC_MIPS_SHIFT6:                 howto manager.      (line  388)
12893* BFD_RELOC_MIPS_SUB:                    howto manager.      (line  379)
12894* BFD_RELOC_MIPS_TLS_DTPMOD32:           howto manager.      (line  402)
12895* BFD_RELOC_MIPS_TLS_DTPMOD64:           howto manager.      (line  404)
12896* BFD_RELOC_MIPS_TLS_DTPREL32:           howto manager.      (line  403)
12897* BFD_RELOC_MIPS_TLS_DTPREL64:           howto manager.      (line  405)
12898* BFD_RELOC_MIPS_TLS_DTPREL_HI16:        howto manager.      (line  410)
12899* BFD_RELOC_MIPS_TLS_DTPREL_LO16:        howto manager.      (line  412)
12900* BFD_RELOC_MIPS_TLS_GD:                 howto manager.      (line  406)
12901* BFD_RELOC_MIPS_TLS_GOTTPREL:           howto manager.      (line  414)
12902* BFD_RELOC_MIPS_TLS_LDM:                howto manager.      (line  408)
12903* BFD_RELOC_MIPS_TLS_TPREL32:            howto manager.      (line  416)
12904* BFD_RELOC_MIPS_TLS_TPREL64:            howto manager.      (line  417)
12905* BFD_RELOC_MIPS_TLS_TPREL_HI16:         howto manager.      (line  418)
12906* BFD_RELOC_MIPS_TLS_TPREL_LO16:         howto manager.      (line  420)
12907* BFD_RELOC_MMIX_ADDR19:                 howto manager.      (line 1652)
12908* BFD_RELOC_MMIX_ADDR27:                 howto manager.      (line 1655)
12909* BFD_RELOC_MMIX_BASE_PLUS_OFFSET:       howto manager.      (line 1664)
12910* BFD_RELOC_MMIX_CBRANCH:                howto manager.      (line 1635)
12911* BFD_RELOC_MMIX_CBRANCH_1:              howto manager.      (line 1637)
12912* BFD_RELOC_MMIX_CBRANCH_2:              howto manager.      (line 1638)
12913* BFD_RELOC_MMIX_CBRANCH_3:              howto manager.      (line 1639)
12914* BFD_RELOC_MMIX_CBRANCH_J:              howto manager.      (line 1636)
12915* BFD_RELOC_MMIX_GETA:                   howto manager.      (line 1630)
12916* BFD_RELOC_MMIX_GETA_1:                 howto manager.      (line 1631)
12917* BFD_RELOC_MMIX_GETA_2:                 howto manager.      (line 1632)
12918* BFD_RELOC_MMIX_GETA_3:                 howto manager.      (line 1633)
12919* BFD_RELOC_MMIX_JMP:                    howto manager.      (line 1647)
12920* BFD_RELOC_MMIX_JMP_1:                  howto manager.      (line 1648)
12921* BFD_RELOC_MMIX_JMP_2:                  howto manager.      (line 1649)
12922* BFD_RELOC_MMIX_JMP_3:                  howto manager.      (line 1650)
12923* BFD_RELOC_MMIX_LOCAL:                  howto manager.      (line 1667)
12924* BFD_RELOC_MMIX_PUSHJ:                  howto manager.      (line 1641)
12925* BFD_RELOC_MMIX_PUSHJ_1:                howto manager.      (line 1642)
12926* BFD_RELOC_MMIX_PUSHJ_2:                howto manager.      (line 1643)
12927* BFD_RELOC_MMIX_PUSHJ_3:                howto manager.      (line 1644)
12928* BFD_RELOC_MMIX_PUSHJ_STUBBABLE:        howto manager.      (line 1645)
12929* BFD_RELOC_MMIX_REG:                    howto manager.      (line 1661)
12930* BFD_RELOC_MMIX_REG_OR_BYTE:            howto manager.      (line 1658)
12931* BFD_RELOC_MN10300_16_PCREL:            howto manager.      (line  518)
12932* BFD_RELOC_MN10300_32_PCREL:            howto manager.      (line  515)
12933* BFD_RELOC_MN10300_ALIGN:               howto manager.      (line  502)
12934* BFD_RELOC_MN10300_COPY:                howto manager.      (line  490)
12935* BFD_RELOC_MN10300_GLOB_DAT:            howto manager.      (line  492)
12936* BFD_RELOC_MN10300_GOT16:               howto manager.      (line  487)
12937* BFD_RELOC_MN10300_GOT24:               howto manager.      (line  484)
12938* BFD_RELOC_MN10300_GOT32:               howto manager.      (line  481)
12939* BFD_RELOC_MN10300_GOTOFF24:            howto manager.      (line  479)
12940* BFD_RELOC_MN10300_JMP_SLOT:            howto manager.      (line  494)
12941* BFD_RELOC_MN10300_RELATIVE:            howto manager.      (line  496)
12942* BFD_RELOC_MN10300_SYM_DIFF:            howto manager.      (line  498)
12943* BFD_RELOC_MN10300_TLS_DTPMOD:          howto manager.      (line  511)
12944* BFD_RELOC_MN10300_TLS_DTPOFF:          howto manager.      (line  512)
12945* BFD_RELOC_MN10300_TLS_GD:              howto manager.      (line  505)
12946* BFD_RELOC_MN10300_TLS_GOTIE:           howto manager.      (line  508)
12947* BFD_RELOC_MN10300_TLS_IE:              howto manager.      (line  509)
12948* BFD_RELOC_MN10300_TLS_LD:              howto manager.      (line  506)
12949* BFD_RELOC_MN10300_TLS_LDO:             howto manager.      (line  507)
12950* BFD_RELOC_MN10300_TLS_LE:              howto manager.      (line  510)
12951* BFD_RELOC_MN10300_TLS_TPOFF:           howto manager.      (line  513)
12952* BFD_RELOC_MOXIE_10_PCREL:              howto manager.      (line  427)
12953* BFD_RELOC_MSP430X_ABS16:               howto manager.      (line 2422)
12954* BFD_RELOC_MSP430X_ABS20_ADR_DST:       howto manager.      (line 2419)
12955* BFD_RELOC_MSP430X_ABS20_ADR_SRC:       howto manager.      (line 2418)
12956* BFD_RELOC_MSP430X_ABS20_EXT_DST:       howto manager.      (line 2416)
12957* BFD_RELOC_MSP430X_ABS20_EXT_ODST:      howto manager.      (line 2417)
12958* BFD_RELOC_MSP430X_ABS20_EXT_SRC:       howto manager.      (line 2415)
12959* BFD_RELOC_MSP430X_PCR16:               howto manager.      (line 2420)
12960* BFD_RELOC_MSP430X_PCR20_CALL:          howto manager.      (line 2421)
12961* BFD_RELOC_MSP430X_PCR20_EXT_DST:       howto manager.      (line 2413)
12962* BFD_RELOC_MSP430X_PCR20_EXT_ODST:      howto manager.      (line 2414)
12963* BFD_RELOC_MSP430X_PCR20_EXT_SRC:       howto manager.      (line 2412)
12964* BFD_RELOC_MSP430_10_PCREL:             howto manager.      (line 2404)
12965* BFD_RELOC_MSP430_16:                   howto manager.      (line 2406)
12966* BFD_RELOC_MSP430_16_BYTE:              howto manager.      (line 2408)
12967* BFD_RELOC_MSP430_16_PCREL:             howto manager.      (line 2405)
12968* BFD_RELOC_MSP430_16_PCREL_BYTE:        howto manager.      (line 2407)
12969* BFD_RELOC_MSP430_2X_PCREL:             howto manager.      (line 2409)
12970* BFD_RELOC_MSP430_ABS8:                 howto manager.      (line 2411)
12971* BFD_RELOC_MSP430_ABS_HI16:             howto manager.      (line 2423)
12972* BFD_RELOC_MSP430_PREL31:               howto manager.      (line 2424)
12973* BFD_RELOC_MSP430_RL_PCREL:             howto manager.      (line 2410)
12974* BFD_RELOC_MSP430_SYM_DIFF:             howto manager.      (line 2425)
12975* BFD_RELOC_MT_GNU_VTENTRY:              howto manager.      (line 2400)
12976* BFD_RELOC_MT_GNU_VTINHERIT:            howto manager.      (line 2398)
12977* BFD_RELOC_MT_HI16:                     howto manager.      (line 2394)
12978* BFD_RELOC_MT_LO16:                     howto manager.      (line 2396)
12979* BFD_RELOC_MT_PC16:                     howto manager.      (line 2392)
12980* BFD_RELOC_MT_PCINSN8:                  howto manager.      (line 2402)
12981* BFD_RELOC_NDS32_10IFCU_PCREL:          howto manager.      (line 1380)
12982* BFD_RELOC_NDS32_10_UPCREL:             howto manager.      (line 1351)
12983* BFD_RELOC_NDS32_15_FIXED:              howto manager.      (line 1312)
12984* BFD_RELOC_NDS32_15_PCREL:              howto manager.      (line 1238)
12985* BFD_RELOC_NDS32_17IFC_PCREL:           howto manager.      (line 1379)
12986* BFD_RELOC_NDS32_17_FIXED:              howto manager.      (line 1313)
12987* BFD_RELOC_NDS32_17_PCREL:              howto manager.      (line 1240)
12988* BFD_RELOC_NDS32_20:                    howto manager.      (line 1230)
12989* BFD_RELOC_NDS32_25_ABS:                howto manager.      (line 1375)
12990* BFD_RELOC_NDS32_25_FIXED:              howto manager.      (line 1314)
12991* BFD_RELOC_NDS32_25_PCREL:              howto manager.      (line 1242)
12992* BFD_RELOC_NDS32_25_PLTREL:             howto manager.      (line 1288)
12993* BFD_RELOC_NDS32_5:                     howto manager.      (line 1349)
12994* BFD_RELOC_NDS32_9_FIXED:               howto manager.      (line 1311)
12995* BFD_RELOC_NDS32_9_PCREL:               howto manager.      (line 1232)
12996* BFD_RELOC_NDS32_9_PLTREL:              howto manager.      (line 1287)
12997* BFD_RELOC_NDS32_COPY:                  howto manager.      (line 1289)
12998* BFD_RELOC_NDS32_DATA:                  howto manager.      (line 1377)
12999* BFD_RELOC_NDS32_DIFF16:                howto manager.      (line 1370)
13000* BFD_RELOC_NDS32_DIFF32:                howto manager.      (line 1371)
13001* BFD_RELOC_NDS32_DIFF8:                 howto manager.      (line 1369)
13002* BFD_RELOC_NDS32_DIFF_ULEB128:          howto manager.      (line 1372)
13003* BFD_RELOC_NDS32_DWARF2_LEB:            howto manager.      (line 1335)
13004* BFD_RELOC_NDS32_DWARF2_OP1:            howto manager.      (line 1333)
13005* BFD_RELOC_NDS32_DWARF2_OP2:            howto manager.      (line 1334)
13006* BFD_RELOC_NDS32_EMPTY:                 howto manager.      (line 1373)
13007* BFD_RELOC_NDS32_GLOB_DAT:              howto manager.      (line 1290)
13008* BFD_RELOC_NDS32_GOT15S2:               howto manager.      (line 1346)
13009* BFD_RELOC_NDS32_GOT17S2:               howto manager.      (line 1347)
13010* BFD_RELOC_NDS32_GOT20:                 howto manager.      (line 1286)
13011* BFD_RELOC_NDS32_GOTOFF:                howto manager.      (line 1293)
13012* BFD_RELOC_NDS32_GOTOFF_HI20:           howto manager.      (line 1294)
13013* BFD_RELOC_NDS32_GOTOFF_LO12:           howto manager.      (line 1295)
13014* BFD_RELOC_NDS32_GOTOFF_LO15:           howto manager.      (line 1344)
13015* BFD_RELOC_NDS32_GOTOFF_LO19:           howto manager.      (line 1345)
13016* BFD_RELOC_NDS32_GOTOFF_SUFF:           howto manager.      (line 1358)
13017* BFD_RELOC_NDS32_GOTPC20:               howto manager.      (line 1296)
13018* BFD_RELOC_NDS32_GOTPC_HI20:            howto manager.      (line 1299)
13019* BFD_RELOC_NDS32_GOTPC_LO12:            howto manager.      (line 1300)
13020* BFD_RELOC_NDS32_GOTTPOFF:              howto manager.      (line 1387)
13021* BFD_RELOC_NDS32_GOT_HI20:              howto manager.      (line 1297)
13022* BFD_RELOC_NDS32_GOT_LO12:              howto manager.      (line 1298)
13023* BFD_RELOC_NDS32_GOT_LO15:              howto manager.      (line 1342)
13024* BFD_RELOC_NDS32_GOT_LO19:              howto manager.      (line 1343)
13025* BFD_RELOC_NDS32_GOT_SUFF:              howto manager.      (line 1357)
13026* BFD_RELOC_NDS32_HI20:                  howto manager.      (line 1244)
13027* BFD_RELOC_NDS32_INSN16:                howto manager.      (line 1302)
13028* BFD_RELOC_NDS32_JMP_SLOT:              howto manager.      (line 1291)
13029* BFD_RELOC_NDS32_LABEL:                 howto manager.      (line 1303)
13030* BFD_RELOC_NDS32_LO12S0:                howto manager.      (line 1256)
13031* BFD_RELOC_NDS32_LO12S0_ORI:            howto manager.      (line 1259)
13032* BFD_RELOC_NDS32_LO12S1:                howto manager.      (line 1253)
13033* BFD_RELOC_NDS32_LO12S2:                howto manager.      (line 1250)
13034* BFD_RELOC_NDS32_LO12S2_DP:             howto manager.      (line 1330)
13035* BFD_RELOC_NDS32_LO12S2_SP:             howto manager.      (line 1331)
13036* BFD_RELOC_NDS32_LO12S3:                howto manager.      (line 1247)
13037* BFD_RELOC_NDS32_LOADSTORE:             howto manager.      (line 1310)
13038* BFD_RELOC_NDS32_LONGCALL1:             howto manager.      (line 1304)
13039* BFD_RELOC_NDS32_LONGCALL2:             howto manager.      (line 1305)
13040* BFD_RELOC_NDS32_LONGCALL3:             howto manager.      (line 1306)
13041* BFD_RELOC_NDS32_LONGCALL4:             howto manager.      (line 1315)
13042* BFD_RELOC_NDS32_LONGCALL5:             howto manager.      (line 1316)
13043* BFD_RELOC_NDS32_LONGCALL6:             howto manager.      (line 1317)
13044* BFD_RELOC_NDS32_LONGJUMP1:             howto manager.      (line 1307)
13045* BFD_RELOC_NDS32_LONGJUMP2:             howto manager.      (line 1308)
13046* BFD_RELOC_NDS32_LONGJUMP3:             howto manager.      (line 1309)
13047* BFD_RELOC_NDS32_LONGJUMP4:             howto manager.      (line 1318)
13048* BFD_RELOC_NDS32_LONGJUMP5:             howto manager.      (line 1319)
13049* BFD_RELOC_NDS32_LONGJUMP6:             howto manager.      (line 1320)
13050* BFD_RELOC_NDS32_LONGJUMP7:             howto manager.      (line 1321)
13051* BFD_RELOC_NDS32_MINUEND:               howto manager.      (line 1367)
13052* BFD_RELOC_NDS32_MULCALL_SUFF:          howto manager.      (line 1360)
13053* BFD_RELOC_NDS32_PLTBLOCK:              howto manager.      (line 1364)
13054* BFD_RELOC_NDS32_PLTREL_HI20:           howto manager.      (line 1323)
13055* BFD_RELOC_NDS32_PLTREL_LO12:           howto manager.      (line 1324)
13056* BFD_RELOC_NDS32_PLT_GOTREL_HI20:       howto manager.      (line 1325)
13057* BFD_RELOC_NDS32_PLT_GOTREL_LO12:       howto manager.      (line 1326)
13058* BFD_RELOC_NDS32_PLT_GOTREL_LO15:       howto manager.      (line 1340)
13059* BFD_RELOC_NDS32_PLT_GOTREL_LO19:       howto manager.      (line 1341)
13060* BFD_RELOC_NDS32_PLT_GOTREL_LO20:       howto manager.      (line 1339)
13061* BFD_RELOC_NDS32_PLT_GOT_SUFF:          howto manager.      (line 1359)
13062* BFD_RELOC_NDS32_PTR:                   howto manager.      (line 1361)
13063* BFD_RELOC_NDS32_PTR_COUNT:             howto manager.      (line 1362)
13064* BFD_RELOC_NDS32_PTR_RESOLVED:          howto manager.      (line 1363)
13065* BFD_RELOC_NDS32_RELATIVE:              howto manager.      (line 1292)
13066* BFD_RELOC_NDS32_RELAX_ENTRY:           howto manager.      (line 1356)
13067* BFD_RELOC_NDS32_RELAX_REGION_BEGIN:    howto manager.      (line 1365)
13068* BFD_RELOC_NDS32_RELAX_REGION_END:      howto manager.      (line 1366)
13069* BFD_RELOC_NDS32_SDA12S2_DP:            howto manager.      (line 1328)
13070* BFD_RELOC_NDS32_SDA12S2_SP:            howto manager.      (line 1329)
13071* BFD_RELOC_NDS32_SDA15S0:               howto manager.      (line 1271)
13072* BFD_RELOC_NDS32_SDA15S1:               howto manager.      (line 1268)
13073* BFD_RELOC_NDS32_SDA15S2:               howto manager.      (line 1265)
13074* BFD_RELOC_NDS32_SDA15S3:               howto manager.      (line 1262)
13075* BFD_RELOC_NDS32_SDA16S3:               howto manager.      (line 1274)
13076* BFD_RELOC_NDS32_SDA17S2:               howto manager.      (line 1277)
13077* BFD_RELOC_NDS32_SDA18S1:               howto manager.      (line 1280)
13078* BFD_RELOC_NDS32_SDA19S0:               howto manager.      (line 1283)
13079* BFD_RELOC_NDS32_SDA_FP7U2_RELA:        howto manager.      (line 1354)
13080* BFD_RELOC_NDS32_SUBTRAHEND:            howto manager.      (line 1368)
13081* BFD_RELOC_NDS32_TLS_IE_HI20:           howto manager.      (line 1388)
13082* BFD_RELOC_NDS32_TLS_IE_LO12S2:         howto manager.      (line 1389)
13083* BFD_RELOC_NDS32_TLS_LE_15S0:           howto manager.      (line 1392)
13084* BFD_RELOC_NDS32_TLS_LE_15S1:           howto manager.      (line 1393)
13085* BFD_RELOC_NDS32_TLS_LE_15S2:           howto manager.      (line 1394)
13086* BFD_RELOC_NDS32_TLS_LE_20:             howto manager.      (line 1391)
13087* BFD_RELOC_NDS32_TLS_LE_ADD:            howto manager.      (line 1385)
13088* BFD_RELOC_NDS32_TLS_LE_HI20:           howto manager.      (line 1383)
13089* BFD_RELOC_NDS32_TLS_LE_LO12:           howto manager.      (line 1384)
13090* BFD_RELOC_NDS32_TLS_LE_LS:             howto manager.      (line 1386)
13091* BFD_RELOC_NDS32_TLS_TPOFF:             howto manager.      (line 1390)
13092* BFD_RELOC_NDS32_TPOFF:                 howto manager.      (line 1382)
13093* BFD_RELOC_NDS32_TRAN:                  howto manager.      (line 1378)
13094* BFD_RELOC_NDS32_UPDATE_TA:             howto manager.      (line 1337)
13095* BFD_RELOC_NDS32_WORD_9_PCREL:          howto manager.      (line 1235)
13096* BFD_RELOC_NIOS2_ALIGN:                 howto manager.      (line 2441)
13097* BFD_RELOC_NIOS2_CACHE_OPX:             howto manager.      (line 2431)
13098* BFD_RELOC_NIOS2_CALL16:                howto manager.      (line 2443)
13099* BFD_RELOC_NIOS2_CALL26:                howto manager.      (line 2429)
13100* BFD_RELOC_NIOS2_CALL26_NOAT:           howto manager.      (line 2461)
13101* BFD_RELOC_NIOS2_CALLR:                 howto manager.      (line 2440)
13102* BFD_RELOC_NIOS2_CALL_HA:               howto manager.      (line 2465)
13103* BFD_RELOC_NIOS2_CALL_LO:               howto manager.      (line 2464)
13104* BFD_RELOC_NIOS2_CJMP:                  howto manager.      (line 2439)
13105* BFD_RELOC_NIOS2_COPY:                  howto manager.      (line 2456)
13106* BFD_RELOC_NIOS2_GLOB_DAT:              howto manager.      (line 2457)
13107* BFD_RELOC_NIOS2_GOT16:                 howto manager.      (line 2442)
13108* BFD_RELOC_NIOS2_GOTOFF:                howto manager.      (line 2460)
13109* BFD_RELOC_NIOS2_GOTOFF_HA:             howto manager.      (line 2445)
13110* BFD_RELOC_NIOS2_GOTOFF_LO:             howto manager.      (line 2444)
13111* BFD_RELOC_NIOS2_GOT_HA:                howto manager.      (line 2463)
13112* BFD_RELOC_NIOS2_GOT_LO:                howto manager.      (line 2462)
13113* BFD_RELOC_NIOS2_GPREL:                 howto manager.      (line 2437)
13114* BFD_RELOC_NIOS2_HI16:                  howto manager.      (line 2434)
13115* BFD_RELOC_NIOS2_HIADJ16:               howto manager.      (line 2436)
13116* BFD_RELOC_NIOS2_IMM5:                  howto manager.      (line 2430)
13117* BFD_RELOC_NIOS2_IMM6:                  howto manager.      (line 2432)
13118* BFD_RELOC_NIOS2_IMM8:                  howto manager.      (line 2433)
13119* BFD_RELOC_NIOS2_JUMP_SLOT:             howto manager.      (line 2458)
13120* BFD_RELOC_NIOS2_LO16:                  howto manager.      (line 2435)
13121* BFD_RELOC_NIOS2_PCREL_HA:              howto manager.      (line 2447)
13122* BFD_RELOC_NIOS2_PCREL_LO:              howto manager.      (line 2446)
13123* BFD_RELOC_NIOS2_R2_F1I5_2:             howto manager.      (line 2475)
13124* BFD_RELOC_NIOS2_R2_I10_1_PCREL:        howto manager.      (line 2467)
13125* BFD_RELOC_NIOS2_R2_L5I4X1:             howto manager.      (line 2476)
13126* BFD_RELOC_NIOS2_R2_S12:                howto manager.      (line 2466)
13127* BFD_RELOC_NIOS2_R2_T1I7_1_PCREL:       howto manager.      (line 2468)
13128* BFD_RELOC_NIOS2_R2_T1I7_2:             howto manager.      (line 2469)
13129* BFD_RELOC_NIOS2_R2_T1X1I6:             howto manager.      (line 2477)
13130* BFD_RELOC_NIOS2_R2_T1X1I6_2:           howto manager.      (line 2478)
13131* BFD_RELOC_NIOS2_R2_T2I4:               howto manager.      (line 2470)
13132* BFD_RELOC_NIOS2_R2_T2I4_1:             howto manager.      (line 2471)
13133* BFD_RELOC_NIOS2_R2_T2I4_2:             howto manager.      (line 2472)
13134* BFD_RELOC_NIOS2_R2_X1I7_2:             howto manager.      (line 2473)
13135* BFD_RELOC_NIOS2_R2_X2L5:               howto manager.      (line 2474)
13136* BFD_RELOC_NIOS2_RELATIVE:              howto manager.      (line 2459)
13137* BFD_RELOC_NIOS2_S16:                   howto manager.      (line 2427)
13138* BFD_RELOC_NIOS2_TLS_DTPMOD:            howto manager.      (line 2453)
13139* BFD_RELOC_NIOS2_TLS_DTPREL:            howto manager.      (line 2454)
13140* BFD_RELOC_NIOS2_TLS_GD16:              howto manager.      (line 2448)
13141* BFD_RELOC_NIOS2_TLS_IE16:              howto manager.      (line 2451)
13142* BFD_RELOC_NIOS2_TLS_LDM16:             howto manager.      (line 2449)
13143* BFD_RELOC_NIOS2_TLS_LDO16:             howto manager.      (line 2450)
13144* BFD_RELOC_NIOS2_TLS_LE16:              howto manager.      (line 2452)
13145* BFD_RELOC_NIOS2_TLS_TPREL:             howto manager.      (line 2455)
13146* BFD_RELOC_NIOS2_U16:                   howto manager.      (line 2428)
13147* BFD_RELOC_NIOS2_UJMP:                  howto manager.      (line 2438)
13148* BFD_RELOC_NONE:                        howto manager.      (line  118)
13149* BFD_RELOC_NS32K_DISP_16:               howto manager.      (line  586)
13150* BFD_RELOC_NS32K_DISP_16_PCREL:         howto manager.      (line  589)
13151* BFD_RELOC_NS32K_DISP_32:               howto manager.      (line  587)
13152* BFD_RELOC_NS32K_DISP_32_PCREL:         howto manager.      (line  590)
13153* BFD_RELOC_NS32K_DISP_8:                howto manager.      (line  585)
13154* BFD_RELOC_NS32K_DISP_8_PCREL:          howto manager.      (line  588)
13155* BFD_RELOC_NS32K_IMM_16:                howto manager.      (line  580)
13156* BFD_RELOC_NS32K_IMM_16_PCREL:          howto manager.      (line  583)
13157* BFD_RELOC_NS32K_IMM_32:                howto manager.      (line  581)
13158* BFD_RELOC_NS32K_IMM_32_PCREL:          howto manager.      (line  584)
13159* BFD_RELOC_NS32K_IMM_8:                 howto manager.      (line  579)
13160* BFD_RELOC_NS32K_IMM_8_PCREL:           howto manager.      (line  582)
13161* bfd_reloc_offset_in_range:             typedef arelent.    (line  368)
13162* BFD_RELOC_OR1K_COPY:                   howto manager.      (line 2351)
13163* BFD_RELOC_OR1K_GLOB_DAT:               howto manager.      (line 2352)
13164* BFD_RELOC_OR1K_GOT16:                  howto manager.      (line 2347)
13165* BFD_RELOC_OR1K_GOTOFF_HI16:            howto manager.      (line 2349)
13166* BFD_RELOC_OR1K_GOTOFF_LO16:            howto manager.      (line 2350)
13167* BFD_RELOC_OR1K_GOTPC_HI16:             howto manager.      (line 2345)
13168* BFD_RELOC_OR1K_GOTPC_LO16:             howto manager.      (line 2346)
13169* BFD_RELOC_OR1K_JMP_SLOT:               howto manager.      (line 2353)
13170* BFD_RELOC_OR1K_PLT26:                  howto manager.      (line 2348)
13171* BFD_RELOC_OR1K_RELATIVE:               howto manager.      (line 2354)
13172* BFD_RELOC_OR1K_REL_26:                 howto manager.      (line 2344)
13173* BFD_RELOC_OR1K_TLS_DTPMOD:             howto manager.      (line 2367)
13174* BFD_RELOC_OR1K_TLS_DTPOFF:             howto manager.      (line 2366)
13175* BFD_RELOC_OR1K_TLS_GD_HI16:            howto manager.      (line 2355)
13176* BFD_RELOC_OR1K_TLS_GD_LO16:            howto manager.      (line 2356)
13177* BFD_RELOC_OR1K_TLS_IE_HI16:            howto manager.      (line 2361)
13178* BFD_RELOC_OR1K_TLS_IE_LO16:            howto manager.      (line 2362)
13179* BFD_RELOC_OR1K_TLS_LDM_HI16:           howto manager.      (line 2357)
13180* BFD_RELOC_OR1K_TLS_LDM_LO16:           howto manager.      (line 2358)
13181* BFD_RELOC_OR1K_TLS_LDO_HI16:           howto manager.      (line 2359)
13182* BFD_RELOC_OR1K_TLS_LDO_LO16:           howto manager.      (line 2360)
13183* BFD_RELOC_OR1K_TLS_LE_HI16:            howto manager.      (line 2363)
13184* BFD_RELOC_OR1K_TLS_LE_LO16:            howto manager.      (line 2364)
13185* BFD_RELOC_OR1K_TLS_TPOFF:              howto manager.      (line 2365)
13186* BFD_RELOC_PDP11_DISP_6_PCREL:          howto manager.      (line  593)
13187* BFD_RELOC_PDP11_DISP_8_PCREL:          howto manager.      (line  592)
13188* BFD_RELOC_PJ_CODE_DIR16:               howto manager.      (line  597)
13189* BFD_RELOC_PJ_CODE_DIR32:               howto manager.      (line  598)
13190* BFD_RELOC_PJ_CODE_HI16:                howto manager.      (line  595)
13191* BFD_RELOC_PJ_CODE_LO16:                howto manager.      (line  596)
13192* BFD_RELOC_PJ_CODE_REL16:               howto manager.      (line  599)
13193* BFD_RELOC_PJ_CODE_REL32:               howto manager.      (line  600)
13194* BFD_RELOC_PPC64_ADDR16_DS:             howto manager.      (line  663)
13195* BFD_RELOC_PPC64_ADDR16_HIGH:           howto manager.      (line  674)
13196* BFD_RELOC_PPC64_ADDR16_HIGHA:          howto manager.      (line  675)
13197* BFD_RELOC_PPC64_ADDR16_LO_DS:          howto manager.      (line  664)
13198* BFD_RELOC_PPC64_ADDR64_LOCAL:          howto manager.      (line  676)
13199* BFD_RELOC_PPC64_DTPREL16_DS:           howto manager.      (line  715)
13200* BFD_RELOC_PPC64_DTPREL16_HIGH:         howto manager.      (line  723)
13201* BFD_RELOC_PPC64_DTPREL16_HIGHA:        howto manager.      (line  724)
13202* BFD_RELOC_PPC64_DTPREL16_HIGHER:       howto manager.      (line  717)
13203* BFD_RELOC_PPC64_DTPREL16_HIGHERA:      howto manager.      (line  718)
13204* BFD_RELOC_PPC64_DTPREL16_HIGHEST:      howto manager.      (line  719)
13205* BFD_RELOC_PPC64_DTPREL16_HIGHESTA:     howto manager.      (line  720)
13206* BFD_RELOC_PPC64_DTPREL16_LO_DS:        howto manager.      (line  716)
13207* BFD_RELOC_PPC64_ENTRY:                 howto manager.      (line  677)
13208* BFD_RELOC_PPC64_GOT16_DS:              howto manager.      (line  665)
13209* BFD_RELOC_PPC64_GOT16_LO_DS:           howto manager.      (line  666)
13210* BFD_RELOC_PPC64_HIGHER:                howto manager.      (line  651)
13211* BFD_RELOC_PPC64_HIGHER_S:              howto manager.      (line  652)
13212* BFD_RELOC_PPC64_HIGHEST:               howto manager.      (line  653)
13213* BFD_RELOC_PPC64_HIGHEST_S:             howto manager.      (line  654)
13214* BFD_RELOC_PPC64_PLT16_LO_DS:           howto manager.      (line  667)
13215* BFD_RELOC_PPC64_PLTGOT16:              howto manager.      (line  659)
13216* BFD_RELOC_PPC64_PLTGOT16_DS:           howto manager.      (line  672)
13217* BFD_RELOC_PPC64_PLTGOT16_HA:           howto manager.      (line  662)
13218* BFD_RELOC_PPC64_PLTGOT16_HI:           howto manager.      (line  661)
13219* BFD_RELOC_PPC64_PLTGOT16_LO:           howto manager.      (line  660)
13220* BFD_RELOC_PPC64_PLTGOT16_LO_DS:        howto manager.      (line  673)
13221* BFD_RELOC_PPC64_SECTOFF_DS:            howto manager.      (line  668)
13222* BFD_RELOC_PPC64_SECTOFF_LO_DS:         howto manager.      (line  669)
13223* BFD_RELOC_PPC64_TOC:                   howto manager.      (line  658)
13224* BFD_RELOC_PPC64_TOC16_DS:              howto manager.      (line  670)
13225* BFD_RELOC_PPC64_TOC16_HA:              howto manager.      (line  657)
13226* BFD_RELOC_PPC64_TOC16_HI:              howto manager.      (line  656)
13227* BFD_RELOC_PPC64_TOC16_LO:              howto manager.      (line  655)
13228* BFD_RELOC_PPC64_TOC16_LO_DS:           howto manager.      (line  671)
13229* BFD_RELOC_PPC64_TPREL16_DS:            howto manager.      (line  709)
13230* BFD_RELOC_PPC64_TPREL16_HIGH:          howto manager.      (line  721)
13231* BFD_RELOC_PPC64_TPREL16_HIGHA:         howto manager.      (line  722)
13232* BFD_RELOC_PPC64_TPREL16_HIGHER:        howto manager.      (line  711)
13233* BFD_RELOC_PPC64_TPREL16_HIGHERA:       howto manager.      (line  712)
13234* BFD_RELOC_PPC64_TPREL16_HIGHEST:       howto manager.      (line  713)
13235* BFD_RELOC_PPC64_TPREL16_HIGHESTA:      howto manager.      (line  714)
13236* BFD_RELOC_PPC64_TPREL16_LO_DS:         howto manager.      (line  710)
13237* BFD_RELOC_PPC_16DX_HA:                 howto manager.      (line  649)
13238* BFD_RELOC_PPC_B16:                     howto manager.      (line  605)
13239* BFD_RELOC_PPC_B16_BRNTAKEN:            howto manager.      (line  607)
13240* BFD_RELOC_PPC_B16_BRTAKEN:             howto manager.      (line  606)
13241* BFD_RELOC_PPC_B26:                     howto manager.      (line  602)
13242* BFD_RELOC_PPC_BA16:                    howto manager.      (line  608)
13243* BFD_RELOC_PPC_BA16_BRNTAKEN:           howto manager.      (line  610)
13244* BFD_RELOC_PPC_BA16_BRTAKEN:            howto manager.      (line  609)
13245* BFD_RELOC_PPC_BA26:                    howto manager.      (line  603)
13246* BFD_RELOC_PPC_COPY:                    howto manager.      (line  611)
13247* BFD_RELOC_PPC_DTPMOD:                  howto manager.      (line  682)
13248* BFD_RELOC_PPC_DTPREL:                  howto manager.      (line  692)
13249* BFD_RELOC_PPC_DTPREL16:                howto manager.      (line  688)
13250* BFD_RELOC_PPC_DTPREL16_HA:             howto manager.      (line  691)
13251* BFD_RELOC_PPC_DTPREL16_HI:             howto manager.      (line  690)
13252* BFD_RELOC_PPC_DTPREL16_LO:             howto manager.      (line  689)
13253* BFD_RELOC_PPC_EMB_BIT_FLD:             howto manager.      (line  630)
13254* BFD_RELOC_PPC_EMB_MRKREF:              howto manager.      (line  625)
13255* BFD_RELOC_PPC_EMB_NADDR16:             howto manager.      (line  617)
13256* BFD_RELOC_PPC_EMB_NADDR16_HA:          howto manager.      (line  620)
13257* BFD_RELOC_PPC_EMB_NADDR16_HI:          howto manager.      (line  619)
13258* BFD_RELOC_PPC_EMB_NADDR16_LO:          howto manager.      (line  618)
13259* BFD_RELOC_PPC_EMB_NADDR32:             howto manager.      (line  616)
13260* BFD_RELOC_PPC_EMB_RELSDA:              howto manager.      (line  631)
13261* BFD_RELOC_PPC_EMB_RELSEC16:            howto manager.      (line  626)
13262* BFD_RELOC_PPC_EMB_RELST_HA:            howto manager.      (line  629)
13263* BFD_RELOC_PPC_EMB_RELST_HI:            howto manager.      (line  628)
13264* BFD_RELOC_PPC_EMB_RELST_LO:            howto manager.      (line  627)
13265* BFD_RELOC_PPC_EMB_SDA21:               howto manager.      (line  624)
13266* BFD_RELOC_PPC_EMB_SDA2I16:             howto manager.      (line  622)
13267* BFD_RELOC_PPC_EMB_SDA2REL:             howto manager.      (line  623)
13268* BFD_RELOC_PPC_EMB_SDAI16:              howto manager.      (line  621)
13269* BFD_RELOC_PPC_GLOB_DAT:                howto manager.      (line  612)
13270* BFD_RELOC_PPC_GOT_DTPREL16:            howto manager.      (line  705)
13271* BFD_RELOC_PPC_GOT_DTPREL16_HA:         howto manager.      (line  708)
13272* BFD_RELOC_PPC_GOT_DTPREL16_HI:         howto manager.      (line  707)
13273* BFD_RELOC_PPC_GOT_DTPREL16_LO:         howto manager.      (line  706)
13274* BFD_RELOC_PPC_GOT_TLSGD16:             howto manager.      (line  693)
13275* BFD_RELOC_PPC_GOT_TLSGD16_HA:          howto manager.      (line  696)
13276* BFD_RELOC_PPC_GOT_TLSGD16_HI:          howto manager.      (line  695)
13277* BFD_RELOC_PPC_GOT_TLSGD16_LO:          howto manager.      (line  694)
13278* BFD_RELOC_PPC_GOT_TLSLD16:             howto manager.      (line  697)
13279* BFD_RELOC_PPC_GOT_TLSLD16_HA:          howto manager.      (line  700)
13280* BFD_RELOC_PPC_GOT_TLSLD16_HI:          howto manager.      (line  699)
13281* BFD_RELOC_PPC_GOT_TLSLD16_LO:          howto manager.      (line  698)
13282* BFD_RELOC_PPC_GOT_TPREL16:             howto manager.      (line  701)
13283* BFD_RELOC_PPC_GOT_TPREL16_HA:          howto manager.      (line  704)
13284* BFD_RELOC_PPC_GOT_TPREL16_HI:          howto manager.      (line  703)
13285* BFD_RELOC_PPC_GOT_TPREL16_LO:          howto manager.      (line  702)
13286* BFD_RELOC_PPC_JMP_SLOT:                howto manager.      (line  613)
13287* BFD_RELOC_PPC_LOCAL24PC:               howto manager.      (line  615)
13288* BFD_RELOC_PPC_REL16DX_HA:              howto manager.      (line  650)
13289* BFD_RELOC_PPC_RELATIVE:                howto manager.      (line  614)
13290* BFD_RELOC_PPC_TLS:                     howto manager.      (line  679)
13291* BFD_RELOC_PPC_TLSGD:                   howto manager.      (line  680)
13292* BFD_RELOC_PPC_TLSLD:                   howto manager.      (line  681)
13293* BFD_RELOC_PPC_TOC16:                   howto manager.      (line  604)
13294* BFD_RELOC_PPC_TPREL:                   howto manager.      (line  687)
13295* BFD_RELOC_PPC_TPREL16:                 howto manager.      (line  683)
13296* BFD_RELOC_PPC_TPREL16_HA:              howto manager.      (line  686)
13297* BFD_RELOC_PPC_TPREL16_HI:              howto manager.      (line  685)
13298* BFD_RELOC_PPC_TPREL16_LO:              howto manager.      (line  684)
13299* BFD_RELOC_PPC_VLE_HA16A:               howto manager.      (line  639)
13300* BFD_RELOC_PPC_VLE_HA16D:               howto manager.      (line  640)
13301* BFD_RELOC_PPC_VLE_HI16A:               howto manager.      (line  637)
13302* BFD_RELOC_PPC_VLE_HI16D:               howto manager.      (line  638)
13303* BFD_RELOC_PPC_VLE_LO16A:               howto manager.      (line  635)
13304* BFD_RELOC_PPC_VLE_LO16D:               howto manager.      (line  636)
13305* BFD_RELOC_PPC_VLE_REL15:               howto manager.      (line  633)
13306* BFD_RELOC_PPC_VLE_REL24:               howto manager.      (line  634)
13307* BFD_RELOC_PPC_VLE_REL8:                howto manager.      (line  632)
13308* BFD_RELOC_PPC_VLE_SDA21:               howto manager.      (line  641)
13309* BFD_RELOC_PPC_VLE_SDA21_LO:            howto manager.      (line  642)
13310* BFD_RELOC_PPC_VLE_SDAREL_HA16A:        howto manager.      (line  647)
13311* BFD_RELOC_PPC_VLE_SDAREL_HA16D:        howto manager.      (line  648)
13312* BFD_RELOC_PPC_VLE_SDAREL_HI16A:        howto manager.      (line  645)
13313* BFD_RELOC_PPC_VLE_SDAREL_HI16D:        howto manager.      (line  646)
13314* BFD_RELOC_PPC_VLE_SDAREL_LO16A:        howto manager.      (line  643)
13315* BFD_RELOC_PPC_VLE_SDAREL_LO16D:        howto manager.      (line  644)
13316* BFD_RELOC_PRU_16_PMEM:                 howto manager.      (line 2493)
13317* BFD_RELOC_PRU_32_PMEM:                 howto manager.      (line 2492)
13318* BFD_RELOC_PRU_GNU_DIFF16:              howto manager.      (line 2497)
13319* BFD_RELOC_PRU_GNU_DIFF16_PMEM:         howto manager.      (line 2499)
13320* BFD_RELOC_PRU_GNU_DIFF32:              howto manager.      (line 2498)
13321* BFD_RELOC_PRU_GNU_DIFF32_PMEM:         howto manager.      (line 2500)
13322* BFD_RELOC_PRU_GNU_DIFF8:               howto manager.      (line 2496)
13323* BFD_RELOC_PRU_LDI32:                   howto manager.      (line 2484)
13324* BFD_RELOC_PRU_S10_PCREL:               howto manager.      (line 2488)
13325* BFD_RELOC_PRU_U16:                     howto manager.      (line 2480)
13326* BFD_RELOC_PRU_U16_PMEMIMM:             howto manager.      (line 2482)
13327* BFD_RELOC_PRU_U8_PCREL:                howto manager.      (line 2490)
13328* BFD_RELOC_RELC:                        howto manager.      (line 2381)
13329* BFD_RELOC_RISCV_32_PCREL:              howto manager.      (line 1824)
13330* BFD_RELOC_RISCV_ADD16:                 howto manager.      (line 1792)
13331* BFD_RELOC_RISCV_ADD32:                 howto manager.      (line 1793)
13332* BFD_RELOC_RISCV_ADD64:                 howto manager.      (line 1794)
13333* BFD_RELOC_RISCV_ADD8:                  howto manager.      (line 1791)
13334* BFD_RELOC_RISCV_ALIGN:                 howto manager.      (line 1809)
13335* BFD_RELOC_RISCV_CALL:                  howto manager.      (line 1789)
13336* BFD_RELOC_RISCV_CALL_PLT:              howto manager.      (line 1790)
13337* BFD_RELOC_RISCV_CFA:                   howto manager.      (line 1818)
13338* BFD_RELOC_RISCV_GOT_HI20:              howto manager.      (line 1799)
13339* BFD_RELOC_RISCV_GPREL12_I:             howto manager.      (line 1783)
13340* BFD_RELOC_RISCV_GPREL12_S:             howto manager.      (line 1784)
13341* BFD_RELOC_RISCV_GPREL_I:               howto manager.      (line 1813)
13342* BFD_RELOC_RISCV_GPREL_S:               howto manager.      (line 1814)
13343* BFD_RELOC_RISCV_HI20:                  howto manager.      (line 1777)
13344* BFD_RELOC_RISCV_JMP:                   howto manager.      (line 1802)
13345* BFD_RELOC_RISCV_LO12_I:                howto manager.      (line 1781)
13346* BFD_RELOC_RISCV_LO12_S:                howto manager.      (line 1782)
13347* BFD_RELOC_RISCV_PCREL_HI20:            howto manager.      (line 1778)
13348* BFD_RELOC_RISCV_PCREL_LO12_I:          howto manager.      (line 1779)
13349* BFD_RELOC_RISCV_PCREL_LO12_S:          howto manager.      (line 1780)
13350* BFD_RELOC_RISCV_RELAX:                 howto manager.      (line 1817)
13351* BFD_RELOC_RISCV_RVC_BRANCH:            howto manager.      (line 1810)
13352* BFD_RELOC_RISCV_RVC_JUMP:              howto manager.      (line 1811)
13353* BFD_RELOC_RISCV_RVC_LUI:               howto manager.      (line 1812)
13354* BFD_RELOC_RISCV_SET16:                 howto manager.      (line 1822)
13355* BFD_RELOC_RISCV_SET32:                 howto manager.      (line 1823)
13356* BFD_RELOC_RISCV_SET6:                  howto manager.      (line 1820)
13357* BFD_RELOC_RISCV_SET8:                  howto manager.      (line 1821)
13358* BFD_RELOC_RISCV_SUB16:                 howto manager.      (line 1796)
13359* BFD_RELOC_RISCV_SUB32:                 howto manager.      (line 1797)
13360* BFD_RELOC_RISCV_SUB6:                  howto manager.      (line 1819)
13361* BFD_RELOC_RISCV_SUB64:                 howto manager.      (line 1798)
13362* BFD_RELOC_RISCV_SUB8:                  howto manager.      (line 1795)
13363* BFD_RELOC_RISCV_TLS_DTPMOD32:          howto manager.      (line 1803)
13364* BFD_RELOC_RISCV_TLS_DTPMOD64:          howto manager.      (line 1805)
13365* BFD_RELOC_RISCV_TLS_DTPREL32:          howto manager.      (line 1804)
13366* BFD_RELOC_RISCV_TLS_DTPREL64:          howto manager.      (line 1806)
13367* BFD_RELOC_RISCV_TLS_GD_HI20:           howto manager.      (line 1801)
13368* BFD_RELOC_RISCV_TLS_GOT_HI20:          howto manager.      (line 1800)
13369* BFD_RELOC_RISCV_TLS_TPREL32:           howto manager.      (line 1807)
13370* BFD_RELOC_RISCV_TLS_TPREL64:           howto manager.      (line 1808)
13371* BFD_RELOC_RISCV_TPREL_ADD:             howto manager.      (line 1788)
13372* BFD_RELOC_RISCV_TPREL_HI20:            howto manager.      (line 1785)
13373* BFD_RELOC_RISCV_TPREL_I:               howto manager.      (line 1815)
13374* BFD_RELOC_RISCV_TPREL_LO12_I:          howto manager.      (line 1786)
13375* BFD_RELOC_RISCV_TPREL_LO12_S:          howto manager.      (line 1787)
13376* BFD_RELOC_RISCV_TPREL_S:               howto manager.      (line 1816)
13377* BFD_RELOC_RL78_16U:                    howto manager.      (line 1834)
13378* BFD_RELOC_RL78_16_OP:                  howto manager.      (line 1830)
13379* BFD_RELOC_RL78_24U:                    howto manager.      (line 1835)
13380* BFD_RELOC_RL78_24_OP:                  howto manager.      (line 1831)
13381* BFD_RELOC_RL78_32_OP:                  howto manager.      (line 1832)
13382* BFD_RELOC_RL78_8U:                     howto manager.      (line 1833)
13383* BFD_RELOC_RL78_ABS16:                  howto manager.      (line 1847)
13384* BFD_RELOC_RL78_ABS16U:                 howto manager.      (line 1851)
13385* BFD_RELOC_RL78_ABS16UL:                howto manager.      (line 1853)
13386* BFD_RELOC_RL78_ABS16UW:                howto manager.      (line 1852)
13387* BFD_RELOC_RL78_ABS16_REV:              howto manager.      (line 1848)
13388* BFD_RELOC_RL78_ABS32:                  howto manager.      (line 1849)
13389* BFD_RELOC_RL78_ABS32_REV:              howto manager.      (line 1850)
13390* BFD_RELOC_RL78_ABS8:                   howto manager.      (line 1846)
13391* BFD_RELOC_RL78_CODE:                   howto manager.      (line 1858)
13392* BFD_RELOC_RL78_DIFF:                   howto manager.      (line 1837)
13393* BFD_RELOC_RL78_DIR3U_PCREL:            howto manager.      (line 1836)
13394* BFD_RELOC_RL78_GPRELB:                 howto manager.      (line 1838)
13395* BFD_RELOC_RL78_GPRELL:                 howto manager.      (line 1840)
13396* BFD_RELOC_RL78_GPRELW:                 howto manager.      (line 1839)
13397* BFD_RELOC_RL78_HI16:                   howto manager.      (line 1855)
13398* BFD_RELOC_RL78_HI8:                    howto manager.      (line 1856)
13399* BFD_RELOC_RL78_LO16:                   howto manager.      (line 1857)
13400* BFD_RELOC_RL78_NEG16:                  howto manager.      (line 1827)
13401* BFD_RELOC_RL78_NEG24:                  howto manager.      (line 1828)
13402* BFD_RELOC_RL78_NEG32:                  howto manager.      (line 1829)
13403* BFD_RELOC_RL78_NEG8:                   howto manager.      (line 1826)
13404* BFD_RELOC_RL78_OP_AND:                 howto manager.      (line 1844)
13405* BFD_RELOC_RL78_OP_NEG:                 howto manager.      (line 1843)
13406* BFD_RELOC_RL78_OP_SHRA:                howto manager.      (line 1845)
13407* BFD_RELOC_RL78_OP_SUBTRACT:            howto manager.      (line 1842)
13408* BFD_RELOC_RL78_RELAX:                  howto manager.      (line 1854)
13409* BFD_RELOC_RL78_SADDR:                  howto manager.      (line 1859)
13410* BFD_RELOC_RL78_SYM:                    howto manager.      (line 1841)
13411* BFD_RELOC_RVA:                         howto manager.      (line   95)
13412* BFD_RELOC_RX_16U:                      howto manager.      (line 1869)
13413* BFD_RELOC_RX_16_OP:                    howto manager.      (line 1865)
13414* BFD_RELOC_RX_24U:                      howto manager.      (line 1870)
13415* BFD_RELOC_RX_24_OP:                    howto manager.      (line 1866)
13416* BFD_RELOC_RX_32_OP:                    howto manager.      (line 1867)
13417* BFD_RELOC_RX_8U:                       howto manager.      (line 1868)
13418* BFD_RELOC_RX_ABS16:                    howto manager.      (line 1880)
13419* BFD_RELOC_RX_ABS16U:                   howto manager.      (line 1884)
13420* BFD_RELOC_RX_ABS16UL:                  howto manager.      (line 1886)
13421* BFD_RELOC_RX_ABS16UW:                  howto manager.      (line 1885)
13422* BFD_RELOC_RX_ABS16_REV:                howto manager.      (line 1881)
13423* BFD_RELOC_RX_ABS32:                    howto manager.      (line 1882)
13424* BFD_RELOC_RX_ABS32_REV:                howto manager.      (line 1883)
13425* BFD_RELOC_RX_ABS8:                     howto manager.      (line 1879)
13426* BFD_RELOC_RX_DIFF:                     howto manager.      (line 1872)
13427* BFD_RELOC_RX_DIR3U_PCREL:              howto manager.      (line 1871)
13428* BFD_RELOC_RX_GPRELB:                   howto manager.      (line 1873)
13429* BFD_RELOC_RX_GPRELL:                   howto manager.      (line 1875)
13430* BFD_RELOC_RX_GPRELW:                   howto manager.      (line 1874)
13431* BFD_RELOC_RX_NEG16:                    howto manager.      (line 1862)
13432* BFD_RELOC_RX_NEG24:                    howto manager.      (line 1863)
13433* BFD_RELOC_RX_NEG32:                    howto manager.      (line 1864)
13434* BFD_RELOC_RX_NEG8:                     howto manager.      (line 1861)
13435* BFD_RELOC_RX_OP_NEG:                   howto manager.      (line 1878)
13436* BFD_RELOC_RX_OP_SUBTRACT:              howto manager.      (line 1877)
13437* BFD_RELOC_RX_RELAX:                    howto manager.      (line 1887)
13438* BFD_RELOC_RX_SYM:                      howto manager.      (line 1876)
13439* BFD_RELOC_S12Z_15_PCREL:               howto manager.      (line 2199)
13440* BFD_RELOC_SCORE16_BRANCH:              howto manager.      (line 1990)
13441* BFD_RELOC_SCORE16_JMP:                 howto manager.      (line 1988)
13442* BFD_RELOC_SCORE_BCMP:                  howto manager.      (line 1992)
13443* BFD_RELOC_SCORE_BRANCH:                howto manager.      (line 1982)
13444* BFD_RELOC_SCORE_CALL15:                howto manager.      (line 1996)
13445* BFD_RELOC_SCORE_DUMMY2:                howto manager.      (line 1979)
13446* BFD_RELOC_SCORE_DUMMY_HI16:            howto manager.      (line 1997)
13447* BFD_RELOC_SCORE_GOT15:                 howto manager.      (line 1994)
13448* BFD_RELOC_SCORE_GOT_LO16:              howto manager.      (line 1995)
13449* BFD_RELOC_SCORE_GPREL15:               howto manager.      (line 1977)
13450* BFD_RELOC_SCORE_IMM30:                 howto manager.      (line 1984)
13451* BFD_RELOC_SCORE_IMM32:                 howto manager.      (line 1986)
13452* BFD_RELOC_SCORE_JMP:                   howto manager.      (line 1980)
13453* BFD_RELOC_SH_ALIGN:                    howto manager.      (line  908)
13454* BFD_RELOC_SH_CODE:                     howto manager.      (line  909)
13455* BFD_RELOC_SH_COPY:                     howto manager.      (line  914)
13456* BFD_RELOC_SH_COPY64:                   howto manager.      (line  939)
13457* BFD_RELOC_SH_COUNT:                    howto manager.      (line  907)
13458* BFD_RELOC_SH_DATA:                     howto manager.      (line  910)
13459* BFD_RELOC_SH_DISP12:                   howto manager.      (line  890)
13460* BFD_RELOC_SH_DISP12BY2:                howto manager.      (line  891)
13461* BFD_RELOC_SH_DISP12BY4:                howto manager.      (line  892)
13462* BFD_RELOC_SH_DISP12BY8:                howto manager.      (line  893)
13463* BFD_RELOC_SH_DISP20:                   howto manager.      (line  894)
13464* BFD_RELOC_SH_DISP20BY8:                howto manager.      (line  895)
13465* BFD_RELOC_SH_FUNCDESC:                 howto manager.      (line  982)
13466* BFD_RELOC_SH_GLOB_DAT:                 howto manager.      (line  915)
13467* BFD_RELOC_SH_GLOB_DAT64:               howto manager.      (line  940)
13468* BFD_RELOC_SH_GOT10BY4:                 howto manager.      (line  943)
13469* BFD_RELOC_SH_GOT10BY8:                 howto manager.      (line  944)
13470* BFD_RELOC_SH_GOT20:                    howto manager.      (line  976)
13471* BFD_RELOC_SH_GOTFUNCDESC:              howto manager.      (line  978)
13472* BFD_RELOC_SH_GOTFUNCDESC20:            howto manager.      (line  979)
13473* BFD_RELOC_SH_GOTOFF20:                 howto manager.      (line  977)
13474* BFD_RELOC_SH_GOTOFFFUNCDESC:           howto manager.      (line  980)
13475* BFD_RELOC_SH_GOTOFFFUNCDESC20:         howto manager.      (line  981)
13476* BFD_RELOC_SH_GOTOFF_HI16:              howto manager.      (line  934)
13477* BFD_RELOC_SH_GOTOFF_LOW16:             howto manager.      (line  931)
13478* BFD_RELOC_SH_GOTOFF_MEDHI16:           howto manager.      (line  933)
13479* BFD_RELOC_SH_GOTOFF_MEDLOW16:          howto manager.      (line  932)
13480* BFD_RELOC_SH_GOTPC:                    howto manager.      (line  918)
13481* BFD_RELOC_SH_GOTPC_HI16:               howto manager.      (line  938)
13482* BFD_RELOC_SH_GOTPC_LOW16:              howto manager.      (line  935)
13483* BFD_RELOC_SH_GOTPC_MEDHI16:            howto manager.      (line  937)
13484* BFD_RELOC_SH_GOTPC_MEDLOW16:           howto manager.      (line  936)
13485* BFD_RELOC_SH_GOTPLT10BY4:              howto manager.      (line  945)
13486* BFD_RELOC_SH_GOTPLT10BY8:              howto manager.      (line  946)
13487* BFD_RELOC_SH_GOTPLT32:                 howto manager.      (line  947)
13488* BFD_RELOC_SH_GOTPLT_HI16:              howto manager.      (line  926)
13489* BFD_RELOC_SH_GOTPLT_LOW16:             howto manager.      (line  923)
13490* BFD_RELOC_SH_GOTPLT_MEDHI16:           howto manager.      (line  925)
13491* BFD_RELOC_SH_GOTPLT_MEDLOW16:          howto manager.      (line  924)
13492* BFD_RELOC_SH_GOT_HI16:                 howto manager.      (line  922)
13493* BFD_RELOC_SH_GOT_LOW16:                howto manager.      (line  919)
13494* BFD_RELOC_SH_GOT_MEDHI16:              howto manager.      (line  921)
13495* BFD_RELOC_SH_GOT_MEDLOW16:             howto manager.      (line  920)
13496* BFD_RELOC_SH_IMM3:                     howto manager.      (line  888)
13497* BFD_RELOC_SH_IMM3U:                    howto manager.      (line  889)
13498* BFD_RELOC_SH_IMM4:                     howto manager.      (line  896)
13499* BFD_RELOC_SH_IMM4BY2:                  howto manager.      (line  897)
13500* BFD_RELOC_SH_IMM4BY4:                  howto manager.      (line  898)
13501* BFD_RELOC_SH_IMM8:                     howto manager.      (line  899)
13502* BFD_RELOC_SH_IMM8BY2:                  howto manager.      (line  900)
13503* BFD_RELOC_SH_IMM8BY4:                  howto manager.      (line  901)
13504* BFD_RELOC_SH_IMMS10:                   howto manager.      (line  953)
13505* BFD_RELOC_SH_IMMS10BY2:                howto manager.      (line  954)
13506* BFD_RELOC_SH_IMMS10BY4:                howto manager.      (line  955)
13507* BFD_RELOC_SH_IMMS10BY8:                howto manager.      (line  956)
13508* BFD_RELOC_SH_IMMS16:                   howto manager.      (line  957)
13509* BFD_RELOC_SH_IMMS6:                    howto manager.      (line  950)
13510* BFD_RELOC_SH_IMMS6BY32:                howto manager.      (line  951)
13511* BFD_RELOC_SH_IMMU16:                   howto manager.      (line  958)
13512* BFD_RELOC_SH_IMMU5:                    howto manager.      (line  949)
13513* BFD_RELOC_SH_IMMU6:                    howto manager.      (line  952)
13514* BFD_RELOC_SH_IMM_HI16:                 howto manager.      (line  965)
13515* BFD_RELOC_SH_IMM_HI16_PCREL:           howto manager.      (line  966)
13516* BFD_RELOC_SH_IMM_LOW16:                howto manager.      (line  959)
13517* BFD_RELOC_SH_IMM_LOW16_PCREL:          howto manager.      (line  960)
13518* BFD_RELOC_SH_IMM_MEDHI16:              howto manager.      (line  963)
13519* BFD_RELOC_SH_IMM_MEDHI16_PCREL:        howto manager.      (line  964)
13520* BFD_RELOC_SH_IMM_MEDLOW16:             howto manager.      (line  961)
13521* BFD_RELOC_SH_IMM_MEDLOW16_PCREL:       howto manager.      (line  962)
13522* BFD_RELOC_SH_JMP_SLOT:                 howto manager.      (line  916)
13523* BFD_RELOC_SH_JMP_SLOT64:               howto manager.      (line  941)
13524* BFD_RELOC_SH_LABEL:                    howto manager.      (line  911)
13525* BFD_RELOC_SH_LOOP_END:                 howto manager.      (line  913)
13526* BFD_RELOC_SH_LOOP_START:               howto manager.      (line  912)
13527* BFD_RELOC_SH_PCDISP12BY2:              howto manager.      (line  887)
13528* BFD_RELOC_SH_PCDISP8BY2:               howto manager.      (line  886)
13529* BFD_RELOC_SH_PCRELIMM8BY2:             howto manager.      (line  902)
13530* BFD_RELOC_SH_PCRELIMM8BY4:             howto manager.      (line  903)
13531* BFD_RELOC_SH_PLT_HI16:                 howto manager.      (line  930)
13532* BFD_RELOC_SH_PLT_LOW16:                howto manager.      (line  927)
13533* BFD_RELOC_SH_PLT_MEDHI16:              howto manager.      (line  929)
13534* BFD_RELOC_SH_PLT_MEDLOW16:             howto manager.      (line  928)
13535* BFD_RELOC_SH_PT_16:                    howto manager.      (line  967)
13536* BFD_RELOC_SH_RELATIVE:                 howto manager.      (line  917)
13537* BFD_RELOC_SH_RELATIVE64:               howto manager.      (line  942)
13538* BFD_RELOC_SH_SHMEDIA_CODE:             howto manager.      (line  948)
13539* BFD_RELOC_SH_SWITCH16:                 howto manager.      (line  904)
13540* BFD_RELOC_SH_SWITCH32:                 howto manager.      (line  905)
13541* BFD_RELOC_SH_TLS_DTPMOD32:             howto manager.      (line  973)
13542* BFD_RELOC_SH_TLS_DTPOFF32:             howto manager.      (line  974)
13543* BFD_RELOC_SH_TLS_GD_32:                howto manager.      (line  968)
13544* BFD_RELOC_SH_TLS_IE_32:                howto manager.      (line  971)
13545* BFD_RELOC_SH_TLS_LDO_32:               howto manager.      (line  970)
13546* BFD_RELOC_SH_TLS_LD_32:                howto manager.      (line  969)
13547* BFD_RELOC_SH_TLS_LE_32:                howto manager.      (line  972)
13548* BFD_RELOC_SH_TLS_TPOFF32:              howto manager.      (line  975)
13549* BFD_RELOC_SH_USES:                     howto manager.      (line  906)
13550* BFD_RELOC_SIZE32:                      howto manager.      (line   67)
13551* BFD_RELOC_SIZE64:                      howto manager.      (line   68)
13552* BFD_RELOC_SPARC13:                     howto manager.      (line  121)
13553* BFD_RELOC_SPARC22:                     howto manager.      (line  120)
13554* BFD_RELOC_SPARC_10:                    howto manager.      (line  148)
13555* BFD_RELOC_SPARC_11:                    howto manager.      (line  149)
13556* BFD_RELOC_SPARC_5:                     howto manager.      (line  161)
13557* BFD_RELOC_SPARC_6:                     howto manager.      (line  160)
13558* BFD_RELOC_SPARC_64:                    howto manager.      (line  147)
13559* BFD_RELOC_SPARC_7:                     howto manager.      (line  159)
13560* BFD_RELOC_SPARC_BASE13:                howto manager.      (line  144)
13561* BFD_RELOC_SPARC_BASE22:                howto manager.      (line  145)
13562* BFD_RELOC_SPARC_COPY:                  howto manager.      (line  128)
13563* BFD_RELOC_SPARC_DISP64:                howto manager.      (line  162)
13564* BFD_RELOC_SPARC_GLOB_DAT:              howto manager.      (line  129)
13565* BFD_RELOC_SPARC_GOT10:                 howto manager.      (line  122)
13566* BFD_RELOC_SPARC_GOT13:                 howto manager.      (line  123)
13567* BFD_RELOC_SPARC_GOT22:                 howto manager.      (line  124)
13568* BFD_RELOC_SPARC_GOTDATA_HIX22:         howto manager.      (line  135)
13569* BFD_RELOC_SPARC_GOTDATA_LOX10:         howto manager.      (line  136)
13570* BFD_RELOC_SPARC_GOTDATA_OP:            howto manager.      (line  139)
13571* BFD_RELOC_SPARC_GOTDATA_OP_HIX22:      howto manager.      (line  137)
13572* BFD_RELOC_SPARC_GOTDATA_OP_LOX10:      howto manager.      (line  138)
13573* BFD_RELOC_SPARC_H34:                   howto manager.      (line  171)
13574* BFD_RELOC_SPARC_H44:                   howto manager.      (line  167)
13575* BFD_RELOC_SPARC_HH22:                  howto manager.      (line  151)
13576* BFD_RELOC_SPARC_HIX22:                 howto manager.      (line  165)
13577* BFD_RELOC_SPARC_HM10:                  howto manager.      (line  152)
13578* BFD_RELOC_SPARC_IRELATIVE:             howto manager.      (line  141)
13579* BFD_RELOC_SPARC_JMP_IREL:              howto manager.      (line  140)
13580* BFD_RELOC_SPARC_JMP_SLOT:              howto manager.      (line  130)
13581* BFD_RELOC_SPARC_L44:                   howto manager.      (line  169)
13582* BFD_RELOC_SPARC_LM22:                  howto manager.      (line  153)
13583* BFD_RELOC_SPARC_LOX10:                 howto manager.      (line  166)
13584* BFD_RELOC_SPARC_M44:                   howto manager.      (line  168)
13585* BFD_RELOC_SPARC_OLO10:                 howto manager.      (line  150)
13586* BFD_RELOC_SPARC_PC10:                  howto manager.      (line  125)
13587* BFD_RELOC_SPARC_PC22:                  howto manager.      (line  126)
13588* BFD_RELOC_SPARC_PC_HH22:               howto manager.      (line  154)
13589* BFD_RELOC_SPARC_PC_HM10:               howto manager.      (line  155)
13590* BFD_RELOC_SPARC_PC_LM22:               howto manager.      (line  156)
13591* BFD_RELOC_SPARC_PLT32:                 howto manager.      (line  163)
13592* BFD_RELOC_SPARC_PLT64:                 howto manager.      (line  164)
13593* BFD_RELOC_SPARC_REGISTER:              howto manager.      (line  170)
13594* BFD_RELOC_SPARC_RELATIVE:              howto manager.      (line  131)
13595* BFD_RELOC_SPARC_REV32:                 howto manager.      (line  176)
13596* BFD_RELOC_SPARC_SIZE32:                howto manager.      (line  172)
13597* BFD_RELOC_SPARC_SIZE64:                howto manager.      (line  173)
13598* BFD_RELOC_SPARC_TLS_DTPMOD32:          howto manager.      (line  196)
13599* BFD_RELOC_SPARC_TLS_DTPMOD64:          howto manager.      (line  197)
13600* BFD_RELOC_SPARC_TLS_DTPOFF32:          howto manager.      (line  198)
13601* BFD_RELOC_SPARC_TLS_DTPOFF64:          howto manager.      (line  199)
13602* BFD_RELOC_SPARC_TLS_GD_ADD:            howto manager.      (line  180)
13603* BFD_RELOC_SPARC_TLS_GD_CALL:           howto manager.      (line  181)
13604* BFD_RELOC_SPARC_TLS_GD_HI22:           howto manager.      (line  178)
13605* BFD_RELOC_SPARC_TLS_GD_LO10:           howto manager.      (line  179)
13606* BFD_RELOC_SPARC_TLS_IE_ADD:            howto manager.      (line  193)
13607* BFD_RELOC_SPARC_TLS_IE_HI22:           howto manager.      (line  189)
13608* BFD_RELOC_SPARC_TLS_IE_LD:             howto manager.      (line  191)
13609* BFD_RELOC_SPARC_TLS_IE_LDX:            howto manager.      (line  192)
13610* BFD_RELOC_SPARC_TLS_IE_LO10:           howto manager.      (line  190)
13611* BFD_RELOC_SPARC_TLS_LDM_ADD:           howto manager.      (line  184)
13612* BFD_RELOC_SPARC_TLS_LDM_CALL:          howto manager.      (line  185)
13613* BFD_RELOC_SPARC_TLS_LDM_HI22:          howto manager.      (line  182)
13614* BFD_RELOC_SPARC_TLS_LDM_LO10:          howto manager.      (line  183)
13615* BFD_RELOC_SPARC_TLS_LDO_ADD:           howto manager.      (line  188)
13616* BFD_RELOC_SPARC_TLS_LDO_HIX22:         howto manager.      (line  186)
13617* BFD_RELOC_SPARC_TLS_LDO_LOX10:         howto manager.      (line  187)
13618* BFD_RELOC_SPARC_TLS_LE_HIX22:          howto manager.      (line  194)
13619* BFD_RELOC_SPARC_TLS_LE_LOX10:          howto manager.      (line  195)
13620* BFD_RELOC_SPARC_TLS_TPOFF32:           howto manager.      (line  200)
13621* BFD_RELOC_SPARC_TLS_TPOFF64:           howto manager.      (line  201)
13622* BFD_RELOC_SPARC_UA16:                  howto manager.      (line  132)
13623* BFD_RELOC_SPARC_UA32:                  howto manager.      (line  133)
13624* BFD_RELOC_SPARC_UA64:                  howto manager.      (line  134)
13625* BFD_RELOC_SPARC_WDISP10:               howto manager.      (line  174)
13626* BFD_RELOC_SPARC_WDISP16:               howto manager.      (line  157)
13627* BFD_RELOC_SPARC_WDISP19:               howto manager.      (line  158)
13628* BFD_RELOC_SPARC_WDISP22:               howto manager.      (line  119)
13629* BFD_RELOC_SPARC_WPLT30:                howto manager.      (line  127)
13630* BFD_RELOC_SPU_ADD_PIC:                 howto manager.      (line  217)
13631* BFD_RELOC_SPU_HI16:                    howto manager.      (line  214)
13632* BFD_RELOC_SPU_IMM10:                   howto manager.      (line  205)
13633* BFD_RELOC_SPU_IMM10W:                  howto manager.      (line  206)
13634* BFD_RELOC_SPU_IMM16:                   howto manager.      (line  207)
13635* BFD_RELOC_SPU_IMM16W:                  howto manager.      (line  208)
13636* BFD_RELOC_SPU_IMM18:                   howto manager.      (line  209)
13637* BFD_RELOC_SPU_IMM7:                    howto manager.      (line  203)
13638* BFD_RELOC_SPU_IMM8:                    howto manager.      (line  204)
13639* BFD_RELOC_SPU_LO16:                    howto manager.      (line  213)
13640* BFD_RELOC_SPU_PCREL16:                 howto manager.      (line  212)
13641* BFD_RELOC_SPU_PCREL9a:                 howto manager.      (line  210)
13642* BFD_RELOC_SPU_PCREL9b:                 howto manager.      (line  211)
13643* BFD_RELOC_SPU_PPU32:                   howto manager.      (line  215)
13644* BFD_RELOC_SPU_PPU64:                   howto manager.      (line  216)
13645* BFD_RELOC_THUMB_PCREL_BLX:             howto manager.      (line  740)
13646* BFD_RELOC_THUMB_PCREL_BRANCH12:        howto manager.      (line  751)
13647* BFD_RELOC_THUMB_PCREL_BRANCH20:        howto manager.      (line  752)
13648* BFD_RELOC_THUMB_PCREL_BRANCH23:        howto manager.      (line  753)
13649* BFD_RELOC_THUMB_PCREL_BRANCH25:        howto manager.      (line  754)
13650* BFD_RELOC_THUMB_PCREL_BRANCH7:         howto manager.      (line  749)
13651* BFD_RELOC_THUMB_PCREL_BRANCH9:         howto manager.      (line  750)
13652* BFD_RELOC_TIC30_LDP:                   howto manager.      (line 1488)
13653* BFD_RELOC_TIC54X_16_OF_23:             howto manager.      (line 1502)
13654* BFD_RELOC_TIC54X_23:                   howto manager.      (line 1500)
13655* BFD_RELOC_TIC54X_MS7_OF_23:            howto manager.      (line 1506)
13656* BFD_RELOC_TIC54X_PARTLS7:              howto manager.      (line 1492)
13657* BFD_RELOC_TIC54X_PARTMS9:              howto manager.      (line 1496)
13658* BFD_RELOC_TILEGX_BROFF_X1:             howto manager.      (line 3163)
13659* BFD_RELOC_TILEGX_COPY:                 howto manager.      (line 3159)
13660* BFD_RELOC_TILEGX_DEST_IMM8_X1:         howto manager.      (line 3170)
13661* BFD_RELOC_TILEGX_GLOB_DAT:             howto manager.      (line 3160)
13662* BFD_RELOC_TILEGX_HW0:                  howto manager.      (line 3152)
13663* BFD_RELOC_TILEGX_HW0_LAST:             howto manager.      (line 3156)
13664* BFD_RELOC_TILEGX_HW1:                  howto manager.      (line 3153)
13665* BFD_RELOC_TILEGX_HW1_LAST:             howto manager.      (line 3157)
13666* BFD_RELOC_TILEGX_HW2:                  howto manager.      (line 3154)
13667* BFD_RELOC_TILEGX_HW2_LAST:             howto manager.      (line 3158)
13668* BFD_RELOC_TILEGX_HW3:                  howto manager.      (line 3155)
13669* BFD_RELOC_TILEGX_IMM16_X0_HW0:         howto manager.      (line 3179)
13670* BFD_RELOC_TILEGX_IMM16_X0_HW0_GOT:     howto manager.      (line 3207)
13671* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST:    howto manager.      (line 3187)
13672* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_GOT: howto manager.     (line 3215)
13673* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PCREL: howto manager.   (line 3201)
13674* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_PLT_PCREL: howto manager.
13675                                                             (line 3235)
13676* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_GD: howto manager.  (line 3229)
13677* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_IE: howto manager.  (line 3241)
13678* BFD_RELOC_TILEGX_IMM16_X0_HW0_LAST_TLS_LE: howto manager.  (line 3225)
13679* BFD_RELOC_TILEGX_IMM16_X0_HW0_PCREL:   howto manager.      (line 3193)
13680* BFD_RELOC_TILEGX_IMM16_X0_HW0_PLT_PCREL: howto manager.    (line 3209)
13681* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_GD:  howto manager.      (line 3221)
13682* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_IE:  howto manager.      (line 3233)
13683* BFD_RELOC_TILEGX_IMM16_X0_HW0_TLS_LE:  howto manager.      (line 3223)
13684* BFD_RELOC_TILEGX_IMM16_X0_HW1:         howto manager.      (line 3181)
13685* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST:    howto manager.      (line 3189)
13686* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_GOT: howto manager.     (line 3217)
13687* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PCREL: howto manager.   (line 3203)
13688* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_PLT_PCREL: howto manager.
13689                                                             (line 3237)
13690* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_GD: howto manager.  (line 3231)
13691* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_IE: howto manager.  (line 3243)
13692* BFD_RELOC_TILEGX_IMM16_X0_HW1_LAST_TLS_LE: howto manager.  (line 3227)
13693* BFD_RELOC_TILEGX_IMM16_X0_HW1_PCREL:   howto manager.      (line 3195)
13694* BFD_RELOC_TILEGX_IMM16_X0_HW1_PLT_PCREL: howto manager.    (line 3211)
13695* BFD_RELOC_TILEGX_IMM16_X0_HW2:         howto manager.      (line 3183)
13696* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST:    howto manager.      (line 3191)
13697* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PCREL: howto manager.   (line 3205)
13698* BFD_RELOC_TILEGX_IMM16_X0_HW2_LAST_PLT_PCREL: howto manager.
13699                                                             (line 3239)
13700* BFD_RELOC_TILEGX_IMM16_X0_HW2_PCREL:   howto manager.      (line 3197)
13701* BFD_RELOC_TILEGX_IMM16_X0_HW2_PLT_PCREL: howto manager.    (line 3213)
13702* BFD_RELOC_TILEGX_IMM16_X0_HW3:         howto manager.      (line 3185)
13703* BFD_RELOC_TILEGX_IMM16_X0_HW3_PCREL:   howto manager.      (line 3199)
13704* BFD_RELOC_TILEGX_IMM16_X0_HW3_PLT_PCREL: howto manager.    (line 3219)
13705* BFD_RELOC_TILEGX_IMM16_X1_HW0:         howto manager.      (line 3180)
13706* BFD_RELOC_TILEGX_IMM16_X1_HW0_GOT:     howto manager.      (line 3208)
13707* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST:    howto manager.      (line 3188)
13708* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_GOT: howto manager.     (line 3216)
13709* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PCREL: howto manager.   (line 3202)
13710* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_PLT_PCREL: howto manager.
13711                                                             (line 3236)
13712* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_GD: howto manager.  (line 3230)
13713* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_IE: howto manager.  (line 3242)
13714* BFD_RELOC_TILEGX_IMM16_X1_HW0_LAST_TLS_LE: howto manager.  (line 3226)
13715* BFD_RELOC_TILEGX_IMM16_X1_HW0_PCREL:   howto manager.      (line 3194)
13716* BFD_RELOC_TILEGX_IMM16_X1_HW0_PLT_PCREL: howto manager.    (line 3210)
13717* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_GD:  howto manager.      (line 3222)
13718* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_IE:  howto manager.      (line 3234)
13719* BFD_RELOC_TILEGX_IMM16_X1_HW0_TLS_LE:  howto manager.      (line 3224)
13720* BFD_RELOC_TILEGX_IMM16_X1_HW1:         howto manager.      (line 3182)
13721* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST:    howto manager.      (line 3190)
13722* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_GOT: howto manager.     (line 3218)
13723* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PCREL: howto manager.   (line 3204)
13724* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_PLT_PCREL: howto manager.
13725                                                             (line 3238)
13726* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_GD: howto manager.  (line 3232)
13727* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_IE: howto manager.  (line 3244)
13728* BFD_RELOC_TILEGX_IMM16_X1_HW1_LAST_TLS_LE: howto manager.  (line 3228)
13729* BFD_RELOC_TILEGX_IMM16_X1_HW1_PCREL:   howto manager.      (line 3196)
13730* BFD_RELOC_TILEGX_IMM16_X1_HW1_PLT_PCREL: howto manager.    (line 3212)
13731* BFD_RELOC_TILEGX_IMM16_X1_HW2:         howto manager.      (line 3184)
13732* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST:    howto manager.      (line 3192)
13733* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PCREL: howto manager.   (line 3206)
13734* BFD_RELOC_TILEGX_IMM16_X1_HW2_LAST_PLT_PCREL: howto manager.
13735                                                             (line 3240)
13736* BFD_RELOC_TILEGX_IMM16_X1_HW2_PCREL:   howto manager.      (line 3198)
13737* BFD_RELOC_TILEGX_IMM16_X1_HW2_PLT_PCREL: howto manager.    (line 3214)
13738* BFD_RELOC_TILEGX_IMM16_X1_HW3:         howto manager.      (line 3186)
13739* BFD_RELOC_TILEGX_IMM16_X1_HW3_PCREL:   howto manager.      (line 3200)
13740* BFD_RELOC_TILEGX_IMM16_X1_HW3_PLT_PCREL: howto manager.    (line 3220)
13741* BFD_RELOC_TILEGX_IMM8_X0:              howto manager.      (line 3166)
13742* BFD_RELOC_TILEGX_IMM8_X0_TLS_ADD:      howto manager.      (line 3257)
13743* BFD_RELOC_TILEGX_IMM8_X0_TLS_GD_ADD:   howto manager.      (line 3252)
13744* BFD_RELOC_TILEGX_IMM8_X1:              howto manager.      (line 3168)
13745* BFD_RELOC_TILEGX_IMM8_X1_TLS_ADD:      howto manager.      (line 3258)
13746* BFD_RELOC_TILEGX_IMM8_X1_TLS_GD_ADD:   howto manager.      (line 3253)
13747* BFD_RELOC_TILEGX_IMM8_Y0:              howto manager.      (line 3167)
13748* BFD_RELOC_TILEGX_IMM8_Y0_TLS_ADD:      howto manager.      (line 3259)
13749* BFD_RELOC_TILEGX_IMM8_Y0_TLS_GD_ADD:   howto manager.      (line 3254)
13750* BFD_RELOC_TILEGX_IMM8_Y1:              howto manager.      (line 3169)
13751* BFD_RELOC_TILEGX_IMM8_Y1_TLS_ADD:      howto manager.      (line 3260)
13752* BFD_RELOC_TILEGX_IMM8_Y1_TLS_GD_ADD:   howto manager.      (line 3255)
13753* BFD_RELOC_TILEGX_JMP_SLOT:             howto manager.      (line 3161)
13754* BFD_RELOC_TILEGX_JUMPOFF_X1:           howto manager.      (line 3164)
13755* BFD_RELOC_TILEGX_JUMPOFF_X1_PLT:       howto manager.      (line 3165)
13756* BFD_RELOC_TILEGX_MF_IMM14_X1:          howto manager.      (line 3172)
13757* BFD_RELOC_TILEGX_MMEND_X0:             howto manager.      (line 3174)
13758* BFD_RELOC_TILEGX_MMSTART_X0:           howto manager.      (line 3173)
13759* BFD_RELOC_TILEGX_MT_IMM14_X1:          howto manager.      (line 3171)
13760* BFD_RELOC_TILEGX_RELATIVE:             howto manager.      (line 3162)
13761* BFD_RELOC_TILEGX_SHAMT_X0:             howto manager.      (line 3175)
13762* BFD_RELOC_TILEGX_SHAMT_X1:             howto manager.      (line 3176)
13763* BFD_RELOC_TILEGX_SHAMT_Y0:             howto manager.      (line 3177)
13764* BFD_RELOC_TILEGX_SHAMT_Y1:             howto manager.      (line 3178)
13765* BFD_RELOC_TILEGX_TLS_DTPMOD32:         howto manager.      (line 3248)
13766* BFD_RELOC_TILEGX_TLS_DTPMOD64:         howto manager.      (line 3245)
13767* BFD_RELOC_TILEGX_TLS_DTPOFF32:         howto manager.      (line 3249)
13768* BFD_RELOC_TILEGX_TLS_DTPOFF64:         howto manager.      (line 3246)
13769* BFD_RELOC_TILEGX_TLS_GD_CALL:          howto manager.      (line 3251)
13770* BFD_RELOC_TILEGX_TLS_IE_LOAD:          howto manager.      (line 3256)
13771* BFD_RELOC_TILEGX_TLS_TPOFF32:          howto manager.      (line 3250)
13772* BFD_RELOC_TILEGX_TLS_TPOFF64:          howto manager.      (line 3247)
13773* BFD_RELOC_TILEPRO_BROFF_X1:            howto manager.      (line 3076)
13774* BFD_RELOC_TILEPRO_COPY:                howto manager.      (line 3072)
13775* BFD_RELOC_TILEPRO_DEST_IMM8_X1:        howto manager.      (line 3083)
13776* BFD_RELOC_TILEPRO_GLOB_DAT:            howto manager.      (line 3073)
13777* BFD_RELOC_TILEPRO_IMM16_X0:            howto manager.      (line 3086)
13778* BFD_RELOC_TILEPRO_IMM16_X0_GOT:        howto manager.      (line 3102)
13779* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HA:     howto manager.      (line 3108)
13780* BFD_RELOC_TILEPRO_IMM16_X0_GOT_HI:     howto manager.      (line 3106)
13781* BFD_RELOC_TILEPRO_IMM16_X0_GOT_LO:     howto manager.      (line 3104)
13782* BFD_RELOC_TILEPRO_IMM16_X0_HA:         howto manager.      (line 3092)
13783* BFD_RELOC_TILEPRO_IMM16_X0_HA_PCREL:   howto manager.      (line 3100)
13784* BFD_RELOC_TILEPRO_IMM16_X0_HI:         howto manager.      (line 3090)
13785* BFD_RELOC_TILEPRO_IMM16_X0_HI_PCREL:   howto manager.      (line 3098)
13786* BFD_RELOC_TILEPRO_IMM16_X0_LO:         howto manager.      (line 3088)
13787* BFD_RELOC_TILEPRO_IMM16_X0_LO_PCREL:   howto manager.      (line 3096)
13788* BFD_RELOC_TILEPRO_IMM16_X0_PCREL:      howto manager.      (line 3094)
13789* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD:     howto manager.      (line 3124)
13790* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HA:  howto manager.      (line 3130)
13791* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_HI:  howto manager.      (line 3128)
13792* BFD_RELOC_TILEPRO_IMM16_X0_TLS_GD_LO:  howto manager.      (line 3126)
13793* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE:     howto manager.      (line 3132)
13794* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HA:  howto manager.      (line 3138)
13795* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_HI:  howto manager.      (line 3136)
13796* BFD_RELOC_TILEPRO_IMM16_X0_TLS_IE_LO:  howto manager.      (line 3134)
13797* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE:     howto manager.      (line 3143)
13798* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HA:  howto manager.      (line 3149)
13799* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_HI:  howto manager.      (line 3147)
13800* BFD_RELOC_TILEPRO_IMM16_X0_TLS_LE_LO:  howto manager.      (line 3145)
13801* BFD_RELOC_TILEPRO_IMM16_X1:            howto manager.      (line 3087)
13802* BFD_RELOC_TILEPRO_IMM16_X1_GOT:        howto manager.      (line 3103)
13803* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HA:     howto manager.      (line 3109)
13804* BFD_RELOC_TILEPRO_IMM16_X1_GOT_HI:     howto manager.      (line 3107)
13805* BFD_RELOC_TILEPRO_IMM16_X1_GOT_LO:     howto manager.      (line 3105)
13806* BFD_RELOC_TILEPRO_IMM16_X1_HA:         howto manager.      (line 3093)
13807* BFD_RELOC_TILEPRO_IMM16_X1_HA_PCREL:   howto manager.      (line 3101)
13808* BFD_RELOC_TILEPRO_IMM16_X1_HI:         howto manager.      (line 3091)
13809* BFD_RELOC_TILEPRO_IMM16_X1_HI_PCREL:   howto manager.      (line 3099)
13810* BFD_RELOC_TILEPRO_IMM16_X1_LO:         howto manager.      (line 3089)
13811* BFD_RELOC_TILEPRO_IMM16_X1_LO_PCREL:   howto manager.      (line 3097)
13812* BFD_RELOC_TILEPRO_IMM16_X1_PCREL:      howto manager.      (line 3095)
13813* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD:     howto manager.      (line 3125)
13814* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HA:  howto manager.      (line 3131)
13815* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_HI:  howto manager.      (line 3129)
13816* BFD_RELOC_TILEPRO_IMM16_X1_TLS_GD_LO:  howto manager.      (line 3127)
13817* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE:     howto manager.      (line 3133)
13818* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HA:  howto manager.      (line 3139)
13819* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_HI:  howto manager.      (line 3137)
13820* BFD_RELOC_TILEPRO_IMM16_X1_TLS_IE_LO:  howto manager.      (line 3135)
13821* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE:     howto manager.      (line 3144)
13822* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HA:  howto manager.      (line 3150)
13823* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_HI:  howto manager.      (line 3148)
13824* BFD_RELOC_TILEPRO_IMM16_X1_TLS_LE_LO:  howto manager.      (line 3146)
13825* BFD_RELOC_TILEPRO_IMM8_X0:             howto manager.      (line 3079)
13826* BFD_RELOC_TILEPRO_IMM8_X0_TLS_GD_ADD:  howto manager.      (line 3119)
13827* BFD_RELOC_TILEPRO_IMM8_X1:             howto manager.      (line 3081)
13828* BFD_RELOC_TILEPRO_IMM8_X1_TLS_GD_ADD:  howto manager.      (line 3120)
13829* BFD_RELOC_TILEPRO_IMM8_Y0:             howto manager.      (line 3080)
13830* BFD_RELOC_TILEPRO_IMM8_Y0_TLS_GD_ADD:  howto manager.      (line 3121)
13831* BFD_RELOC_TILEPRO_IMM8_Y1:             howto manager.      (line 3082)
13832* BFD_RELOC_TILEPRO_IMM8_Y1_TLS_GD_ADD:  howto manager.      (line 3122)
13833* BFD_RELOC_TILEPRO_JMP_SLOT:            howto manager.      (line 3074)
13834* BFD_RELOC_TILEPRO_JOFFLONG_X1:         howto manager.      (line 3077)
13835* BFD_RELOC_TILEPRO_JOFFLONG_X1_PLT:     howto manager.      (line 3078)
13836* BFD_RELOC_TILEPRO_MF_IMM15_X1:         howto manager.      (line 3085)
13837* BFD_RELOC_TILEPRO_MMEND_X0:            howto manager.      (line 3111)
13838* BFD_RELOC_TILEPRO_MMEND_X1:            howto manager.      (line 3113)
13839* BFD_RELOC_TILEPRO_MMSTART_X0:          howto manager.      (line 3110)
13840* BFD_RELOC_TILEPRO_MMSTART_X1:          howto manager.      (line 3112)
13841* BFD_RELOC_TILEPRO_MT_IMM15_X1:         howto manager.      (line 3084)
13842* BFD_RELOC_TILEPRO_RELATIVE:            howto manager.      (line 3075)
13843* BFD_RELOC_TILEPRO_SHAMT_X0:            howto manager.      (line 3114)
13844* BFD_RELOC_TILEPRO_SHAMT_X1:            howto manager.      (line 3115)
13845* BFD_RELOC_TILEPRO_SHAMT_Y0:            howto manager.      (line 3116)
13846* BFD_RELOC_TILEPRO_SHAMT_Y1:            howto manager.      (line 3117)
13847* BFD_RELOC_TILEPRO_TLS_DTPMOD32:        howto manager.      (line 3140)
13848* BFD_RELOC_TILEPRO_TLS_DTPOFF32:        howto manager.      (line 3141)
13849* BFD_RELOC_TILEPRO_TLS_GD_CALL:         howto manager.      (line 3118)
13850* BFD_RELOC_TILEPRO_TLS_IE_LOAD:         howto manager.      (line 3123)
13851* BFD_RELOC_TILEPRO_TLS_TPOFF32:         howto manager.      (line 3142)
13852* bfd_reloc_type_lookup:                 howto manager.      (line 3298)
13853* BFD_RELOC_V850_16_GOT:                 howto manager.      (line 1464)
13854* BFD_RELOC_V850_16_GOTOFF:              howto manager.      (line 1480)
13855* BFD_RELOC_V850_16_PCREL:               howto manager.      (line 1444)
13856* BFD_RELOC_V850_16_S1:                  howto manager.      (line 1456)
13857* BFD_RELOC_V850_16_SPLIT_OFFSET:        howto manager.      (line 1454)
13858* BFD_RELOC_V850_17_PCREL:               howto manager.      (line 1446)
13859* BFD_RELOC_V850_22_PCREL:               howto manager.      (line 1398)
13860* BFD_RELOC_V850_22_PLT_PCREL:           howto manager.      (line 1468)
13861* BFD_RELOC_V850_23:                     howto manager.      (line 1448)
13862* BFD_RELOC_V850_32_ABS:                 howto manager.      (line 1452)
13863* BFD_RELOC_V850_32_GOT:                 howto manager.      (line 1466)
13864* BFD_RELOC_V850_32_GOTOFF:              howto manager.      (line 1482)
13865* BFD_RELOC_V850_32_GOTPCREL:            howto manager.      (line 1462)
13866* BFD_RELOC_V850_32_PCREL:               howto manager.      (line 1450)
13867* BFD_RELOC_V850_32_PLT_PCREL:           howto manager.      (line 1470)
13868* BFD_RELOC_V850_9_PCREL:                howto manager.      (line 1396)
13869* BFD_RELOC_V850_ALIGN:                  howto manager.      (line 1439)
13870* BFD_RELOC_V850_CALLT_15_16_OFFSET:     howto manager.      (line 1460)
13871* BFD_RELOC_V850_CALLT_16_16_OFFSET:     howto manager.      (line 1433)
13872* BFD_RELOC_V850_CALLT_6_7_OFFSET:       howto manager.      (line 1431)
13873* BFD_RELOC_V850_CODE:                   howto manager.      (line 1484)
13874* BFD_RELOC_V850_COPY:                   howto manager.      (line 1472)
13875* BFD_RELOC_V850_DATA:                   howto manager.      (line 1486)
13876* BFD_RELOC_V850_GLOB_DAT:               howto manager.      (line 1474)
13877* BFD_RELOC_V850_JMP_SLOT:               howto manager.      (line 1476)
13878* BFD_RELOC_V850_LO16_S1:                howto manager.      (line 1458)
13879* BFD_RELOC_V850_LO16_SPLIT_OFFSET:      howto manager.      (line 1441)
13880* BFD_RELOC_V850_LONGCALL:               howto manager.      (line 1435)
13881* BFD_RELOC_V850_LONGJUMP:               howto manager.      (line 1437)
13882* BFD_RELOC_V850_RELATIVE:               howto manager.      (line 1478)
13883* BFD_RELOC_V850_SDA_15_16_OFFSET:       howto manager.      (line 1402)
13884* BFD_RELOC_V850_SDA_16_16_OFFSET:       howto manager.      (line 1400)
13885* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.      (line 1425)
13886* BFD_RELOC_V850_TDA_16_16_OFFSET:       howto manager.      (line 1418)
13887* BFD_RELOC_V850_TDA_4_4_OFFSET:         howto manager.      (line 1423)
13888* BFD_RELOC_V850_TDA_4_5_OFFSET:         howto manager.      (line 1420)
13889* BFD_RELOC_V850_TDA_6_8_OFFSET:         howto manager.      (line 1410)
13890* BFD_RELOC_V850_TDA_7_7_OFFSET:         howto manager.      (line 1416)
13891* BFD_RELOC_V850_TDA_7_8_OFFSET:         howto manager.      (line 1413)
13892* BFD_RELOC_V850_ZDA_15_16_OFFSET:       howto manager.      (line 1407)
13893* BFD_RELOC_V850_ZDA_16_16_OFFSET:       howto manager.      (line 1405)
13894* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.      (line 1428)
13895* BFD_RELOC_VAX_GLOB_DAT:                howto manager.      (line 2388)
13896* BFD_RELOC_VAX_JMP_SLOT:                howto manager.      (line 2389)
13897* BFD_RELOC_VAX_RELATIVE:                howto manager.      (line 2390)
13898* BFD_RELOC_VISIUM_HI16:                 howto manager.      (line 3277)
13899* BFD_RELOC_VISIUM_HI16_PCREL:           howto manager.      (line 3281)
13900* BFD_RELOC_VISIUM_IM16:                 howto manager.      (line 3279)
13901* BFD_RELOC_VISIUM_IM16_PCREL:           howto manager.      (line 3283)
13902* BFD_RELOC_VISIUM_LO16:                 howto manager.      (line 3278)
13903* BFD_RELOC_VISIUM_LO16_PCREL:           howto manager.      (line 3282)
13904* BFD_RELOC_VISIUM_REL16:                howto manager.      (line 3280)
13905* BFD_RELOC_VPE4KMATH_DATA:              howto manager.      (line 2020)
13906* BFD_RELOC_VPE4KMATH_INSN:              howto manager.      (line 2021)
13907* BFD_RELOC_VTABLE_ENTRY:                howto manager.      (line 2024)
13908* BFD_RELOC_VTABLE_INHERIT:              howto manager.      (line 2023)
13909* BFD_RELOC_WASM32_ABS32_CODE:           howto manager.      (line 3290)
13910* BFD_RELOC_WASM32_CODE_POINTER:         howto manager.      (line 3292)
13911* BFD_RELOC_WASM32_COPY:                 howto manager.      (line 3291)
13912* BFD_RELOC_WASM32_INDEX:                howto manager.      (line 3293)
13913* BFD_RELOC_WASM32_LEB128:               howto manager.      (line 3285)
13914* BFD_RELOC_WASM32_LEB128_GOT:           howto manager.      (line 3286)
13915* BFD_RELOC_WASM32_LEB128_GOT_CODE:      howto manager.      (line 3287)
13916* BFD_RELOC_WASM32_LEB128_PLT:           howto manager.      (line 3288)
13917* BFD_RELOC_WASM32_PLT_INDEX:            howto manager.      (line 3289)
13918* BFD_RELOC_WASM32_PLT_SIG:              howto manager.      (line 3294)
13919* BFD_RELOC_X86_64_32S:                  howto manager.      (line  554)
13920* BFD_RELOC_X86_64_COPY:                 howto manager.      (line  549)
13921* BFD_RELOC_X86_64_DTPMOD64:             howto manager.      (line  555)
13922* BFD_RELOC_X86_64_DTPOFF32:             howto manager.      (line  560)
13923* BFD_RELOC_X86_64_DTPOFF64:             howto manager.      (line  556)
13924* BFD_RELOC_X86_64_GLOB_DAT:             howto manager.      (line  550)
13925* BFD_RELOC_X86_64_GOT32:                howto manager.      (line  547)
13926* BFD_RELOC_X86_64_GOT64:                howto manager.      (line  565)
13927* BFD_RELOC_X86_64_GOTOFF64:             howto manager.      (line  563)
13928* BFD_RELOC_X86_64_GOTPC32:              howto manager.      (line  564)
13929* BFD_RELOC_X86_64_GOTPC32_TLSDESC:      howto manager.      (line  570)
13930* BFD_RELOC_X86_64_GOTPC64:              howto manager.      (line  567)
13931* BFD_RELOC_X86_64_GOTPCREL:             howto manager.      (line  553)
13932* BFD_RELOC_X86_64_GOTPCREL64:           howto manager.      (line  566)
13933* BFD_RELOC_X86_64_GOTPCRELX:            howto manager.      (line  576)
13934* BFD_RELOC_X86_64_GOTPLT64:             howto manager.      (line  568)
13935* BFD_RELOC_X86_64_GOTTPOFF:             howto manager.      (line  561)
13936* BFD_RELOC_X86_64_IRELATIVE:            howto manager.      (line  573)
13937* BFD_RELOC_X86_64_JUMP_SLOT:            howto manager.      (line  551)
13938* BFD_RELOC_X86_64_PC32_BND:             howto manager.      (line  574)
13939* BFD_RELOC_X86_64_PLT32:                howto manager.      (line  548)
13940* BFD_RELOC_X86_64_PLT32_BND:            howto manager.      (line  575)
13941* BFD_RELOC_X86_64_PLTOFF64:             howto manager.      (line  569)
13942* BFD_RELOC_X86_64_RELATIVE:             howto manager.      (line  552)
13943* BFD_RELOC_X86_64_REX_GOTPCRELX:        howto manager.      (line  577)
13944* BFD_RELOC_X86_64_TLSDESC:              howto manager.      (line  572)
13945* BFD_RELOC_X86_64_TLSDESC_CALL:         howto manager.      (line  571)
13946* BFD_RELOC_X86_64_TLSGD:                howto manager.      (line  558)
13947* BFD_RELOC_X86_64_TLSLD:                howto manager.      (line  559)
13948* BFD_RELOC_X86_64_TPOFF32:              howto manager.      (line  562)
13949* BFD_RELOC_X86_64_TPOFF64:              howto manager.      (line  557)
13950* BFD_RELOC_XC16X_PAG:                   howto manager.      (line 2383)
13951* BFD_RELOC_XC16X_POF:                   howto manager.      (line 2384)
13952* BFD_RELOC_XC16X_SEG:                   howto manager.      (line 2385)
13953* BFD_RELOC_XC16X_SOF:                   howto manager.      (line 2386)
13954* BFD_RELOC_XGATE_24:                    howto manager.      (line 2167)
13955* BFD_RELOC_XGATE_GPAGE:                 howto manager.      (line 2165)
13956* BFD_RELOC_XGATE_IMM3:                  howto manager.      (line 2179)
13957* BFD_RELOC_XGATE_IMM4:                  howto manager.      (line 2181)
13958* BFD_RELOC_XGATE_IMM5:                  howto manager.      (line 2183)
13959* BFD_RELOC_XGATE_IMM8_HI:               howto manager.      (line 2176)
13960* BFD_RELOC_XGATE_IMM8_LO:               howto manager.      (line 2173)
13961* BFD_RELOC_XGATE_LO16:                  howto manager.      (line 2162)
13962* BFD_RELOC_XGATE_PCREL_10:              howto manager.      (line 2171)
13963* BFD_RELOC_XGATE_PCREL_9:               howto manager.      (line 2169)
13964* BFD_RELOC_XGATE_RL_GROUP:              howto manager.      (line 2158)
13965* BFD_RELOC_XGATE_RL_JUMP:               howto manager.      (line 2155)
13966* BFD_RELOC_XSTORMY16_12:                howto manager.      (line 2377)
13967* BFD_RELOC_XSTORMY16_24:                howto manager.      (line 2378)
13968* BFD_RELOC_XSTORMY16_FPTR16:            howto manager.      (line 2379)
13969* BFD_RELOC_XSTORMY16_REL_12:            howto manager.      (line 2376)
13970* BFD_RELOC_XTENSA_ASM_EXPAND:           howto manager.      (line 2574)
13971* BFD_RELOC_XTENSA_ASM_SIMPLIFY:         howto manager.      (line 2578)
13972* BFD_RELOC_XTENSA_DIFF16:               howto manager.      (line 2525)
13973* BFD_RELOC_XTENSA_DIFF32:               howto manager.      (line 2526)
13974* BFD_RELOC_XTENSA_DIFF8:                howto manager.      (line 2524)
13975* BFD_RELOC_XTENSA_GLOB_DAT:             howto manager.      (line 2516)
13976* BFD_RELOC_XTENSA_JMP_SLOT:             howto manager.      (line 2517)
13977* BFD_RELOC_XTENSA_OP0:                  howto manager.      (line 2569)
13978* BFD_RELOC_XTENSA_OP1:                  howto manager.      (line 2570)
13979* BFD_RELOC_XTENSA_OP2:                  howto manager.      (line 2571)
13980* BFD_RELOC_XTENSA_PLT:                  howto manager.      (line 2520)
13981* BFD_RELOC_XTENSA_RELATIVE:             howto manager.      (line 2518)
13982* BFD_RELOC_XTENSA_RTLD:                 howto manager.      (line 2512)
13983* BFD_RELOC_XTENSA_SLOT0_ALT:            howto manager.      (line 2552)
13984* BFD_RELOC_XTENSA_SLOT0_OP:             howto manager.      (line 2533)
13985* BFD_RELOC_XTENSA_SLOT10_ALT:           howto manager.      (line 2562)
13986* BFD_RELOC_XTENSA_SLOT10_OP:            howto manager.      (line 2543)
13987* BFD_RELOC_XTENSA_SLOT11_ALT:           howto manager.      (line 2563)
13988* BFD_RELOC_XTENSA_SLOT11_OP:            howto manager.      (line 2544)
13989* BFD_RELOC_XTENSA_SLOT12_ALT:           howto manager.      (line 2564)
13990* BFD_RELOC_XTENSA_SLOT12_OP:            howto manager.      (line 2545)
13991* BFD_RELOC_XTENSA_SLOT13_ALT:           howto manager.      (line 2565)
13992* BFD_RELOC_XTENSA_SLOT13_OP:            howto manager.      (line 2546)
13993* BFD_RELOC_XTENSA_SLOT14_ALT:           howto manager.      (line 2566)
13994* BFD_RELOC_XTENSA_SLOT14_OP:            howto manager.      (line 2547)
13995* BFD_RELOC_XTENSA_SLOT1_ALT:            howto manager.      (line 2553)
13996* BFD_RELOC_XTENSA_SLOT1_OP:             howto manager.      (line 2534)
13997* BFD_RELOC_XTENSA_SLOT2_ALT:            howto manager.      (line 2554)
13998* BFD_RELOC_XTENSA_SLOT2_OP:             howto manager.      (line 2535)
13999* BFD_RELOC_XTENSA_SLOT3_ALT:            howto manager.      (line 2555)
14000* BFD_RELOC_XTENSA_SLOT3_OP:             howto manager.      (line 2536)
14001* BFD_RELOC_XTENSA_SLOT4_ALT:            howto manager.      (line 2556)
14002* BFD_RELOC_XTENSA_SLOT4_OP:             howto manager.      (line 2537)
14003* BFD_RELOC_XTENSA_SLOT5_ALT:            howto manager.      (line 2557)
14004* BFD_RELOC_XTENSA_SLOT5_OP:             howto manager.      (line 2538)
14005* BFD_RELOC_XTENSA_SLOT6_ALT:            howto manager.      (line 2558)
14006* BFD_RELOC_XTENSA_SLOT6_OP:             howto manager.      (line 2539)
14007* BFD_RELOC_XTENSA_SLOT7_ALT:            howto manager.      (line 2559)
14008* BFD_RELOC_XTENSA_SLOT7_OP:             howto manager.      (line 2540)
14009* BFD_RELOC_XTENSA_SLOT8_ALT:            howto manager.      (line 2560)
14010* BFD_RELOC_XTENSA_SLOT8_OP:             howto manager.      (line 2541)
14011* BFD_RELOC_XTENSA_SLOT9_ALT:            howto manager.      (line 2561)
14012* BFD_RELOC_XTENSA_SLOT9_OP:             howto manager.      (line 2542)
14013* BFD_RELOC_XTENSA_TLSDESC_ARG:          howto manager.      (line 2583)
14014* BFD_RELOC_XTENSA_TLSDESC_FN:           howto manager.      (line 2582)
14015* BFD_RELOC_XTENSA_TLS_ARG:              howto manager.      (line 2587)
14016* BFD_RELOC_XTENSA_TLS_CALL:             howto manager.      (line 2588)
14017* BFD_RELOC_XTENSA_TLS_DTPOFF:           howto manager.      (line 2584)
14018* BFD_RELOC_XTENSA_TLS_FUNC:             howto manager.      (line 2586)
14019* BFD_RELOC_XTENSA_TLS_TPOFF:            howto manager.      (line 2585)
14020* BFD_RELOC_Z80_DISP8:                   howto manager.      (line 2590)
14021* BFD_RELOC_Z8K_CALLR:                   howto manager.      (line 2594)
14022* BFD_RELOC_Z8K_DISP7:                   howto manager.      (line 2592)
14023* BFD_RELOC_Z8K_IMM4L:                   howto manager.      (line 2596)
14024* bfd_rename_section:                    section prototypes. (line  169)
14025* bfd_scan_arch:                         Architectures.      (line  534)
14026* bfd_scan_vma:                          Miscellaneous.      (line  126)
14027* bfd_sections_find_if:                  section prototypes. (line  199)
14028* bfd_section_already_linked:            Writing the symbol table.
14029                                                             (line   55)
14030* bfd_section_list_clear:                section prototypes. (line    7)
14031* bfd_set_archive_head:                  Archives.           (line   74)
14032* bfd_set_arch_info:                     Architectures.      (line  575)
14033* bfd_set_assert_handler:                Error reporting.    (line  161)
14034* bfd_set_default_target:                bfd_target.         (line  485)
14035* bfd_set_error:                         Error reporting.    (line   57)
14036* bfd_set_error_handler:                 Error reporting.    (line  127)
14037* bfd_set_error_program_name:            Error reporting.    (line  135)
14038* bfd_set_file_flags:                    Miscellaneous.      (line   45)
14039* bfd_set_format:                        Formats.            (line   67)
14040* bfd_set_gp_size:                       Miscellaneous.      (line  116)
14041* bfd_set_input_error:                   Error reporting.    (line   68)
14042* bfd_set_private_flags:                 Miscellaneous.      (line  174)
14043* bfd_set_reloc:                         Miscellaneous.      (line   33)
14044* bfd_set_section_contents:              section prototypes. (line  231)
14045* bfd_set_section_flags:                 section prototypes. (line  154)
14046* bfd_set_section_size:                  section prototypes. (line  216)
14047* bfd_set_start_address:                 Miscellaneous.      (line   95)
14048* bfd_set_symtab:                        symbol handling functions.
14049                                                             (line   63)
14050* bfd_symbol_info:                       symbol handling functions.
14051                                                             (line  135)
14052* bfd_target_list:                       bfd_target.         (line  537)
14053* bfd_update_compression_header:         Miscellaneous.      (line  350)
14054* bfd_write_bigendian_4byte_int:         Internal.           (line   12)
14055* bfd_zalloc:                            Opening and Closing.
14056                                                             (line  257)
14057* bfd_zalloc2:                           Opening and Closing.
14058                                                             (line  266)
14059* check_build_id_file:                   Opening and Closing.
14060                                                             (line  491)
14061* coff_symbol_type:                      coff.               (line  233)
14062* core_file_matches_executable_p:        Core Files.         (line   38)
14063* find_separate_debug_file:              Opening and Closing.
14064                                                             (line  365)
14065* generic_core_file_matches_executable_p: Core Files.        (line   48)
14066* get_build_id:                          Opening and Closing.
14067                                                             (line  460)
14068* get_build_id_name:                     Opening and Closing.
14069                                                             (line  474)
14070* Hash tables:                           Hash Tables.        (line    6)
14071* internal object-file format:           Canonical format.   (line   11)
14072* Linker:                                Linker Functions.   (line    6)
14073* Other functions:                       Miscellaneous.      (line  188)
14074* separate_alt_debug_file_exists:        Opening and Closing.
14075                                                             (line  356)
14076* separate_debug_file_exists:            Opening and Closing.
14077                                                             (line  343)
14078* struct bfd_iovec:                      Miscellaneous.      (line  409)
14079* target vector (_bfd_final_link):       Performing the Final Link.
14080                                                             (line    6)
14081* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
14082                                                             (line    6)
14083* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
14084                                                             (line    6)
14085* The HOWTO Macro:                       typedef arelent.    (line  288)
14086* what is it?:                           Overview.           (line    6)
14087
14088
14089
14090Tag Table:
14091Node: Top1051
14092Node: Overview1387
14093Node: History2445
14094Node: How It Works3390
14095Node: What BFD Version 2 Can Do4927
14096Node: BFD information loss6244
14097Node: Canonical format8785
14098Node: BFD front end13128
14099Node: typedef bfd13552
14100Node: Error reporting25873
14101Node: Miscellaneous31100
14102Node: Memory Usage49993
14103Node: Initialization51224
14104Node: Sections51683
14105Node: Section Input52166
14106Node: Section Output53360
14107Node: typedef asection55847
14108Node: section prototypes83451
14109Node: Symbols93865
14110Node: Reading Symbols95468
14111Node: Writing Symbols96576
14112Node: Mini Symbols98320
14113Node: typedef asymbol99294
14114Node: symbol handling functions105379
14115Node: Archives110754
14116Node: Formats114891
14117Node: Relocations117842
14118Node: typedef arelent118569
14119Node: howto manager134537
14120Node: Core Files262511
14121Node: Targets264549
14122Node: bfd_target266524
14123Node: Architectures291990
14124Node: Opening and Closing321711
14125Node: Internal339886
14126Node: File Caching346211
14127Node: Linker Functions348129
14128Node: Creating a Linker Hash Table349803
14129Node: Adding Symbols to the Hash Table351542
14130Node: Differing file formats352442
14131Node: Adding symbols from an object file354167
14132Node: Adding symbols from an archive356317
14133Node: Performing the Final Link358663
14134Node: Information provided by the linker359904
14135Node: Relocating the section contents361058
14136Node: Writing the symbol table362810
14137Node: Hash Tables369964
14138Node: Creating and Freeing a Hash Table371162
14139Node: Looking Up or Entering a String372412
14140Node: Traversing a Hash Table373665
14141Node: Deriving a New Hash Table Type374454
14142Node: Define the Derived Structures375520
14143Node: Write the Derived Creation Routine376601
14144Node: Write Other Derived Routines379226
14145Node: BFD back ends380541
14146Node: What to Put Where380811
14147Node: aout380991
14148Node: coff387273
14149Node: elf415424
14150Node: mmo415825
14151Node: File layout416695
14152Node: Symbol-table422608
14153Node: mmo section mapping426371
14154Node: GNU Free Documentation License430025
14155Node: BFD Index455089
14156
14157End Tag Table
14158