summaryrefslogtreecommitdiff
path: root/gnu
diff options
context:
space:
mode:
authorMarc Espie <espie@cvs.openbsd.org>2001-06-09 22:44:17 +0000
committerMarc Espie <espie@cvs.openbsd.org>2001-06-09 22:44:17 +0000
commitc2edc66d163e70ba5b4076d7e9cd11a8f172564d (patch)
tree029aa4ba976ba22ae550c67497ae7fbd9b32a82f /gnu
parentb087ddea52407e4a9b8fe07d0ad234d36379fb67 (diff)
Bye, bye
Diffstat (limited to 'gnu')
-rw-r--r--gnu/usr.bin/binutils/bfd/doc/bfd.info-6683
-rw-r--r--gnu/usr.bin/binutils/bfd/doc/bfd.info-7491
2 files changed, 0 insertions, 1174 deletions
diff --git a/gnu/usr.bin/binutils/bfd/doc/bfd.info-6 b/gnu/usr.bin/binutils/bfd/doc/bfd.info-6
deleted file mode 100644
index 0c59a3dc63d..00000000000
--- a/gnu/usr.bin/binutils/bfd/doc/bfd.info-6
+++ /dev/null
@@ -1,683 +0,0 @@
-This is bfd.info, produced by makeinfo version 4.0 from bfd.texinfo.
-
-START-INFO-DIR-ENTRY
-* Bfd: (bfd). The Binary File Descriptor library.
-END-INFO-DIR-ENTRY
-
- This file documents the BFD library.
-
- Copyright (C) 1991 Free Software Foundation, Inc.
-
- Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-
- Permission is granted to copy and distribute modified versions of
-this manual under the conditions for verbatim copying, subject to the
-terms of the GNU General Public License, which includes the provision
-that the entire resulting derived work is distributed under the terms
-of a permission notice identical to this one.
-
- Permission is granted to copy and distribute translations of this
-manual into another language, under the above conditions for modified
-versions.
-
-
-File: bfd.info, Node: coff, Next: elf, Prev: aout, Up: BFD back ends
-
-coff backends
-=============
-
- BFD supports a number of different flavours of coff format. The
-major differences between formats are the sizes and alignments of
-fields in structures on disk, and the occasional extra field.
-
- Coff in all its varieties is implemented with a few common files and
-a number of implementation specific files. For example, The 88k bcs
-coff format is implemented in the file `coff-m88k.c'. This file
-`#include's `coff/m88k.h' which defines the external structure of the
-coff format for the 88k, and `coff/internal.h' which defines the
-internal structure. `coff-m88k.c' also defines the relocations used by
-the 88k format *Note Relocations::.
-
- The Intel i960 processor version of coff is implemented in
-`coff-i960.c'. This file has the same structure as `coff-m88k.c',
-except that it includes `coff/i960.h' rather than `coff-m88k.h'.
-
-Porting to a new version of coff
---------------------------------
-
- The recommended method is to select from the existing
-implementations the version of coff which is most like the one you want
-to use. For example, we'll say that i386 coff is the one you select,
-and that your coff flavour is called foo. Copy `i386coff.c' to
-`foocoff.c', copy `../include/coff/i386.h' to `../include/coff/foo.h',
-and add the lines to `targets.c' and `Makefile.in' so that your new
-back end is used. Alter the shapes of the structures in
-`../include/coff/foo.h' so that they match what you need. You will
-probably also have to add `#ifdef's to the code in `coff/internal.h' and
-`coffcode.h' if your version of coff is too wild.
-
- You can verify that your new BFD backend works quite simply by
-building `objdump' from the `binutils' directory, and making sure that
-its version of what's going on and your host system's idea (assuming it
-has the pretty standard coff dump utility, usually called `att-dump' or
-just `dump') are the same. Then clean up your code, and send what
-you've done to Cygnus. Then your stuff will be in the next release, and
-you won't have to keep integrating it.
-
-How the coff backend works
---------------------------
-
-File layout
-...........
-
- The Coff backend is split into generic routines that are applicable
-to any Coff target and routines that are specific to a particular
-target. The target-specific routines are further split into ones which
-are basically the same for all Coff targets except that they use the
-external symbol format or use different values for certain constants.
-
- The generic routines are in `coffgen.c'. These routines work for
-any Coff target. They use some hooks into the target specific code;
-the hooks are in a `bfd_coff_backend_data' structure, one of which
-exists for each target.
-
- The essentially similar target-specific routines are in
-`coffcode.h'. This header file includes executable C code. The
-various Coff targets first include the appropriate Coff header file,
-make any special defines that are needed, and then include `coffcode.h'.
-
- Some of the Coff targets then also have additional routines in the
-target source file itself.
-
- For example, `coff-i960.c' includes `coff/internal.h' and
-`coff/i960.h'. It then defines a few constants, such as `I960', and
-includes `coffcode.h'. Since the i960 has complex relocation types,
-`coff-i960.c' also includes some code to manipulate the i960 relocs.
-This code is not in `coffcode.h' because it would not be used by any
-other target.
-
-Bit twiddling
-.............
-
- Each flavour of coff supported in BFD has its own header file
-describing the external layout of the structures. There is also an
-internal description of the coff layout, in `coff/internal.h'. A major
-function of the coff backend is swapping the bytes and twiddling the
-bits to translate the external form of the structures into the normal
-internal form. This is all performed in the `bfd_swap'_thing_direction
-routines. Some elements are different sizes between different versions
-of coff; it is the duty of the coff version specific include file to
-override the definitions of various packing routines in `coffcode.h'.
-E.g., the size of line number entry in coff is sometimes 16 bits, and
-sometimes 32 bits. `#define'ing `PUT_LNSZ_LNNO' and `GET_LNSZ_LNNO'
-will select the correct one. No doubt, some day someone will find a
-version of coff which has a varying field size not catered to at the
-moment. To port BFD, that person will have to add more `#defines'.
-Three of the bit twiddling routines are exported to `gdb';
-`coff_swap_aux_in', `coff_swap_sym_in' and `coff_swap_lineno_in'. `GDB'
-reads the symbol table on its own, but uses BFD to fix things up. More
-of the bit twiddlers are exported for `gas'; `coff_swap_aux_out',
-`coff_swap_sym_out', `coff_swap_lineno_out', `coff_swap_reloc_out',
-`coff_swap_filehdr_out', `coff_swap_aouthdr_out',
-`coff_swap_scnhdr_out'. `Gas' currently keeps track of all the symbol
-table and reloc drudgery itself, thereby saving the internal BFD
-overhead, but uses BFD to swap things on the way out, making cross
-ports much safer. Doing so also allows BFD (and thus the linker) to
-use the same header files as `gas', which makes one avenue to disaster
-disappear.
-
-Symbol reading
-..............
-
- The simple canonical form for symbols used by BFD is not rich enough
-to keep all the information available in a coff symbol table. The back
-end gets around this problem by keeping the original symbol table
-around, "behind the scenes".
-
- When a symbol table is requested (through a call to
-`bfd_canonicalize_symtab'), a request gets through to
-`coff_get_normalized_symtab'. This reads the symbol table from the coff
-file and swaps all the structures inside into the internal form. It
-also fixes up all the pointers in the table (represented in the file by
-offsets from the first symbol in the table) into physical pointers to
-elements in the new internal table. This involves some work since the
-meanings of fields change depending upon context: a field that is a
-pointer to another structure in the symbol table at one moment may be
-the size in bytes of a structure at the next. Another pass is made
-over the table. All symbols which mark file names (`C_FILE' symbols)
-are modified so that the internal string points to the value in the
-auxent (the real filename) rather than the normal text associated with
-the symbol (`".file"').
-
- At this time the symbol names are moved around. Coff stores all
-symbols less than nine characters long physically within the symbol
-table; longer strings are kept at the end of the file in the string
-table. This pass moves all strings into memory and replaces them with
-pointers to the strings.
-
- The symbol table is massaged once again, this time to create the
-canonical table used by the BFD application. Each symbol is inspected
-in turn, and a decision made (using the `sclass' field) about the
-various flags to set in the `asymbol'. *Note Symbols::. The generated
-canonical table shares strings with the hidden internal symbol table.
-
- Any linenumbers are read from the coff file too, and attached to the
-symbols which own the functions the linenumbers belong to.
-
-Symbol writing
-..............
-
- Writing a symbol to a coff file which didn't come from a coff file
-will lose any debugging information. The `asymbol' structure remembers
-the BFD from which the symbol was taken, and on output the back end
-makes sure that the same destination target as source target is present.
-
- When the symbols have come from a coff file then all the debugging
-information is preserved.
-
- Symbol tables are provided for writing to the back end in a vector
-of pointers to pointers. This allows applications like the linker to
-accumulate and output large symbol tables without having to do too much
-byte copying.
-
- This function runs through the provided symbol table and patches
-each symbol marked as a file place holder (`C_FILE') to point to the
-next file place holder in the list. It also marks each `offset' field
-in the list with the offset from the first symbol of the current symbol.
-
- Another function of this procedure is to turn the canonical value
-form of BFD into the form used by coff. Internally, BFD expects symbol
-values to be offsets from a section base; so a symbol physically at
-0x120, but in a section starting at 0x100, would have the value 0x20.
-Coff expects symbols to contain their final value, so symbols have
-their values changed at this point to reflect their sum with their
-owning section. This transformation uses the `output_section' field of
-the `asymbol''s `asection' *Note Sections::.
-
- * `coff_mangle_symbols'
- This routine runs though the provided symbol table and uses the
-offsets generated by the previous pass and the pointers generated when
-the symbol table was read in to create the structured hierachy required
-by coff. It changes each pointer to a symbol into the index into the
-symbol table of the asymbol.
-
- * `coff_write_symbols'
- This routine runs through the symbol table and patches up the
-symbols from their internal form into the coff way, calls the bit
-twiddlers, and writes out the table to the file.
-
-`coff_symbol_type'
-..................
-
- *Description*
-The hidden information for an `asymbol' is described in a
-`combined_entry_type':
-
-
- typedef struct coff_ptr_struct
- {
-
- /* Remembers the offset from the first symbol in the file for
- this symbol. Generated by coff_renumber_symbols. */
- unsigned int offset;
-
- /* Should the value of this symbol be renumbered. Used for
- XCOFF C_BSTAT symbols. Set by coff_slurp_symbol_table. */
- unsigned int fix_value : 1;
-
- /* Should the tag field of this symbol be renumbered.
- Created by coff_pointerize_aux. */
- unsigned int fix_tag : 1;
-
- /* Should the endidx field of this symbol be renumbered.
- Created by coff_pointerize_aux. */
- unsigned int fix_end : 1;
-
- /* Should the x_csect.x_scnlen field be renumbered.
- Created by coff_pointerize_aux. */
- unsigned int fix_scnlen : 1;
-
- /* Fix up an XCOFF C_BINCL/C_EINCL symbol. The value is the
- index into the line number entries. Set by
- coff_slurp_symbol_table. */
- unsigned int fix_line : 1;
-
- /* The container for the symbol structure as read and translated
- from the file. */
-
- union {
- union internal_auxent auxent;
- struct internal_syment syment;
- } u;
- } combined_entry_type;
-
-
- /* Each canonical asymbol really looks like this: */
-
- typedef struct coff_symbol_struct
- {
- /* The actual symbol which the rest of BFD works with */
- asymbol symbol;
-
- /* A pointer to the hidden information for this symbol */
- combined_entry_type *native;
-
- /* A pointer to the linenumber information for this symbol */
- struct lineno_cache_entry *lineno;
-
- /* Have the line numbers been relocated yet ? */
- boolean done_lineno;
- } coff_symbol_type;
-
-`bfd_coff_backend_data'
-.......................
-
- /* COFF symbol classifications. */
-
- enum coff_symbol_classification
- {
- /* Global symbol. */
- COFF_SYMBOL_GLOBAL,
- /* Common symbol. */
- COFF_SYMBOL_COMMON,
- /* Undefined symbol. */
- COFF_SYMBOL_UNDEFINED,
- /* Local symbol. */
- COFF_SYMBOL_LOCAL,
- /* PE section symbol. */
- COFF_SYMBOL_PE_SECTION
- };
- Special entry points for gdb to swap in coff symbol table parts:
- typedef struct
- {
- void (*_bfd_coff_swap_aux_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- int type,
- int class,
- int indaux,
- int numaux,
- PTR in));
-
- void (*_bfd_coff_swap_sym_in) PARAMS ((
- bfd *abfd ,
- PTR ext,
- PTR in));
-
- void (*_bfd_coff_swap_lineno_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- PTR in));
- Special entry points for gas to swap out coff parts:
- unsigned int (*_bfd_coff_swap_aux_out) PARAMS ((
- bfd *abfd,
- PTR in,
- int type,
- int class,
- int indaux,
- int numaux,
- PTR ext));
-
- unsigned int (*_bfd_coff_swap_sym_out) PARAMS ((
- bfd *abfd,
- PTR in,
- PTR ext));
-
- unsigned int (*_bfd_coff_swap_lineno_out) PARAMS ((
- bfd *abfd,
- PTR in,
- PTR ext));
-
- unsigned int (*_bfd_coff_swap_reloc_out) PARAMS ((
- bfd *abfd,
- PTR src,
- PTR dst));
-
- unsigned int (*_bfd_coff_swap_filehdr_out) PARAMS ((
- bfd *abfd,
- PTR in,
- PTR out));
-
- unsigned int (*_bfd_coff_swap_aouthdr_out) PARAMS ((
- bfd *abfd,
- PTR in,
- PTR out));
-
- unsigned int (*_bfd_coff_swap_scnhdr_out) PARAMS ((
- bfd *abfd,
- PTR in,
- PTR out));
- Special entry points for generic COFF routines to call target
-dependent COFF routines:
- unsigned int _bfd_filhsz;
- unsigned int _bfd_aoutsz;
- unsigned int _bfd_scnhsz;
- unsigned int _bfd_symesz;
- unsigned int _bfd_auxesz;
- unsigned int _bfd_relsz;
- unsigned int _bfd_linesz;
- unsigned int _bfd_filnmlen;
- boolean _bfd_coff_long_filenames;
- boolean _bfd_coff_long_section_names;
- unsigned int _bfd_coff_default_section_alignment_power;
- void (*_bfd_coff_swap_filehdr_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- PTR in));
- void (*_bfd_coff_swap_aouthdr_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- PTR in));
- void (*_bfd_coff_swap_scnhdr_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- PTR in));
- void (*_bfd_coff_swap_reloc_in) PARAMS ((
- bfd *abfd,
- PTR ext,
- PTR in));
- boolean (*_bfd_coff_bad_format_hook) PARAMS ((
- bfd *abfd,
- PTR internal_filehdr));
- boolean (*_bfd_coff_set_arch_mach_hook) PARAMS ((
- bfd *abfd,
- PTR internal_filehdr));
- PTR (*_bfd_coff_mkobject_hook) PARAMS ((
- bfd *abfd,
- PTR internal_filehdr,
- PTR internal_aouthdr));
- flagword (*_bfd_styp_to_sec_flags_hook) PARAMS ((
- bfd *abfd,
- PTR internal_scnhdr,
- const char *name,
- asection *section));
- void (*_bfd_set_alignment_hook) PARAMS ((
- bfd *abfd,
- asection *sec,
- PTR internal_scnhdr));
- boolean (*_bfd_coff_slurp_symbol_table) PARAMS ((
- bfd *abfd));
- boolean (*_bfd_coff_symname_in_debug) PARAMS ((
- bfd *abfd,
- struct internal_syment *sym));
- boolean (*_bfd_coff_pointerize_aux_hook) PARAMS ((
- bfd *abfd,
- combined_entry_type *table_base,
- combined_entry_type *symbol,
- unsigned int indaux,
- combined_entry_type *aux));
- boolean (*_bfd_coff_print_aux) PARAMS ((
- bfd *abfd,
- FILE *file,
- combined_entry_type *table_base,
- combined_entry_type *symbol,
- combined_entry_type *aux,
- unsigned int indaux));
- void (*_bfd_coff_reloc16_extra_cases) PARAMS ((
- bfd *abfd,
- struct bfd_link_info *link_info,
- struct bfd_link_order *link_order,
- arelent *reloc,
- bfd_byte *data,
- unsigned int *src_ptr,
- unsigned int *dst_ptr));
- int (*_bfd_coff_reloc16_estimate) PARAMS ((
- bfd *abfd,
- asection *input_section,
- arelent *r,
- unsigned int shrink,
- struct bfd_link_info *link_info));
- enum coff_symbol_classification (*_bfd_coff_classify_symbol) PARAMS ((
- bfd *abfd,
- struct internal_syment *));
- boolean (*_bfd_coff_compute_section_file_positions) PARAMS ((
- bfd *abfd));
- boolean (*_bfd_coff_start_final_link) PARAMS ((
- bfd *output_bfd,
- struct bfd_link_info *info));
- boolean (*_bfd_coff_relocate_section) PARAMS ((
- bfd *output_bfd,
- struct bfd_link_info *info,
- bfd *input_bfd,
- asection *input_section,
- bfd_byte *contents,
- struct internal_reloc *relocs,
- struct internal_syment *syms,
- asection **sections));
- reloc_howto_type *(*_bfd_coff_rtype_to_howto) PARAMS ((
- bfd *abfd,
- asection *sec,
- struct internal_reloc *rel,
- struct coff_link_hash_entry *h,
- struct internal_syment *sym,
- bfd_vma *addendp));
- boolean (*_bfd_coff_adjust_symndx) PARAMS ((
- bfd *obfd,
- struct bfd_link_info *info,
- bfd *ibfd,
- asection *sec,
- struct internal_reloc *reloc,
- boolean *adjustedp));
- boolean (*_bfd_coff_link_add_one_symbol) PARAMS ((
- struct bfd_link_info *info,
- bfd *abfd,
- const char *name,
- flagword flags,
- asection *section,
- bfd_vma value,
- const char *string,
- boolean copy,
- boolean collect,
- struct bfd_link_hash_entry **hashp));
-
- boolean (*_bfd_coff_link_output_has_begun) PARAMS ((
- bfd * abfd,
- struct coff_final_link_info * pfinfo));
- boolean (*_bfd_coff_final_link_postscript) PARAMS ((
- bfd * abfd,
- struct coff_final_link_info * pfinfo));
-
- } bfd_coff_backend_data;
-
- #define coff_backend_info(abfd) ((bfd_coff_backend_data *) (abfd)->xvec->backend_data)
-
- #define bfd_coff_swap_aux_in(a,e,t,c,ind,num,i) \
- ((coff_backend_info (a)->_bfd_coff_swap_aux_in) (a,e,t,c,ind,num,i))
-
- #define bfd_coff_swap_sym_in(a,e,i) \
- ((coff_backend_info (a)->_bfd_coff_swap_sym_in) (a,e,i))
-
- #define bfd_coff_swap_lineno_in(a,e,i) \
- ((coff_backend_info ( a)->_bfd_coff_swap_lineno_in) (a,e,i))
-
- #define bfd_coff_swap_reloc_out(abfd, i, o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_out) (abfd, i, o))
-
- #define bfd_coff_swap_lineno_out(abfd, i, o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_lineno_out) (abfd, i, o))
-
- #define bfd_coff_swap_aux_out(a,i,t,c,ind,num,o) \
- ((coff_backend_info (a)->_bfd_coff_swap_aux_out) (a,i,t,c,ind,num,o))
-
- #define bfd_coff_swap_sym_out(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_sym_out) (abfd, i, o))
-
- #define bfd_coff_swap_scnhdr_out(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_out) (abfd, i, o))
-
- #define bfd_coff_swap_filehdr_out(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_out) (abfd, i, o))
-
- #define bfd_coff_swap_aouthdr_out(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_out) (abfd, i, o))
-
- #define bfd_coff_filhsz(abfd) (coff_backend_info (abfd)->_bfd_filhsz)
- #define bfd_coff_aoutsz(abfd) (coff_backend_info (abfd)->_bfd_aoutsz)
- #define bfd_coff_scnhsz(abfd) (coff_backend_info (abfd)->_bfd_scnhsz)
- #define bfd_coff_symesz(abfd) (coff_backend_info (abfd)->_bfd_symesz)
- #define bfd_coff_auxesz(abfd) (coff_backend_info (abfd)->_bfd_auxesz)
- #define bfd_coff_relsz(abfd) (coff_backend_info (abfd)->_bfd_relsz)
- #define bfd_coff_linesz(abfd) (coff_backend_info (abfd)->_bfd_linesz)
- #define bfd_coff_filnmlen(abfd) (coff_backend_info (abfd)->_bfd_filnmlen)
- #define bfd_coff_long_filenames(abfd) (coff_backend_info (abfd)->_bfd_coff_long_filenames)
- #define bfd_coff_long_section_names(abfd) \
- (coff_backend_info (abfd)->_bfd_coff_long_section_names)
- #define bfd_coff_default_section_alignment_power(abfd) \
- (coff_backend_info (abfd)->_bfd_coff_default_section_alignment_power)
- #define bfd_coff_swap_filehdr_in(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_filehdr_in) (abfd, i, o))
-
- #define bfd_coff_swap_aouthdr_in(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_aouthdr_in) (abfd, i, o))
-
- #define bfd_coff_swap_scnhdr_in(abfd, i,o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_scnhdr_in) (abfd, i, o))
-
- #define bfd_coff_swap_reloc_in(abfd, i, o) \
- ((coff_backend_info (abfd)->_bfd_coff_swap_reloc_in) (abfd, i, o))
-
- #define bfd_coff_bad_format_hook(abfd, filehdr) \
- ((coff_backend_info (abfd)->_bfd_coff_bad_format_hook) (abfd, filehdr))
-
- #define bfd_coff_set_arch_mach_hook(abfd, filehdr)\
- ((coff_backend_info (abfd)->_bfd_coff_set_arch_mach_hook) (abfd, filehdr))
- #define bfd_coff_mkobject_hook(abfd, filehdr, aouthdr)\
- ((coff_backend_info (abfd)->_bfd_coff_mkobject_hook) (abfd, filehdr, aouthdr))
-
- #define bfd_coff_styp_to_sec_flags_hook(abfd, scnhdr, name, section)\
- ((coff_backend_info (abfd)->_bfd_styp_to_sec_flags_hook)\
- (abfd, scnhdr, name, section))
-
- #define bfd_coff_set_alignment_hook(abfd, sec, scnhdr)\
- ((coff_backend_info (abfd)->_bfd_set_alignment_hook) (abfd, sec, scnhdr))
-
- #define bfd_coff_slurp_symbol_table(abfd)\
- ((coff_backend_info (abfd)->_bfd_coff_slurp_symbol_table) (abfd))
-
- #define bfd_coff_symname_in_debug(abfd, sym)\
- ((coff_backend_info (abfd)->_bfd_coff_symname_in_debug) (abfd, sym))
-
- #define bfd_coff_print_aux(abfd, file, base, symbol, aux, indaux)\
- ((coff_backend_info (abfd)->_bfd_coff_print_aux)\
- (abfd, file, base, symbol, aux, indaux))
-
- #define bfd_coff_reloc16_extra_cases(abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr)\
- ((coff_backend_info (abfd)->_bfd_coff_reloc16_extra_cases)\
- (abfd, link_info, link_order, reloc, data, src_ptr, dst_ptr))
-
- #define bfd_coff_reloc16_estimate(abfd, section, reloc, shrink, link_info)\
- ((coff_backend_info (abfd)->_bfd_coff_reloc16_estimate)\
- (abfd, section, reloc, shrink, link_info))
-
- #define bfd_coff_classify_symbol(abfd, sym)\
- ((coff_backend_info (abfd)->_bfd_coff_classify_symbol)\
- (abfd, sym))
-
- #define bfd_coff_compute_section_file_positions(abfd)\
- ((coff_backend_info (abfd)->_bfd_coff_compute_section_file_positions)\
- (abfd))
-
- #define bfd_coff_start_final_link(obfd, info)\
- ((coff_backend_info (obfd)->_bfd_coff_start_final_link)\
- (obfd, info))
- #define bfd_coff_relocate_section(obfd,info,ibfd,o,con,rel,isyms,secs)\
- ((coff_backend_info (ibfd)->_bfd_coff_relocate_section)\
- (obfd, info, ibfd, o, con, rel, isyms, secs))
- #define bfd_coff_rtype_to_howto(abfd, sec, rel, h, sym, addendp)\
- ((coff_backend_info (abfd)->_bfd_coff_rtype_to_howto)\
- (abfd, sec, rel, h, sym, addendp))
- #define bfd_coff_adjust_symndx(obfd, info, ibfd, sec, rel, adjustedp)\
- ((coff_backend_info (abfd)->_bfd_coff_adjust_symndx)\
- (obfd, info, ibfd, sec, rel, adjustedp))
- #define bfd_coff_link_add_one_symbol(info,abfd,name,flags,section,value,string,cp,coll,hashp)\
- ((coff_backend_info (abfd)->_bfd_coff_link_add_one_symbol)\
- (info, abfd, name, flags, section, value, string, cp, coll, hashp))
-
- #define bfd_coff_link_output_has_begun(a,p) \
- ((coff_backend_info (a)->_bfd_coff_link_output_has_begun) (a,p))
- #define bfd_coff_final_link_postscript(a,p) \
- ((coff_backend_info (a)->_bfd_coff_final_link_postscript) (a,p))
-
-Writing relocations
-...................
-
- To write relocations, the back end steps though the canonical
-relocation table and create an `internal_reloc'. The symbol index to
-use is removed from the `offset' field in the symbol table supplied.
-The address comes directly from the sum of the section base address and
-the relocation offset; the type is dug directly from the howto field.
-Then the `internal_reloc' is swapped into the shape of an
-`external_reloc' and written out to disk.
-
-Reading linenumbers
-...................
-
- Creating the linenumber table is done by reading in the entire coff
-linenumber table, and creating another table for internal use.
-
- A coff linenumber table is structured so that each function is
-marked as having a line number of 0. Each line within the function is
-an offset from the first line in the function. The base of the line
-number information for the table is stored in the symbol associated
-with the function.
-
- Note: The PE format uses line number 0 for a flag indicating a new
-source file.
-
- The information is copied from the external to the internal table,
-and each symbol which marks a function is marked by pointing its...
-
- How does this work ?
-
-Reading relocations
-...................
-
- Coff relocations are easily transformed into the internal BFD form
-(`arelent').
-
- Reading a coff relocation table is done in the following stages:
-
- * Read the entire coff relocation table into memory.
-
- * Process each relocation in turn; first swap it from the external
- to the internal form.
-
- * Turn the symbol referenced in the relocation's symbol index into a
- pointer into the canonical symbol table. This table is the same
- as the one returned by a call to `bfd_canonicalize_symtab'. The
- back end will call that routine and save the result if a
- canonicalization hasn't been done.
-
- * The reloc index is turned into a pointer to a howto structure, in
- a back end specific way. For instance, the 386 and 960 use the
- `r_type' to directly produce an index into a howto table vector;
- the 88k subtracts a number from the `r_type' field and creates an
- addend field.
-
-
-File: bfd.info, Node: elf, Prev: coff, Up: BFD back ends
-
-ELF backends
-============
-
- BFD support for ELF formats is being worked on. Currently, the best
-supported back ends are for sparc and i386 (running svr4 or Solaris 2).
-
- Documentation of the internals of the support code still needs to be
-written. The code is changing quickly enough that we haven't bothered
-yet.
-
-`bfd_elf_find_section'
-......................
-
- *Synopsis*
- struct elf_internal_shdr *bfd_elf_find_section (bfd *abfd, char *name);
- *Description*
-Helper functions for GDB to locate the string tables. Since BFD hides
-string tables from callers, GDB needs to use an internal hook to find
-them. Sun's .stabstr, in particular, isn't even pointed to by the
-.stab section, so ordinary mechanisms wouldn't work to find it, even if
-we had some.
-
diff --git a/gnu/usr.bin/binutils/bfd/doc/bfd.info-7 b/gnu/usr.bin/binutils/bfd/doc/bfd.info-7
deleted file mode 100644
index 18e8a5d8c89..00000000000
--- a/gnu/usr.bin/binutils/bfd/doc/bfd.info-7
+++ /dev/null
@@ -1,491 +0,0 @@
-This is bfd.info, produced by makeinfo version 4.0 from bfd.texinfo.
-
-START-INFO-DIR-ENTRY
-* Bfd: (bfd). The Binary File Descriptor library.
-END-INFO-DIR-ENTRY
-
- This file documents the BFD library.
-
- Copyright (C) 1991 Free Software Foundation, Inc.
-
- Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-
- Permission is granted to copy and distribute modified versions of
-this manual under the conditions for verbatim copying, subject to the
-terms of the GNU General Public License, which includes the provision
-that the entire resulting derived work is distributed under the terms
-of a permission notice identical to this one.
-
- Permission is granted to copy and distribute translations of this
-manual into another language, under the above conditions for modified
-versions.
-
-
-File: bfd.info, Node: Index, Prev: BFD back ends, Up: Top
-
-Index
-*****
-
-* Menu:
-
-* _bfd_final_link_relocate: Relocating the section contents.
-* _bfd_generic_link_add_archive_symbols: Adding symbols from an archive.
-* _bfd_generic_link_add_one_symbol: Adding symbols from an object file.
-* _bfd_link_add_symbols in target vector: Adding Symbols to the Hash Table.
-* _bfd_link_final_link in target vector: Performing the Final Link.
-* _bfd_link_hash_table_create in target vector: Creating a Linker Hash Table.
-* _bfd_relocate_contents: Relocating the section contents.
-* _bfd_strip_section_from_output: section prototypes.
-* aout_SIZE_machine_type: aout.
-* aout_SIZE_mkobject: aout.
-* aout_SIZE_new_section_hook: aout.
-* aout_SIZE_set_arch_mach: aout.
-* aout_SIZE_some_aout_object_p: aout.
-* aout_SIZE_swap_exec_header_in: aout.
-* aout_SIZE_swap_exec_header_out: aout.
-* arelent_chain: typedef arelent.
-* BFD: Overview.
-* BFD canonical format: Canonical format.
-* bfd_alloc: Opening and Closing.
-* bfd_arch_bits_per_address: Architectures.
-* bfd_arch_bits_per_byte: Architectures.
-* bfd_arch_get_compatible: Architectures.
-* bfd_arch_list: Architectures.
-* bfd_arch_mach_octets_per_byte: Architectures.
-* bfd_cache_close: File Caching.
-* bfd_cache_init: File Caching.
-* bfd_cache_lookup: File Caching.
-* bfd_cache_lookup_worker: File Caching.
-* BFD_CACHE_MAX_OPEN macro: File Caching.
-* bfd_canonicalize_reloc: BFD front end.
-* bfd_canonicalize_symtab: symbol handling functions.
-* bfd_check_format: Formats.
-* bfd_check_format_matches: Formats.
-* bfd_check_overflow: typedef arelent.
-* bfd_close: Opening and Closing.
-* bfd_close_all_done: Opening and Closing.
-* bfd_coff_backend_data: coff.
-* bfd_copy_private_bfd_data: BFD front end.
-* bfd_copy_private_section_data: section prototypes.
-* bfd_copy_private_symbol_data: symbol handling functions.
-* bfd_core_file_failing_command: Core Files.
-* bfd_core_file_failing_signal: Core Files.
-* bfd_create: Opening and Closing.
-* bfd_decode_symclass: symbol handling functions.
-* bfd_default_arch_struct: Architectures.
-* bfd_default_compatible: Architectures.
-* bfd_default_reloc_type_lookup: howto manager.
-* bfd_default_scan: Architectures.
-* bfd_default_set_arch_mach: Architectures.
-* bfd_elf_find_section: elf.
-* bfd_errmsg: BFD front end.
-* bfd_fdopenr: Opening and Closing.
-* bfd_find_target: bfd_target.
-* bfd_format_string: Formats.
-* bfd_generic_gc_sections: howto manager.
-* bfd_generic_get_relocated_section_contents: howto manager.
-* bfd_generic_relax_section: howto manager.
-* bfd_get_arch: Architectures.
-* bfd_get_arch_info: Architectures.
-* bfd_get_error: BFD front end.
-* bfd_get_error_handler: BFD front end.
-* bfd_get_gp_size: BFD front end.
-* bfd_get_mach: Architectures.
-* bfd_get_mtime: BFD front end.
-* bfd_get_next_mapent: Archives.
-* bfd_get_reloc_code_name: howto manager.
-* bfd_get_reloc_size: typedef arelent.
-* bfd_get_reloc_upper_bound: BFD front end.
-* bfd_get_section_by_name: section prototypes.
-* bfd_get_section_contents: section prototypes.
-* bfd_get_size <1>: Internal.
-* bfd_get_size: BFD front end.
-* bfd_get_symtab_upper_bound: symbol handling functions.
-* bfd_h_put_size: Internal.
-* bfd_hash_allocate: Creating and Freeing a Hash Table.
-* bfd_hash_lookup: Looking Up or Entering a String.
-* bfd_hash_newfunc: Creating and Freeing a Hash Table.
-* bfd_hash_table_free: Creating and Freeing a Hash Table.
-* bfd_hash_table_init: Creating and Freeing a Hash Table.
-* bfd_hash_table_init_n: Creating and Freeing a Hash Table.
-* bfd_hash_traverse: Traversing a Hash Table.
-* bfd_init: Initialization.
-* bfd_install_relocation: typedef arelent.
-* bfd_is_local_label: symbol handling functions.
-* bfd_is_local_label_name: symbol handling functions.
-* bfd_is_undefined_symclass: symbol handling functions.
-* bfd_last_cache: File Caching.
-* bfd_link_split_section: Writing the symbol table.
-* bfd_log2: Internal.
-* bfd_lookup_arch: Architectures.
-* bfd_make_debug_symbol: symbol handling functions.
-* bfd_make_empty_symbol: symbol handling functions.
-* bfd_make_readable: Opening and Closing.
-* bfd_make_section: section prototypes.
-* bfd_make_section_anyway: section prototypes.
-* bfd_make_section_old_way: section prototypes.
-* bfd_make_writable: Opening and Closing.
-* bfd_map_over_sections: section prototypes.
-* bfd_merge_private_bfd_data: BFD front end.
-* bfd_octets_per_byte: Architectures.
-* bfd_open_file: File Caching.
-* bfd_openr: Opening and Closing.
-* bfd_openr_next_archived_file: Archives.
-* bfd_openstreamr: Opening and Closing.
-* bfd_openw: Opening and Closing.
-* bfd_perform_relocation: typedef arelent.
-* bfd_perror: BFD front end.
-* bfd_print_symbol_vandf: symbol handling functions.
-* bfd_printable_arch_mach: Architectures.
-* bfd_printable_name: Architectures.
-* bfd_put_size: Internal.
-* BFD_RELOC_12_PCREL: howto manager.
-* BFD_RELOC_14: howto manager.
-* BFD_RELOC_16: howto manager.
-* BFD_RELOC_16_BASEREL: howto manager.
-* BFD_RELOC_16_GOT_PCREL: howto manager.
-* BFD_RELOC_16_GOTOFF: howto manager.
-* BFD_RELOC_16_PCREL: howto manager.
-* BFD_RELOC_16_PCREL_S2: howto manager.
-* BFD_RELOC_16_PLT_PCREL: howto manager.
-* BFD_RELOC_16_PLTOFF: howto manager.
-* BFD_RELOC_23_PCREL_S2: howto manager.
-* BFD_RELOC_24: howto manager.
-* BFD_RELOC_24_PCREL: howto manager.
-* BFD_RELOC_24_PLT_PCREL: howto manager.
-* BFD_RELOC_26: howto manager.
-* BFD_RELOC_32: howto manager.
-* BFD_RELOC_32_BASEREL: howto manager.
-* BFD_RELOC_32_GOT_PCREL: howto manager.
-* BFD_RELOC_32_GOTOFF: howto manager.
-* BFD_RELOC_32_PCREL: howto manager.
-* BFD_RELOC_32_PCREL_S2: howto manager.
-* BFD_RELOC_32_PLT_PCREL: howto manager.
-* BFD_RELOC_32_PLTOFF: howto manager.
-* BFD_RELOC_386_COPY: howto manager.
-* BFD_RELOC_386_GLOB_DAT: howto manager.
-* BFD_RELOC_386_GOT32: howto manager.
-* BFD_RELOC_386_GOTOFF: howto manager.
-* BFD_RELOC_386_GOTPC: howto manager.
-* BFD_RELOC_386_JUMP_SLOT: howto manager.
-* BFD_RELOC_386_PLT32: howto manager.
-* BFD_RELOC_386_RELATIVE: howto manager.
-* BFD_RELOC_64: howto manager.
-* BFD_RELOC_64_PCREL: howto manager.
-* BFD_RELOC_68K_GLOB_DAT: howto manager.
-* BFD_RELOC_68K_JMP_SLOT: howto manager.
-* BFD_RELOC_68K_RELATIVE: howto manager.
-* BFD_RELOC_8: howto manager.
-* BFD_RELOC_8_BASEREL: howto manager.
-* BFD_RELOC_8_FFnn: howto manager.
-* BFD_RELOC_8_GOT_PCREL: howto manager.
-* BFD_RELOC_8_GOTOFF: howto manager.
-* BFD_RELOC_8_PCREL: howto manager.
-* BFD_RELOC_8_PLT_PCREL: howto manager.
-* BFD_RELOC_8_PLTOFF: howto manager.
-* BFD_RELOC_ALPHA_CODEADDR: howto manager.
-* BFD_RELOC_ALPHA_ELF_LITERAL: howto manager.
-* BFD_RELOC_ALPHA_GPDISP: howto manager.
-* BFD_RELOC_ALPHA_GPDISP_HI16: howto manager.
-* BFD_RELOC_ALPHA_GPDISP_LO16: howto manager.
-* BFD_RELOC_ALPHA_HINT: howto manager.
-* BFD_RELOC_ALPHA_LINKAGE: howto manager.
-* BFD_RELOC_ALPHA_LITERAL: howto manager.
-* BFD_RELOC_ALPHA_LITUSE: howto manager.
-* BFD_RELOC_ALPHA_USER_GPDISP: howto manager.
-* BFD_RELOC_ALPHA_USER_GPRELHIGH: howto manager.
-* BFD_RELOC_ALPHA_USER_GPRELLOW: howto manager.
-* BFD_RELOC_ALPHA_USER_LITERAL: howto manager.
-* BFD_RELOC_ALPHA_USER_LITUSE_BASE: howto manager.
-* BFD_RELOC_ALPHA_USER_LITUSE_BYTOFF: howto manager.
-* BFD_RELOC_ALPHA_USER_LITUSE_JSR: howto manager.
-* BFD_RELOC_ARC_B22_PCREL: howto manager.
-* BFD_RELOC_ARC_B26: howto manager.
-* BFD_RELOC_ARM_ADR_IMM: howto manager.
-* BFD_RELOC_ARM_ADRL_IMMEDIATE: howto manager.
-* BFD_RELOC_ARM_COPY: howto manager.
-* BFD_RELOC_ARM_CP_OFF_IMM: howto manager.
-* BFD_RELOC_ARM_GLOB_DAT: howto manager.
-* BFD_RELOC_ARM_GOT12: howto manager.
-* BFD_RELOC_ARM_GOT32: howto manager.
-* BFD_RELOC_ARM_GOTOFF: howto manager.
-* BFD_RELOC_ARM_GOTPC: howto manager.
-* BFD_RELOC_ARM_HWLITERAL: howto manager.
-* BFD_RELOC_ARM_IMMEDIATE: howto manager.
-* BFD_RELOC_ARM_IN_POOL: howto manager.
-* BFD_RELOC_ARM_JUMP_SLOT: howto manager.
-* BFD_RELOC_ARM_LDR_IMM: howto manager.
-* BFD_RELOC_ARM_LITERAL: howto manager.
-* BFD_RELOC_ARM_MULTI: howto manager.
-* BFD_RELOC_ARM_OFFSET_IMM: howto manager.
-* BFD_RELOC_ARM_OFFSET_IMM8: howto manager.
-* BFD_RELOC_ARM_PCREL_BRANCH: howto manager.
-* BFD_RELOC_ARM_PLT32: howto manager.
-* BFD_RELOC_ARM_RELATIVE: howto manager.
-* BFD_RELOC_ARM_SHIFT_IMM: howto manager.
-* BFD_RELOC_ARM_SWI: howto manager.
-* BFD_RELOC_ARM_THUMB_ADD: howto manager.
-* BFD_RELOC_ARM_THUMB_IMM: howto manager.
-* BFD_RELOC_ARM_THUMB_OFFSET: howto manager.
-* BFD_RELOC_ARM_THUMB_SHIFT: howto manager.
-* BFD_RELOC_AVR_13_PCREL: howto manager.
-* BFD_RELOC_AVR_16_PM: howto manager.
-* BFD_RELOC_AVR_7_PCREL: howto manager.
-* BFD_RELOC_AVR_CALL: howto manager.
-* BFD_RELOC_AVR_HH8_LDI: howto manager.
-* BFD_RELOC_AVR_HH8_LDI_NEG: howto manager.
-* BFD_RELOC_AVR_HH8_LDI_PM: howto manager.
-* BFD_RELOC_AVR_HH8_LDI_PM_NEG: howto manager.
-* BFD_RELOC_AVR_HI8_LDI: howto manager.
-* BFD_RELOC_AVR_HI8_LDI_NEG: howto manager.
-* BFD_RELOC_AVR_HI8_LDI_PM: howto manager.
-* BFD_RELOC_AVR_HI8_LDI_PM_NEG: howto manager.
-* BFD_RELOC_AVR_LO8_LDI: howto manager.
-* BFD_RELOC_AVR_LO8_LDI_NEG: howto manager.
-* BFD_RELOC_AVR_LO8_LDI_PM: howto manager.
-* BFD_RELOC_AVR_LO8_LDI_PM_NEG: howto manager.
-* bfd_reloc_code_type: howto manager.
-* BFD_RELOC_CTOR: howto manager.
-* BFD_RELOC_D10V_10_PCREL_L: howto manager.
-* BFD_RELOC_D10V_10_PCREL_R: howto manager.
-* BFD_RELOC_D10V_18: howto manager.
-* BFD_RELOC_D10V_18_PCREL: howto manager.
-* BFD_RELOC_D30V_15: howto manager.
-* BFD_RELOC_D30V_15_PCREL: howto manager.
-* BFD_RELOC_D30V_15_PCREL_R: howto manager.
-* BFD_RELOC_D30V_21: howto manager.
-* BFD_RELOC_D30V_21_PCREL: howto manager.
-* BFD_RELOC_D30V_21_PCREL_R: howto manager.
-* BFD_RELOC_D30V_32: howto manager.
-* BFD_RELOC_D30V_32_PCREL: howto manager.
-* BFD_RELOC_D30V_6: howto manager.
-* BFD_RELOC_D30V_9_PCREL: howto manager.
-* BFD_RELOC_D30V_9_PCREL_R: howto manager.
-* BFD_RELOC_FR30_10_IN_8: howto manager.
-* BFD_RELOC_FR30_12_PCREL: howto manager.
-* BFD_RELOC_FR30_20: howto manager.
-* BFD_RELOC_FR30_48: howto manager.
-* BFD_RELOC_FR30_6_IN_4: howto manager.
-* BFD_RELOC_FR30_8_IN_8: howto manager.
-* BFD_RELOC_FR30_9_IN_8: howto manager.
-* BFD_RELOC_FR30_9_PCREL: howto manager.
-* BFD_RELOC_GPREL16: howto manager.
-* BFD_RELOC_GPREL32: howto manager.
-* BFD_RELOC_HI16: howto manager.
-* BFD_RELOC_HI16_BASEREL: howto manager.
-* BFD_RELOC_HI16_GOTOFF: howto manager.
-* BFD_RELOC_HI16_PLTOFF: howto manager.
-* BFD_RELOC_HI16_S: howto manager.
-* BFD_RELOC_HI16_S_BASEREL: howto manager.
-* BFD_RELOC_HI16_S_GOTOFF: howto manager.
-* BFD_RELOC_HI16_S_PLTOFF: howto manager.
-* BFD_RELOC_HI22: howto manager.
-* BFD_RELOC_I370_D12: howto manager.
-* BFD_RELOC_I960_CALLJ: howto manager.
-* BFD_RELOC_LO10: howto manager.
-* BFD_RELOC_LO16: howto manager.
-* BFD_RELOC_LO16_BASEREL: howto manager.
-* BFD_RELOC_LO16_GOTOFF: howto manager.
-* BFD_RELOC_LO16_PLTOFF: howto manager.
-* BFD_RELOC_M32R_10_PCREL: howto manager.
-* BFD_RELOC_M32R_18_PCREL: howto manager.
-* BFD_RELOC_M32R_24: howto manager.
-* BFD_RELOC_M32R_26_PCREL: howto manager.
-* BFD_RELOC_M32R_HI16_SLO: howto manager.
-* BFD_RELOC_M32R_HI16_ULO: howto manager.
-* BFD_RELOC_M32R_LO16: howto manager.
-* BFD_RELOC_M32R_SDA16: howto manager.
-* BFD_RELOC_MCORE_PCREL_32: howto manager.
-* BFD_RELOC_MCORE_PCREL_IMM11BY2: howto manager.
-* BFD_RELOC_MCORE_PCREL_IMM4BY2: howto manager.
-* BFD_RELOC_MCORE_PCREL_IMM8BY4: howto manager.
-* BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2: howto manager.
-* BFD_RELOC_MCORE_RVA: howto manager.
-* BFD_RELOC_MIPS16_GPREL: howto manager.
-* BFD_RELOC_MIPS16_JMP: howto manager.
-* BFD_RELOC_MIPS_CALL16: howto manager.
-* BFD_RELOC_MIPS_CALL_HI16: howto manager.
-* BFD_RELOC_MIPS_CALL_LO16: howto manager.
-* BFD_RELOC_MIPS_GOT16: howto manager.
-* BFD_RELOC_MIPS_GOT_DISP: howto manager.
-* BFD_RELOC_MIPS_GOT_HI16: howto manager.
-* BFD_RELOC_MIPS_GOT_LO16: howto manager.
-* BFD_RELOC_MIPS_GOT_OFST: howto manager.
-* BFD_RELOC_MIPS_GOT_PAGE: howto manager.
-* BFD_RELOC_MIPS_GPREL: howto manager.
-* BFD_RELOC_MIPS_GPREL32: howto manager.
-* BFD_RELOC_MIPS_JMP: howto manager.
-* BFD_RELOC_MIPS_LITERAL: howto manager.
-* BFD_RELOC_MIPS_SUB: howto manager.
-* BFD_RELOC_MN10300_16_PCREL: howto manager.
-* BFD_RELOC_MN10300_32_PCREL: howto manager.
-* BFD_RELOC_NONE: howto manager.
-* BFD_RELOC_NS32K_DISP_16: howto manager.
-* BFD_RELOC_NS32K_DISP_16_PCREL: howto manager.
-* BFD_RELOC_NS32K_DISP_32: howto manager.
-* BFD_RELOC_NS32K_DISP_32_PCREL: howto manager.
-* BFD_RELOC_NS32K_DISP_8: howto manager.
-* BFD_RELOC_NS32K_DISP_8_PCREL: howto manager.
-* BFD_RELOC_NS32K_IMM_16: howto manager.
-* BFD_RELOC_NS32K_IMM_16_PCREL: howto manager.
-* BFD_RELOC_NS32K_IMM_32: howto manager.
-* BFD_RELOC_NS32K_IMM_32_PCREL: howto manager.
-* BFD_RELOC_NS32K_IMM_8: howto manager.
-* BFD_RELOC_NS32K_IMM_8_PCREL: howto manager.
-* BFD_RELOC_PCREL_HI16_S: howto manager.
-* BFD_RELOC_PCREL_LO16: howto manager.
-* BFD_RELOC_PJ_CODE_DIR16: howto manager.
-* BFD_RELOC_PJ_CODE_DIR32: howto manager.
-* BFD_RELOC_PJ_CODE_HI16: howto manager.
-* BFD_RELOC_PJ_CODE_LO16: howto manager.
-* BFD_RELOC_PJ_CODE_REL16: howto manager.
-* BFD_RELOC_PJ_CODE_REL32: howto manager.
-* BFD_RELOC_PPC_B16: howto manager.
-* BFD_RELOC_PPC_B16_BRNTAKEN: howto manager.
-* BFD_RELOC_PPC_B16_BRTAKEN: howto manager.
-* BFD_RELOC_PPC_B26: howto manager.
-* BFD_RELOC_PPC_BA16: howto manager.
-* BFD_RELOC_PPC_BA16_BRNTAKEN: howto manager.
-* BFD_RELOC_PPC_BA16_BRTAKEN: howto manager.
-* BFD_RELOC_PPC_BA26: howto manager.
-* BFD_RELOC_PPC_COPY: howto manager.
-* BFD_RELOC_PPC_EMB_BIT_FLD: howto manager.
-* BFD_RELOC_PPC_EMB_MRKREF: howto manager.
-* BFD_RELOC_PPC_EMB_NADDR16: howto manager.
-* BFD_RELOC_PPC_EMB_NADDR16_HA: howto manager.
-* BFD_RELOC_PPC_EMB_NADDR16_HI: howto manager.
-* BFD_RELOC_PPC_EMB_NADDR16_LO: howto manager.
-* BFD_RELOC_PPC_EMB_NADDR32: howto manager.
-* BFD_RELOC_PPC_EMB_RELSDA: howto manager.
-* BFD_RELOC_PPC_EMB_RELSEC16: howto manager.
-* BFD_RELOC_PPC_EMB_RELST_HA: howto manager.
-* BFD_RELOC_PPC_EMB_RELST_HI: howto manager.
-* BFD_RELOC_PPC_EMB_RELST_LO: howto manager.
-* BFD_RELOC_PPC_EMB_SDA21: howto manager.
-* BFD_RELOC_PPC_EMB_SDA2I16: howto manager.
-* BFD_RELOC_PPC_EMB_SDA2REL: howto manager.
-* BFD_RELOC_PPC_EMB_SDAI16: howto manager.
-* BFD_RELOC_PPC_GLOB_DAT: howto manager.
-* BFD_RELOC_PPC_JMP_SLOT: howto manager.
-* BFD_RELOC_PPC_LOCAL24PC: howto manager.
-* BFD_RELOC_PPC_RELATIVE: howto manager.
-* BFD_RELOC_PPC_TOC16: howto manager.
-* BFD_RELOC_RVA: howto manager.
-* BFD_RELOC_SH_ALIGN: howto manager.
-* BFD_RELOC_SH_CODE: howto manager.
-* BFD_RELOC_SH_COUNT: howto manager.
-* BFD_RELOC_SH_DATA: howto manager.
-* BFD_RELOC_SH_IMM4: howto manager.
-* BFD_RELOC_SH_IMM4BY2: howto manager.
-* BFD_RELOC_SH_IMM4BY4: howto manager.
-* BFD_RELOC_SH_IMM8: howto manager.
-* BFD_RELOC_SH_IMM8BY2: howto manager.
-* BFD_RELOC_SH_IMM8BY4: howto manager.
-* BFD_RELOC_SH_LABEL: howto manager.
-* BFD_RELOC_SH_PCDISP12BY2: howto manager.
-* BFD_RELOC_SH_PCDISP8BY2: howto manager.
-* BFD_RELOC_SH_PCRELIMM8BY2: howto manager.
-* BFD_RELOC_SH_PCRELIMM8BY4: howto manager.
-* BFD_RELOC_SH_SWITCH16: howto manager.
-* BFD_RELOC_SH_SWITCH32: howto manager.
-* BFD_RELOC_SH_USES: howto manager.
-* BFD_RELOC_SPARC13: howto manager.
-* BFD_RELOC_SPARC22: howto manager.
-* BFD_RELOC_SPARC_10: howto manager.
-* BFD_RELOC_SPARC_11: howto manager.
-* BFD_RELOC_SPARC_5: howto manager.
-* BFD_RELOC_SPARC_6: howto manager.
-* BFD_RELOC_SPARC_64: howto manager.
-* BFD_RELOC_SPARC_7: howto manager.
-* BFD_RELOC_SPARC_BASE13: howto manager.
-* BFD_RELOC_SPARC_BASE22: howto manager.
-* BFD_RELOC_SPARC_COPY: howto manager.
-* BFD_RELOC_SPARC_DISP64: howto manager.
-* BFD_RELOC_SPARC_GLOB_DAT: howto manager.
-* BFD_RELOC_SPARC_GOT10: howto manager.
-* BFD_RELOC_SPARC_GOT13: howto manager.
-* BFD_RELOC_SPARC_GOT22: howto manager.
-* BFD_RELOC_SPARC_H44: howto manager.
-* BFD_RELOC_SPARC_HH22: howto manager.
-* BFD_RELOC_SPARC_HIX22: howto manager.
-* BFD_RELOC_SPARC_HM10: howto manager.
-* BFD_RELOC_SPARC_JMP_SLOT: howto manager.
-* BFD_RELOC_SPARC_L44: howto manager.
-* BFD_RELOC_SPARC_LM22: howto manager.
-* BFD_RELOC_SPARC_LOX10: howto manager.
-* BFD_RELOC_SPARC_M44: howto manager.
-* BFD_RELOC_SPARC_OLO10: howto manager.
-* BFD_RELOC_SPARC_PC10: howto manager.
-* BFD_RELOC_SPARC_PC22: howto manager.
-* BFD_RELOC_SPARC_PC_HH22: howto manager.
-* BFD_RELOC_SPARC_PC_HM10: howto manager.
-* BFD_RELOC_SPARC_PC_LM22: howto manager.
-* BFD_RELOC_SPARC_PLT64: howto manager.
-* BFD_RELOC_SPARC_REGISTER: howto manager.
-* BFD_RELOC_SPARC_RELATIVE: howto manager.
-* BFD_RELOC_SPARC_REV32: howto manager.
-* BFD_RELOC_SPARC_UA32: howto manager.
-* BFD_RELOC_SPARC_WDISP16: howto manager.
-* BFD_RELOC_SPARC_WDISP19: howto manager.
-* BFD_RELOC_SPARC_WDISP22: howto manager.
-* BFD_RELOC_SPARC_WPLT30: howto manager.
-* BFD_RELOC_THUMB_PCREL_BRANCH12: howto manager.
-* BFD_RELOC_THUMB_PCREL_BRANCH23: howto manager.
-* BFD_RELOC_THUMB_PCREL_BRANCH9: howto manager.
-* BFD_RELOC_TIC30_LDP: howto manager.
-* bfd_reloc_type_lookup: howto manager.
-* BFD_RELOC_V850_22_PCREL: howto manager.
-* BFD_RELOC_V850_9_PCREL: howto manager.
-* BFD_RELOC_V850_CALLT_16_16_OFFSET: howto manager.
-* BFD_RELOC_V850_CALLT_6_7_OFFSET: howto manager.
-* BFD_RELOC_V850_SDA_15_16_OFFSET: howto manager.
-* BFD_RELOC_V850_SDA_16_16_OFFSET: howto manager.
-* BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_16_16_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_4_4_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_4_5_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_6_8_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_7_7_OFFSET: howto manager.
-* BFD_RELOC_V850_TDA_7_8_OFFSET: howto manager.
-* BFD_RELOC_V850_ZDA_15_16_OFFSET: howto manager.
-* BFD_RELOC_V850_ZDA_16_16_OFFSET: howto manager.
-* BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET: howto manager.
-* BFD_RELOC_VTABLE_ENTRY: howto manager.
-* BFD_RELOC_VTABLE_INHERIT: howto manager.
-* bfd_scan_arch: Architectures.
-* bfd_scan_vma: BFD front end.
-* bfd_seach_for_target: bfd_target.
-* bfd_set_arch_info: Architectures.
-* bfd_set_archive_head: Archives.
-* bfd_set_default_target: bfd_target.
-* bfd_set_error: BFD front end.
-* bfd_set_error_handler: BFD front end.
-* bfd_set_error_program_name: BFD front end.
-* bfd_set_file_flags: BFD front end.
-* bfd_set_format: Formats.
-* bfd_set_gp_size: BFD front end.
-* bfd_set_private_flags: BFD front end.
-* bfd_set_reloc: BFD front end.
-* bfd_set_section_contents: section prototypes.
-* bfd_set_section_flags: section prototypes.
-* bfd_set_section_size: section prototypes.
-* bfd_set_start_address: BFD front end.
-* bfd_set_symtab: symbol handling functions.
-* bfd_symbol_info: symbol handling functions.
-* bfd_target_list: bfd_target.
-* bfd_write_bigendian_4byte_int: Internal.
-* coff_symbol_type: coff.
-* core_file_matches_executable_p: Core Files.
-* Hash tables: Hash Tables.
-* internal object-file format: Canonical format.
-* Linker: Linker Functions.
-* stuff: BFD front end.
-* target vector (_bfd_final_link): Performing the Final Link.
-* target vector (_bfd_link_add_symbols): Adding Symbols to the Hash Table.
-* target vector (_bfd_link_hash_table_create): Creating a Linker Hash Table.
-* The HOWTO Macro: typedef arelent.
-* what is it?: Overview.
-
-