bfd/
[external/binutils.git] / bfd / bfd-in2.h
1 /* DO NOT EDIT!  -*- buffer-read-only: t -*-  This file is automatically 
2    generated from "bfd-in.h", "init.c", "opncls.c", "libbfd.c", 
3    "bfdio.c", "bfdwin.c", "section.c", "archures.c", "reloc.c", 
4    "syms.c", "bfd.c", "archive.c", "corefile.c", "targets.c", "format.c", 
5    "linker.c" and "simple.c".
6    Run "make headers" in your build bfd/ to regenerate.  */
7
8 /* Main header file for the bfd library -- portable access to object files.
9
10    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
11    1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
12    Free Software Foundation, Inc.
13
14    Contributed by Cygnus Support.
15
16    This file is part of BFD, the Binary File Descriptor library.
17
18    This program is free software; you can redistribute it and/or modify
19    it under the terms of the GNU General Public License as published by
20    the Free Software Foundation; either version 2 of the License, or
21    (at your option) any later version.
22
23    This program is distributed in the hope that it will be useful,
24    but WITHOUT ANY WARRANTY; without even the implied warranty of
25    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
26    GNU General Public License for more details.
27
28    You should have received a copy of the GNU General Public License
29    along with this program; if not, write to the Free Software
30    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
31
32 #ifndef __BFD_H_SEEN__
33 #define __BFD_H_SEEN__
34
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38
39 #include "ansidecl.h"
40 #include "symcat.h"
41 #if defined (__STDC__) || defined (ALMOST_STDC) || defined (HAVE_STRINGIZE)
42 #ifndef SABER
43 /* This hack is to avoid a problem with some strict ANSI C preprocessors.
44    The problem is, "32_" is not a valid preprocessing token, and we don't
45    want extra underscores (e.g., "nlm_32_").  The XCONCAT2 macro will
46    cause the inner CONCAT2 macros to be evaluated first, producing
47    still-valid pp-tokens.  Then the final concatenation can be done.  */
48 #undef CONCAT4
49 #define CONCAT4(a,b,c,d) XCONCAT2(CONCAT2(a,b),CONCAT2(c,d))
50 #endif
51 #endif
52
53 /* This is a utility macro to handle the situation where the code
54    wants to place a constant string into the code, followed by a
55    comma and then the length of the string.  Doing this by hand
56    is error prone, so using this macro is safer.  The macro will
57    also safely handle the case where a NULL is passed as the arg.  */
58 #define STRING_COMMA_LEN(STR) (STR), ((STR) ? sizeof (STR) - 1 : 0)
59 /* Unfortunately it is not possible to use the STRING_COMMA_LEN macro
60    to create the arguments to another macro, since the preprocessor
61    will mis-count the number of arguments to the outer macro (by not
62    evaluating STRING_COMMA_LEN and so missing the comma).  This is a
63    problem for example when trying to use STRING_COMMA_LEN to build
64    the arguments to the strncmp() macro.  Hence this alternative
65    definition of strncmp is provided here.
66    
67    Note - these macros do NOT work if STR2 is not a constant string.  */
68 #define CONST_STRNEQ(STR1,STR2) (strncmp ((STR1), (STR2), sizeof (STR2) - 1) == 0)
69   /* strcpy() can have a similar problem, but since we know we are
70      copying a constant string, we can use memcpy which will be faster
71      since there is no need to check for a NUL byte inside STR.  We
72      can also save time if we do not need to copy the terminating NUL.  */
73 #define LITMEMCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2) - 1)
74 #define LITSTRCPY(DEST,STR2) memcpy ((DEST), (STR2), sizeof (STR2))
75
76
77 /* The word size used by BFD on the host.  This may be 64 with a 32
78    bit target if the host is 64 bit, or if other 64 bit targets have
79    been selected with --enable-targets, or if --enable-64-bit-bfd.  */
80 #define BFD_ARCH_SIZE @wordsize@
81
82 /* The word size of the default bfd target.  */
83 #define BFD_DEFAULT_TARGET_SIZE @bfd_default_target_size@
84
85 #define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@
86 #define BFD_HOST_LONG_LONG @BFD_HOST_LONG_LONG@
87 #if @BFD_HOST_64_BIT_DEFINED@
88 #define BFD_HOST_64_BIT @BFD_HOST_64_BIT@
89 #define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@
90 typedef BFD_HOST_64_BIT bfd_int64_t;
91 typedef BFD_HOST_U_64_BIT bfd_uint64_t;
92 #endif
93
94 #if BFD_ARCH_SIZE >= 64
95 #define BFD64
96 #endif
97
98 #ifndef INLINE
99 #if __GNUC__ >= 2
100 #define INLINE __inline__
101 #else
102 #define INLINE
103 #endif
104 #endif
105
106 /* Forward declaration.  */
107 typedef struct bfd bfd;
108
109 /* Boolean type used in bfd.  Too many systems define their own
110    versions of "boolean" for us to safely typedef a "boolean" of
111    our own.  Using an enum for "bfd_boolean" has its own set of
112    problems, with strange looking casts required to avoid warnings
113    on some older compilers.  Thus we just use an int.
114
115    General rule: Functions which are bfd_boolean return TRUE on
116    success and FALSE on failure (unless they're a predicate).  */
117
118 typedef int bfd_boolean;
119 #undef FALSE
120 #undef TRUE
121 #define FALSE 0
122 #define TRUE 1
123
124 #ifdef BFD64
125
126 #ifndef BFD_HOST_64_BIT
127  #error No 64 bit integer type available
128 #endif /* ! defined (BFD_HOST_64_BIT) */
129
130 typedef BFD_HOST_U_64_BIT bfd_vma;
131 typedef BFD_HOST_64_BIT bfd_signed_vma;
132 typedef BFD_HOST_U_64_BIT bfd_size_type;
133 typedef BFD_HOST_U_64_BIT symvalue;
134
135 #ifndef fprintf_vma
136 #if BFD_HOST_64BIT_LONG
137 #define sprintf_vma(s,x) sprintf (s, "%016lx", x)
138 #define fprintf_vma(f,x) fprintf (f, "%016lx", x)
139 #else
140 #define _bfd_int64_low(x) ((unsigned long) (((x) & 0xffffffff)))
141 #define _bfd_int64_high(x) ((unsigned long) (((x) >> 32) & 0xffffffff))
142 #define fprintf_vma(s,x) \
143   fprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
144 #define sprintf_vma(s,x) \
145   sprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
146 #endif
147 #endif
148
149 #else /* not BFD64  */
150
151 /* Represent a target address.  Also used as a generic unsigned type
152    which is guaranteed to be big enough to hold any arithmetic types
153    we need to deal with.  */
154 typedef unsigned long bfd_vma;
155
156 /* A generic signed type which is guaranteed to be big enough to hold any
157    arithmetic types we need to deal with.  Can be assumed to be compatible
158    with bfd_vma in the same way that signed and unsigned ints are compatible
159    (as parameters, in assignment, etc).  */
160 typedef long bfd_signed_vma;
161
162 typedef unsigned long symvalue;
163 typedef unsigned long bfd_size_type;
164
165 /* Print a bfd_vma x on stream s.  */
166 #define fprintf_vma(s,x) fprintf (s, "%08lx", x)
167 #define sprintf_vma(s,x) sprintf (s, "%08lx", x)
168
169 #endif /* not BFD64  */
170
171 #define HALF_BFD_SIZE_TYPE \
172   (((bfd_size_type) 1) << (8 * sizeof (bfd_size_type) / 2))
173
174 #ifndef BFD_HOST_64_BIT
175 /* Fall back on a 32 bit type.  The idea is to make these types always
176    available for function return types, but in the case that
177    BFD_HOST_64_BIT is undefined such a function should abort or
178    otherwise signal an error.  */
179 typedef bfd_signed_vma bfd_int64_t;
180 typedef bfd_vma bfd_uint64_t;
181 #endif
182
183 /* An offset into a file.  BFD always uses the largest possible offset
184    based on the build time availability of fseek, fseeko, or fseeko64.  */
185 typedef @bfd_file_ptr@ file_ptr;
186 typedef unsigned @bfd_file_ptr@ ufile_ptr;
187
188 extern void bfd_sprintf_vma (bfd *, char *, bfd_vma);
189 extern void bfd_fprintf_vma (bfd *, void *, bfd_vma);
190
191 #define printf_vma(x) fprintf_vma(stdout,x)
192 #define bfd_printf_vma(abfd,x) bfd_fprintf_vma (abfd,stdout,x)
193
194 typedef unsigned int flagword;  /* 32 bits of flags */
195 typedef unsigned char bfd_byte;
196 \f
197 /* File formats.  */
198
199 typedef enum bfd_format
200 {
201   bfd_unknown = 0,      /* File format is unknown.  */
202   bfd_object,           /* Linker/assembler/compiler output.  */
203   bfd_archive,          /* Object archive file.  */
204   bfd_core,             /* Core dump.  */
205   bfd_type_end          /* Marks the end; don't use it!  */
206 }
207 bfd_format;
208
209 /* Values that may appear in the flags field of a BFD.  These also
210    appear in the object_flags field of the bfd_target structure, where
211    they indicate the set of flags used by that backend (not all flags
212    are meaningful for all object file formats) (FIXME: at the moment,
213    the object_flags values have mostly just been copied from backend
214    to another, and are not necessarily correct).  */
215
216 /* No flags.  */
217 #define BFD_NO_FLAGS    0x00
218
219 /* BFD contains relocation entries.  */
220 #define HAS_RELOC       0x01
221
222 /* BFD is directly executable.  */
223 #define EXEC_P          0x02
224
225 /* BFD has line number information (basically used for F_LNNO in a
226    COFF header).  */
227 #define HAS_LINENO      0x04
228
229 /* BFD has debugging information.  */
230 #define HAS_DEBUG       0x08
231
232 /* BFD has symbols.  */
233 #define HAS_SYMS        0x10
234
235 /* BFD has local symbols (basically used for F_LSYMS in a COFF
236    header).  */
237 #define HAS_LOCALS      0x20
238
239 /* BFD is a dynamic object.  */
240 #define DYNAMIC         0x40
241
242 /* Text section is write protected (if D_PAGED is not set, this is
243    like an a.out NMAGIC file) (the linker sets this by default, but
244    clears it for -r or -N).  */
245 #define WP_TEXT         0x80
246
247 /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
248    linker sets this by default, but clears it for -r or -n or -N).  */
249 #define D_PAGED         0x100
250
251 /* BFD is relaxable (this means that bfd_relax_section may be able to
252    do something) (sometimes bfd_relax_section can do something even if
253    this is not set).  */
254 #define BFD_IS_RELAXABLE 0x200
255
256 /* This may be set before writing out a BFD to request using a
257    traditional format.  For example, this is used to request that when
258    writing out an a.out object the symbols not be hashed to eliminate
259    duplicates.  */
260 #define BFD_TRADITIONAL_FORMAT 0x400
261
262 /* This flag indicates that the BFD contents are actually cached in
263    memory.  If this is set, iostream points to a bfd_in_memory struct.  */
264 #define BFD_IN_MEMORY 0x800
265
266 /* The sections in this BFD specify a memory page.  */
267 #define HAS_LOAD_PAGE 0x1000
268
269 /* This BFD has been created by the linker and doesn't correspond
270    to any input file.  */
271 #define BFD_LINKER_CREATED 0x2000
272 \f
273 /* Symbols and relocation.  */
274
275 /* A count of carsyms (canonical archive symbols).  */
276 typedef unsigned long symindex;
277
278 /* How to perform a relocation.  */
279 typedef const struct reloc_howto_struct reloc_howto_type;
280
281 #define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
282
283 /* General purpose part of a symbol X;
284    target specific parts are in libcoff.h, libaout.h, etc.  */
285
286 #define bfd_get_section(x) ((x)->section)
287 #define bfd_get_output_section(x) ((x)->section->output_section)
288 #define bfd_set_section(x,y) ((x)->section) = (y)
289 #define bfd_asymbol_base(x) ((x)->section->vma)
290 #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
291 #define bfd_asymbol_name(x) ((x)->name)
292 /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
293 #define bfd_asymbol_bfd(x) ((x)->the_bfd)
294 #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
295
296 /* A canonical archive symbol.  */
297 /* This is a type pun with struct ranlib on purpose!  */
298 typedef struct carsym
299 {
300   char *name;
301   file_ptr file_offset; /* Look here to find the file.  */
302 }
303 carsym;                 /* To make these you call a carsymogen.  */
304
305 /* Used in generating armaps (archive tables of contents).
306    Perhaps just a forward definition would do?  */
307 struct orl                      /* Output ranlib.  */
308 {
309   char **name;          /* Symbol name.  */
310   union
311   {
312     file_ptr pos;
313     bfd *abfd;
314   } u;                  /* bfd* or file position.  */
315   int namidx;           /* Index into string table.  */
316 };
317 \f
318 /* Linenumber stuff.  */
319 typedef struct lineno_cache_entry
320 {
321   unsigned int line_number;     /* Linenumber from start of function.  */
322   union
323   {
324     struct bfd_symbol *sym;     /* Function name.  */
325     bfd_vma offset;                     /* Offset into section.  */
326   } u;
327 }
328 alent;
329 \f
330 /* Object and core file sections.  */
331
332 #define align_power(addr, align)        \
333   (((addr) + ((bfd_vma) 1 << (align)) - 1) & ((bfd_vma) -1 << (align)))
334
335 typedef struct bfd_section *sec_ptr;
336
337 #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
338 #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
339 #define bfd_get_section_lma(bfd, ptr) ((ptr)->lma + 0)
340 #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
341 #define bfd_section_name(bfd, ptr) ((ptr)->name)
342 #define bfd_section_size(bfd, ptr) ((ptr)->size)
343 #define bfd_get_section_size(ptr) ((ptr)->size)
344 #define bfd_section_vma(bfd, ptr) ((ptr)->vma)
345 #define bfd_section_lma(bfd, ptr) ((ptr)->lma)
346 #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
347 #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
348 #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
349
350 #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
351
352 #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma = (val)), ((ptr)->user_set_vma = TRUE), TRUE)
353 #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),TRUE)
354 #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),TRUE)
355 /* Find the address one past the end of SEC.  */
356 #define bfd_get_section_limit(bfd, sec) \
357   (((sec)->rawsize ? (sec)->rawsize : (sec)->size) \
358    / bfd_octets_per_byte (bfd))
359
360 /* Forward define.  */
361 struct stat;
362 \f
363 typedef enum bfd_print_symbol
364 {
365   bfd_print_symbol_name,
366   bfd_print_symbol_more,
367   bfd_print_symbol_all
368 } bfd_print_symbol_type;
369
370 /* Information about a symbol that nm needs.  */
371
372 typedef struct _symbol_info
373 {
374   symvalue value;
375   char type;
376   const char *name;            /* Symbol name.  */
377   unsigned char stab_type;     /* Stab type.  */
378   char stab_other;             /* Stab other.  */
379   short stab_desc;             /* Stab desc.  */
380   const char *stab_name;       /* String for stab type.  */
381 } symbol_info;
382
383 /* Get the name of a stabs type code.  */
384
385 extern const char *bfd_get_stab_name (int);
386 \f
387 /* Hash table routines.  There is no way to free up a hash table.  */
388
389 /* An element in the hash table.  Most uses will actually use a larger
390    structure, and an instance of this will be the first field.  */
391
392 struct bfd_hash_entry
393 {
394   /* Next entry for this hash code.  */
395   struct bfd_hash_entry *next;
396   /* String being hashed.  */
397   const char *string;
398   /* Hash code.  This is the full hash code, not the index into the
399      table.  */
400   unsigned long hash;
401 };
402
403 /* A hash table.  */
404
405 struct bfd_hash_table
406 {
407   /* The hash array.  */
408   struct bfd_hash_entry **table;
409   /* A function used to create new elements in the hash table.  The
410      first entry is itself a pointer to an element.  When this
411      function is first invoked, this pointer will be NULL.  However,
412      having the pointer permits a hierarchy of method functions to be
413      built each of which calls the function in the superclass.  Thus
414      each function should be written to allocate a new block of memory
415      only if the argument is NULL.  */
416   struct bfd_hash_entry *(*newfunc)
417     (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
418    /* An objalloc for this hash table.  This is a struct objalloc *,
419      but we use void * to avoid requiring the inclusion of objalloc.h.  */
420   void *memory;
421   /* The number of slots in the hash table.  */
422   unsigned int size;
423   /* The number of entries in the hash table.  */
424   unsigned int count;
425   /* The size of elements.  */
426   unsigned int entsize;
427   /* If non-zero, don't grow the hash table.  */
428   unsigned int frozen:1;
429 };
430
431 /* Initialize a hash table.  */
432 extern bfd_boolean bfd_hash_table_init
433   (struct bfd_hash_table *,
434    struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
435                                struct bfd_hash_table *,
436                                const char *),
437    unsigned int);
438
439 /* Initialize a hash table specifying a size.  */
440 extern bfd_boolean bfd_hash_table_init_n
441   (struct bfd_hash_table *,
442    struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
443                                struct bfd_hash_table *,
444                                const char *),
445    unsigned int, unsigned int);
446
447 /* Free up a hash table.  */
448 extern void bfd_hash_table_free
449   (struct bfd_hash_table *);
450
451 /* Look up a string in a hash table.  If CREATE is TRUE, a new entry
452    will be created for this string if one does not already exist.  The
453    COPY argument must be TRUE if this routine should copy the string
454    into newly allocated memory when adding an entry.  */
455 extern struct bfd_hash_entry *bfd_hash_lookup
456   (struct bfd_hash_table *, const char *, bfd_boolean create,
457    bfd_boolean copy);
458
459 /* Replace an entry in a hash table.  */
460 extern void bfd_hash_replace
461   (struct bfd_hash_table *, struct bfd_hash_entry *old,
462    struct bfd_hash_entry *nw);
463
464 /* Base method for creating a hash table entry.  */
465 extern struct bfd_hash_entry *bfd_hash_newfunc
466   (struct bfd_hash_entry *, struct bfd_hash_table *, const char *);
467
468 /* Grab some space for a hash table entry.  */
469 extern void *bfd_hash_allocate
470   (struct bfd_hash_table *, unsigned int);
471
472 /* Traverse a hash table in a random order, calling a function on each
473    element.  If the function returns FALSE, the traversal stops.  The
474    INFO argument is passed to the function.  */
475 extern void bfd_hash_traverse
476   (struct bfd_hash_table *,
477    bfd_boolean (*) (struct bfd_hash_entry *, void *),
478    void *info);
479
480 /* Allows the default size of a hash table to be configured. New hash
481    tables allocated using bfd_hash_table_init will be created with
482    this size.  */
483 extern void bfd_hash_set_default_size (bfd_size_type);
484
485 /* This structure is used to keep track of stabs in sections
486    information while linking.  */
487
488 struct stab_info
489 {
490   /* A hash table used to hold stabs strings.  */
491   struct bfd_strtab_hash *strings;
492   /* The header file hash table.  */
493   struct bfd_hash_table includes;
494   /* The first .stabstr section.  */
495   struct bfd_section *stabstr;
496 };
497
498 #define COFF_SWAP_TABLE (void *) &bfd_coff_std_swap_table
499
500 /* User program access to BFD facilities.  */
501
502 /* Direct I/O routines, for programs which know more about the object
503    file than BFD does.  Use higher level routines if possible.  */
504
505 extern bfd_size_type bfd_bread (void *, bfd_size_type, bfd *);
506 extern bfd_size_type bfd_bwrite (const void *, bfd_size_type, bfd *);
507 extern int bfd_seek (bfd *, file_ptr, int);
508 extern file_ptr bfd_tell (bfd *);
509 extern int bfd_flush (bfd *);
510 extern int bfd_stat (bfd *, struct stat *);
511
512 /* Deprecated old routines.  */
513 #if __GNUC__
514 #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD)                            \
515   (warn_deprecated ("bfd_read", __FILE__, __LINE__, __FUNCTION__),      \
516    bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
517 #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD)                           \
518   (warn_deprecated ("bfd_write", __FILE__, __LINE__, __FUNCTION__),     \
519    bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
520 #else
521 #define bfd_read(BUF, ELTSIZE, NITEMS, ABFD)                            \
522   (warn_deprecated ("bfd_read", (const char *) 0, 0, (const char *) 0), \
523    bfd_bread ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
524 #define bfd_write(BUF, ELTSIZE, NITEMS, ABFD)                           \
525   (warn_deprecated ("bfd_write", (const char *) 0, 0, (const char *) 0),\
526    bfd_bwrite ((BUF), (ELTSIZE) * (NITEMS), (ABFD)))
527 #endif
528 extern void warn_deprecated (const char *, const char *, int, const char *);
529
530 /* Cast from const char * to char * so that caller can assign to
531    a char * without a warning.  */
532 #define bfd_get_filename(abfd) ((char *) (abfd)->filename)
533 #define bfd_get_cacheable(abfd) ((abfd)->cacheable)
534 #define bfd_get_format(abfd) ((abfd)->format)
535 #define bfd_get_target(abfd) ((abfd)->xvec->name)
536 #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
537 #define bfd_family_coff(abfd) \
538   (bfd_get_flavour (abfd) == bfd_target_coff_flavour || \
539    bfd_get_flavour (abfd) == bfd_target_xcoff_flavour)
540 #define bfd_big_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_BIG)
541 #define bfd_little_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_LITTLE)
542 #define bfd_header_big_endian(abfd) \
543   ((abfd)->xvec->header_byteorder == BFD_ENDIAN_BIG)
544 #define bfd_header_little_endian(abfd) \
545   ((abfd)->xvec->header_byteorder == BFD_ENDIAN_LITTLE)
546 #define bfd_get_file_flags(abfd) ((abfd)->flags)
547 #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
548 #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
549 #define bfd_my_archive(abfd) ((abfd)->my_archive)
550 #define bfd_has_map(abfd) ((abfd)->has_armap)
551
552 #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
553 #define bfd_usrdata(abfd) ((abfd)->usrdata)
554
555 #define bfd_get_start_address(abfd) ((abfd)->start_address)
556 #define bfd_get_symcount(abfd) ((abfd)->symcount)
557 #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
558 #define bfd_count_sections(abfd) ((abfd)->section_count)
559
560 #define bfd_get_dynamic_symcount(abfd) ((abfd)->dynsymcount)
561
562 #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
563
564 #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = bool), TRUE)
565
566 extern bfd_boolean bfd_cache_close
567   (bfd *abfd);
568 /* NB: This declaration should match the autogenerated one in libbfd.h.  */
569
570 extern bfd_boolean bfd_cache_close_all (void);
571
572 extern bfd_boolean bfd_record_phdr
573   (bfd *, unsigned long, bfd_boolean, flagword, bfd_boolean, bfd_vma,
574    bfd_boolean, bfd_boolean, unsigned int, struct bfd_section **);
575
576 /* Byte swapping routines.  */
577
578 bfd_uint64_t bfd_getb64 (const void *);
579 bfd_uint64_t bfd_getl64 (const void *);
580 bfd_int64_t bfd_getb_signed_64 (const void *);
581 bfd_int64_t bfd_getl_signed_64 (const void *);
582 bfd_vma bfd_getb32 (const void *);
583 bfd_vma bfd_getl32 (const void *);
584 bfd_signed_vma bfd_getb_signed_32 (const void *);
585 bfd_signed_vma bfd_getl_signed_32 (const void *);
586 bfd_vma bfd_getb16 (const void *);
587 bfd_vma bfd_getl16 (const void *);
588 bfd_signed_vma bfd_getb_signed_16 (const void *);
589 bfd_signed_vma bfd_getl_signed_16 (const void *);
590 void bfd_putb64 (bfd_uint64_t, void *);
591 void bfd_putl64 (bfd_uint64_t, void *);
592 void bfd_putb32 (bfd_vma, void *);
593 void bfd_putl32 (bfd_vma, void *);
594 void bfd_putb16 (bfd_vma, void *);
595 void bfd_putl16 (bfd_vma, void *);
596
597 /* Byte swapping routines which take size and endiannes as arguments.  */
598
599 bfd_uint64_t bfd_get_bits (const void *, int, bfd_boolean);
600 void bfd_put_bits (bfd_uint64_t, void *, int, bfd_boolean);
601
602 extern bfd_boolean bfd_section_already_linked_table_init (void);
603 extern void bfd_section_already_linked_table_free (void);
604 \f
605 /* Externally visible ECOFF routines.  */
606
607 #if defined(__STDC__) || defined(ALMOST_STDC)
608 struct ecoff_debug_info;
609 struct ecoff_debug_swap;
610 struct ecoff_extr;
611 struct bfd_symbol;
612 struct bfd_link_info;
613 struct bfd_link_hash_entry;
614 struct bfd_elf_version_tree;
615 #endif
616 extern bfd_vma bfd_ecoff_get_gp_value
617   (bfd * abfd);
618 extern bfd_boolean bfd_ecoff_set_gp_value
619   (bfd *abfd, bfd_vma gp_value);
620 extern bfd_boolean bfd_ecoff_set_regmasks
621   (bfd *abfd, unsigned long gprmask, unsigned long fprmask,
622    unsigned long *cprmask);
623 extern void *bfd_ecoff_debug_init
624   (bfd *output_bfd, struct ecoff_debug_info *output_debug,
625    const struct ecoff_debug_swap *output_swap, struct bfd_link_info *);
626 extern void bfd_ecoff_debug_free
627   (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
628    const struct ecoff_debug_swap *output_swap, struct bfd_link_info *);
629 extern bfd_boolean bfd_ecoff_debug_accumulate
630   (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
631    const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
632    struct ecoff_debug_info *input_debug,
633    const struct ecoff_debug_swap *input_swap, struct bfd_link_info *);
634 extern bfd_boolean bfd_ecoff_debug_accumulate_other
635   (void *handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
636    const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
637    struct bfd_link_info *);
638 extern bfd_boolean bfd_ecoff_debug_externals
639   (bfd *abfd, struct ecoff_debug_info *debug,
640    const struct ecoff_debug_swap *swap, bfd_boolean relocatable,
641    bfd_boolean (*get_extr) (struct bfd_symbol *, struct ecoff_extr *),
642    void (*set_index) (struct bfd_symbol *, bfd_size_type));
643 extern bfd_boolean bfd_ecoff_debug_one_external
644   (bfd *abfd, struct ecoff_debug_info *debug,
645    const struct ecoff_debug_swap *swap, const char *name,
646    struct ecoff_extr *esym);
647 extern bfd_size_type bfd_ecoff_debug_size
648   (bfd *abfd, struct ecoff_debug_info *debug,
649    const struct ecoff_debug_swap *swap);
650 extern bfd_boolean bfd_ecoff_write_debug
651   (bfd *abfd, struct ecoff_debug_info *debug,
652    const struct ecoff_debug_swap *swap, file_ptr where);
653 extern bfd_boolean bfd_ecoff_write_accumulated_debug
654   (void *handle, bfd *abfd, struct ecoff_debug_info *debug,
655    const struct ecoff_debug_swap *swap,
656    struct bfd_link_info *info, file_ptr where);
657
658 /* Externally visible ELF routines.  */
659
660 struct bfd_link_needed_list
661 {
662   struct bfd_link_needed_list *next;
663   bfd *by;
664   const char *name;
665 };
666
667 enum dynamic_lib_link_class {
668   DYN_NORMAL = 0,
669   DYN_AS_NEEDED = 1,
670   DYN_DT_NEEDED = 2,
671   DYN_NO_ADD_NEEDED = 4,
672   DYN_NO_NEEDED = 8
673 };
674
675 enum notice_asneeded_action {
676   notice_as_needed,
677   notice_not_needed,
678   notice_needed
679 };
680
681 extern bfd_boolean bfd_elf_record_link_assignment
682   (bfd *, struct bfd_link_info *, const char *, bfd_boolean,
683    bfd_boolean);
684 extern struct bfd_link_needed_list *bfd_elf_get_needed_list
685   (bfd *, struct bfd_link_info *);
686 extern bfd_boolean bfd_elf_get_bfd_needed_list
687   (bfd *, struct bfd_link_needed_list **);
688 extern bfd_boolean bfd_elf_size_dynamic_sections
689   (bfd *, const char *, const char *, const char *, const char * const *,
690    struct bfd_link_info *, struct bfd_section **,
691    struct bfd_elf_version_tree *);
692 extern bfd_boolean bfd_elf_size_dynsym_hash_dynstr
693   (bfd *, struct bfd_link_info *);
694 extern void bfd_elf_set_dt_needed_name
695   (bfd *, const char *);
696 extern const char *bfd_elf_get_dt_soname
697   (bfd *);
698 extern void bfd_elf_set_dyn_lib_class
699   (bfd *, enum dynamic_lib_link_class);
700 extern int bfd_elf_get_dyn_lib_class
701   (bfd *);
702 extern struct bfd_link_needed_list *bfd_elf_get_runpath_list
703   (bfd *, struct bfd_link_info *);
704 extern bfd_boolean bfd_elf_discard_info
705   (bfd *, struct bfd_link_info *);
706 extern unsigned int _bfd_elf_default_action_discarded
707   (struct bfd_section *);
708
709 /* Return an upper bound on the number of bytes required to store a
710    copy of ABFD's program header table entries.  Return -1 if an error
711    occurs; bfd_get_error will return an appropriate code.  */
712 extern long bfd_get_elf_phdr_upper_bound
713   (bfd *abfd);
714
715 /* Copy ABFD's program header table entries to *PHDRS.  The entries
716    will be stored as an array of Elf_Internal_Phdr structures, as
717    defined in include/elf/internal.h.  To find out how large the
718    buffer needs to be, call bfd_get_elf_phdr_upper_bound.
719
720    Return the number of program header table entries read, or -1 if an
721    error occurs; bfd_get_error will return an appropriate code.  */
722 extern int bfd_get_elf_phdrs
723   (bfd *abfd, void *phdrs);
724
725 /* Create a new BFD as if by bfd_openr.  Rather than opening a file,
726    reconstruct an ELF file by reading the segments out of remote memory
727    based on the ELF file header at EHDR_VMA and the ELF program headers it
728    points to.  If not null, *LOADBASEP is filled in with the difference
729    between the VMAs from which the segments were read, and the VMAs the
730    file headers (and hence BFD's idea of each section's VMA) put them at.
731
732    The function TARGET_READ_MEMORY is called to copy LEN bytes from the
733    remote memory at target address VMA into the local buffer at MYADDR; it
734    should return zero on success or an `errno' code on failure.  TEMPL must
735    be a BFD for an ELF target with the word size and byte order found in
736    the remote memory.  */
737 extern bfd *bfd_elf_bfd_from_remote_memory
738   (bfd *templ, bfd_vma ehdr_vma, bfd_vma *loadbasep,
739    int (*target_read_memory) (bfd_vma vma, bfd_byte *myaddr, int len));
740
741 /* Return the arch_size field of an elf bfd, or -1 if not elf.  */
742 extern int bfd_get_arch_size
743   (bfd *);
744
745 /* Return TRUE if address "naturally" sign extends, or -1 if not elf.  */
746 extern int bfd_get_sign_extend_vma
747   (bfd *);
748
749 extern struct bfd_section *_bfd_elf_tls_setup
750   (bfd *, struct bfd_link_info *);
751
752 extern void _bfd_fix_excluded_sec_syms
753   (bfd *, struct bfd_link_info *);
754
755 extern unsigned bfd_m68k_mach_to_features (int);
756
757 extern int bfd_m68k_features_to_mach (unsigned);
758
759 extern bfd_boolean bfd_m68k_elf32_create_embedded_relocs
760   (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *,
761    char **);
762
763 extern bfd_boolean bfd_bfin_elf32_create_embedded_relocs
764   (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *,
765    char **);
766
767 /* SunOS shared library support routines for the linker.  */
768
769 extern struct bfd_link_needed_list *bfd_sunos_get_needed_list
770   (bfd *, struct bfd_link_info *);
771 extern bfd_boolean bfd_sunos_record_link_assignment
772   (bfd *, struct bfd_link_info *, const char *);
773 extern bfd_boolean bfd_sunos_size_dynamic_sections
774   (bfd *, struct bfd_link_info *, struct bfd_section **,
775    struct bfd_section **, struct bfd_section **);
776
777 /* Linux shared library support routines for the linker.  */
778
779 extern bfd_boolean bfd_i386linux_size_dynamic_sections
780   (bfd *, struct bfd_link_info *);
781 extern bfd_boolean bfd_m68klinux_size_dynamic_sections
782   (bfd *, struct bfd_link_info *);
783 extern bfd_boolean bfd_sparclinux_size_dynamic_sections
784   (bfd *, struct bfd_link_info *);
785
786 /* mmap hacks */
787
788 struct _bfd_window_internal;
789 typedef struct _bfd_window_internal bfd_window_internal;
790
791 typedef struct _bfd_window
792 {
793   /* What the user asked for.  */
794   void *data;
795   bfd_size_type size;
796   /* The actual window used by BFD.  Small user-requested read-only
797      regions sharing a page may share a single window into the object
798      file.  Read-write versions shouldn't until I've fixed things to
799      keep track of which portions have been claimed by the
800      application; don't want to give the same region back when the
801      application wants two writable copies!  */
802   struct _bfd_window_internal *i;
803 }
804 bfd_window;
805
806 extern void bfd_init_window
807   (bfd_window *);
808 extern void bfd_free_window
809   (bfd_window *);
810 extern bfd_boolean bfd_get_file_window
811   (bfd *, file_ptr, bfd_size_type, bfd_window *, bfd_boolean);
812
813 /* XCOFF support routines for the linker.  */
814
815 extern bfd_boolean bfd_xcoff_link_record_set
816   (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *, bfd_size_type);
817 extern bfd_boolean bfd_xcoff_import_symbol
818   (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *, bfd_vma,
819    const char *, const char *, const char *, unsigned int);
820 extern bfd_boolean bfd_xcoff_export_symbol
821   (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *);
822 extern bfd_boolean bfd_xcoff_link_count_reloc
823   (bfd *, struct bfd_link_info *, const char *);
824 extern bfd_boolean bfd_xcoff_record_link_assignment
825   (bfd *, struct bfd_link_info *, const char *);
826 extern bfd_boolean bfd_xcoff_size_dynamic_sections
827   (bfd *, struct bfd_link_info *, const char *, const char *,
828    unsigned long, unsigned long, unsigned long, bfd_boolean,
829    int, bfd_boolean, bfd_boolean, struct bfd_section **, bfd_boolean);
830 extern bfd_boolean bfd_xcoff_link_generate_rtinit
831   (bfd *, const char *, const char *, bfd_boolean);
832
833 /* XCOFF support routines for ar.  */
834 extern bfd_boolean bfd_xcoff_ar_archive_set_magic
835   (bfd *, char *);
836
837 /* Externally visible COFF routines.  */
838
839 #if defined(__STDC__) || defined(ALMOST_STDC)
840 struct internal_syment;
841 union internal_auxent;
842 #endif
843
844 extern bfd_boolean bfd_coff_get_syment
845   (bfd *, struct bfd_symbol *, struct internal_syment *);
846
847 extern bfd_boolean bfd_coff_get_auxent
848   (bfd *, struct bfd_symbol *, int, union internal_auxent *);
849
850 extern bfd_boolean bfd_coff_set_symbol_class
851   (bfd *, struct bfd_symbol *, unsigned int);
852
853 extern bfd_boolean bfd_m68k_coff_create_embedded_relocs
854   (bfd *, struct bfd_link_info *, struct bfd_section *, struct bfd_section *, char **);
855
856 /* ARM Interworking support.  Called from linker.  */
857 extern bfd_boolean bfd_arm_allocate_interworking_sections
858   (struct bfd_link_info *);
859
860 extern bfd_boolean bfd_arm_process_before_allocation
861   (bfd *, struct bfd_link_info *, int);
862
863 extern bfd_boolean bfd_arm_get_bfd_for_interworking
864   (bfd *, struct bfd_link_info *);
865
866 /* PE ARM Interworking support.  Called from linker.  */
867 extern bfd_boolean bfd_arm_pe_allocate_interworking_sections
868   (struct bfd_link_info *);
869
870 extern bfd_boolean bfd_arm_pe_process_before_allocation
871   (bfd *, struct bfd_link_info *, int);
872
873 extern bfd_boolean bfd_arm_pe_get_bfd_for_interworking
874   (bfd *, struct bfd_link_info *);
875
876 /* ELF ARM Interworking support.  Called from linker.  */
877 extern bfd_boolean bfd_elf32_arm_allocate_interworking_sections
878   (struct bfd_link_info *);
879
880 extern bfd_boolean bfd_elf32_arm_process_before_allocation
881   (bfd *, struct bfd_link_info *);
882
883 void bfd_elf32_arm_set_target_relocs
884   (struct bfd_link_info *, int, char *, int, int);
885
886 extern bfd_boolean bfd_elf32_arm_get_bfd_for_interworking
887   (bfd *, struct bfd_link_info *);
888
889 extern bfd_boolean bfd_elf32_arm_add_glue_sections_to_bfd
890   (bfd *, struct bfd_link_info *);
891
892 /* ELF ARM mapping symbol support */
893 #define BFD_ARM_SPECIAL_SYM_TYPE_MAP    (1 << 0)
894 #define BFD_ARM_SPECIAL_SYM_TYPE_TAG    (1 << 1)
895 #define BFD_ARM_SPECIAL_SYM_TYPE_OTHER  (1 << 2)
896 #define BFD_ARM_SPECIAL_SYM_TYPE_ANY    (~0)
897 extern bfd_boolean bfd_is_arm_special_symbol_name
898   (const char * name, int type);
899
900 extern void bfd_elf32_arm_set_byteswap_code (struct bfd_link_info *, int);
901
902 /* ARM Note section processing.  */
903 extern bfd_boolean bfd_arm_merge_machines
904   (bfd *, bfd *);
905
906 extern bfd_boolean bfd_arm_update_notes
907   (bfd *, const char *);
908
909 extern unsigned int bfd_arm_get_mach_from_notes
910   (bfd *, const char *);
911
912 /* TI COFF load page support.  */
913 extern void bfd_ticoff_set_section_load_page
914   (struct bfd_section *, int);
915
916 extern int bfd_ticoff_get_section_load_page
917   (struct bfd_section *);
918
919 /* H8/300 functions.  */
920 extern bfd_vma bfd_h8300_pad_address
921   (bfd *, bfd_vma);
922
923 /* IA64 Itanium code generation.  Called from linker.  */
924 extern void bfd_elf32_ia64_after_parse
925   (int);
926
927 extern void bfd_elf64_ia64_after_parse
928   (int);
929
930 /* This structure is used for a comdat section, as in PE.  A comdat
931    section is associated with a particular symbol.  When the linker
932    sees a comdat section, it keeps only one of the sections with a
933    given name and associated with a given symbol.  */
934
935 struct coff_comdat_info
936 {
937   /* The name of the symbol associated with a comdat section.  */
938   const char *name;
939
940   /* The local symbol table index of the symbol associated with a
941      comdat section.  This is only meaningful to the object file format
942      specific code; it is not an index into the list returned by
943      bfd_canonicalize_symtab.  */
944   long symbol;
945 };
946
947 extern struct coff_comdat_info *bfd_coff_get_comdat_section
948   (bfd *, struct bfd_section *);
949
950 /* Extracted from init.c.  */
951 void bfd_init (void);
952
953 /* Extracted from opncls.c.  */
954 bfd *bfd_fopen (const char *filename, const char *target,
955     const char *mode, int fd);
956
957 bfd *bfd_openr (const char *filename, const char *target);
958
959 bfd *bfd_fdopenr (const char *filename, const char *target, int fd);
960
961 bfd *bfd_openstreamr (const char *, const char *, void *);
962
963 bfd *bfd_openr_iovec (const char *filename, const char *target,
964     void *(*open) (struct bfd *nbfd,
965     void *open_closure),
966     void *open_closure,
967     file_ptr (*pread) (struct bfd *nbfd,
968     void *stream,
969     void *buf,
970     file_ptr nbytes,
971     file_ptr offset),
972     int (*close) (struct bfd *nbfd,
973     void *stream),
974     int (*stat) (struct bfd *abfd,
975     void *stream,
976     struct stat *sb));
977
978 bfd *bfd_openw (const char *filename, const char *target);
979
980 bfd_boolean bfd_close (bfd *abfd);
981
982 bfd_boolean bfd_close_all_done (bfd *);
983
984 bfd *bfd_create (const char *filename, bfd *templ);
985
986 bfd_boolean bfd_make_writable (bfd *abfd);
987
988 bfd_boolean bfd_make_readable (bfd *abfd);
989
990 unsigned long bfd_calc_gnu_debuglink_crc32
991    (unsigned long crc, const unsigned char *buf, bfd_size_type len);
992
993 char *bfd_follow_gnu_debuglink (bfd *abfd, const char *dir);
994
995 struct bfd_section *bfd_create_gnu_debuglink_section
996    (bfd *abfd, const char *filename);
997
998 bfd_boolean bfd_fill_in_gnu_debuglink_section
999    (bfd *abfd, struct bfd_section *sect, const char *filename);
1000
1001 /* Extracted from libbfd.c.  */
1002
1003 /* Byte swapping macros for user section data.  */
1004
1005 #define bfd_put_8(abfd, val, ptr) \
1006   ((void) (*((unsigned char *) (ptr)) = (val) & 0xff))
1007 #define bfd_put_signed_8 \
1008   bfd_put_8
1009 #define bfd_get_8(abfd, ptr) \
1010   (*(unsigned char *) (ptr) & 0xff)
1011 #define bfd_get_signed_8(abfd, ptr) \
1012   (((*(unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
1013
1014 #define bfd_put_16(abfd, val, ptr) \
1015   BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
1016 #define bfd_put_signed_16 \
1017   bfd_put_16
1018 #define bfd_get_16(abfd, ptr) \
1019   BFD_SEND (abfd, bfd_getx16, (ptr))
1020 #define bfd_get_signed_16(abfd, ptr) \
1021   BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
1022
1023 #define bfd_put_32(abfd, val, ptr) \
1024   BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
1025 #define bfd_put_signed_32 \
1026   bfd_put_32
1027 #define bfd_get_32(abfd, ptr) \
1028   BFD_SEND (abfd, bfd_getx32, (ptr))
1029 #define bfd_get_signed_32(abfd, ptr) \
1030   BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
1031
1032 #define bfd_put_64(abfd, val, ptr) \
1033   BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
1034 #define bfd_put_signed_64 \
1035   bfd_put_64
1036 #define bfd_get_64(abfd, ptr) \
1037   BFD_SEND (abfd, bfd_getx64, (ptr))
1038 #define bfd_get_signed_64(abfd, ptr) \
1039   BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
1040
1041 #define bfd_get(bits, abfd, ptr)                       \
1042   ((bits) == 8 ? (bfd_vma) bfd_get_8 (abfd, ptr)       \
1043    : (bits) == 16 ? bfd_get_16 (abfd, ptr)             \
1044    : (bits) == 32 ? bfd_get_32 (abfd, ptr)             \
1045    : (bits) == 64 ? bfd_get_64 (abfd, ptr)             \
1046    : (abort (), (bfd_vma) - 1))
1047
1048 #define bfd_put(bits, abfd, val, ptr)                  \
1049   ((bits) == 8 ? bfd_put_8  (abfd, val, ptr)           \
1050    : (bits) == 16 ? bfd_put_16 (abfd, val, ptr)                \
1051    : (bits) == 32 ? bfd_put_32 (abfd, val, ptr)                \
1052    : (bits) == 64 ? bfd_put_64 (abfd, val, ptr)                \
1053    : (abort (), (void) 0))
1054
1055
1056 /* Byte swapping macros for file header data.  */
1057
1058 #define bfd_h_put_8(abfd, val, ptr) \
1059   bfd_put_8 (abfd, val, ptr)
1060 #define bfd_h_put_signed_8(abfd, val, ptr) \
1061   bfd_put_8 (abfd, val, ptr)
1062 #define bfd_h_get_8(abfd, ptr) \
1063   bfd_get_8 (abfd, ptr)
1064 #define bfd_h_get_signed_8(abfd, ptr) \
1065   bfd_get_signed_8 (abfd, ptr)
1066
1067 #define bfd_h_put_16(abfd, val, ptr) \
1068   BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
1069 #define bfd_h_put_signed_16 \
1070   bfd_h_put_16
1071 #define bfd_h_get_16(abfd, ptr) \
1072   BFD_SEND (abfd, bfd_h_getx16, (ptr))
1073 #define bfd_h_get_signed_16(abfd, ptr) \
1074   BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
1075
1076 #define bfd_h_put_32(abfd, val, ptr) \
1077   BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
1078 #define bfd_h_put_signed_32 \
1079   bfd_h_put_32
1080 #define bfd_h_get_32(abfd, ptr) \
1081   BFD_SEND (abfd, bfd_h_getx32, (ptr))
1082 #define bfd_h_get_signed_32(abfd, ptr) \
1083   BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
1084
1085 #define bfd_h_put_64(abfd, val, ptr) \
1086   BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
1087 #define bfd_h_put_signed_64 \
1088   bfd_h_put_64
1089 #define bfd_h_get_64(abfd, ptr) \
1090   BFD_SEND (abfd, bfd_h_getx64, (ptr))
1091 #define bfd_h_get_signed_64(abfd, ptr) \
1092   BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
1093
1094 /* Aliases for the above, which should eventually go away.  */
1095
1096 #define H_PUT_64  bfd_h_put_64
1097 #define H_PUT_32  bfd_h_put_32
1098 #define H_PUT_16  bfd_h_put_16
1099 #define H_PUT_8   bfd_h_put_8
1100 #define H_PUT_S64 bfd_h_put_signed_64
1101 #define H_PUT_S32 bfd_h_put_signed_32
1102 #define H_PUT_S16 bfd_h_put_signed_16
1103 #define H_PUT_S8  bfd_h_put_signed_8
1104 #define H_GET_64  bfd_h_get_64
1105 #define H_GET_32  bfd_h_get_32
1106 #define H_GET_16  bfd_h_get_16
1107 #define H_GET_8   bfd_h_get_8
1108 #define H_GET_S64 bfd_h_get_signed_64
1109 #define H_GET_S32 bfd_h_get_signed_32
1110 #define H_GET_S16 bfd_h_get_signed_16
1111 #define H_GET_S8  bfd_h_get_signed_8
1112
1113
1114 /* Extracted from bfdio.c.  */
1115 long bfd_get_mtime (bfd *abfd);
1116
1117 file_ptr bfd_get_size (bfd *abfd);
1118
1119 /* Extracted from bfdwin.c.  */
1120 /* Extracted from section.c.  */
1121 typedef struct bfd_section
1122 {
1123   /* The name of the section; the name isn't a copy, the pointer is
1124      the same as that passed to bfd_make_section.  */
1125   const char *name;
1126
1127   /* A unique sequence number.  */
1128   int id;
1129
1130   /* Which section in the bfd; 0..n-1 as sections are created in a bfd.  */
1131   int index;
1132
1133   /* The next section in the list belonging to the BFD, or NULL.  */
1134   struct bfd_section *next;
1135
1136   /* The previous section in the list belonging to the BFD, or NULL.  */
1137   struct bfd_section *prev;
1138
1139   /* The field flags contains attributes of the section. Some
1140      flags are read in from the object file, and some are
1141      synthesized from other information.  */
1142   flagword flags;
1143
1144 #define SEC_NO_FLAGS   0x000
1145
1146   /* Tells the OS to allocate space for this section when loading.
1147      This is clear for a section containing debug information only.  */
1148 #define SEC_ALLOC      0x001
1149
1150   /* Tells the OS to load the section from the file when loading.
1151      This is clear for a .bss section.  */
1152 #define SEC_LOAD       0x002
1153
1154   /* The section contains data still to be relocated, so there is
1155      some relocation information too.  */
1156 #define SEC_RELOC      0x004
1157
1158   /* A signal to the OS that the section contains read only data.  */
1159 #define SEC_READONLY   0x008
1160
1161   /* The section contains code only.  */
1162 #define SEC_CODE       0x010
1163
1164   /* The section contains data only.  */
1165 #define SEC_DATA       0x020
1166
1167   /* The section will reside in ROM.  */
1168 #define SEC_ROM        0x040
1169
1170   /* The section contains constructor information. This section
1171      type is used by the linker to create lists of constructors and
1172      destructors used by <<g++>>. When a back end sees a symbol
1173      which should be used in a constructor list, it creates a new
1174      section for the type of name (e.g., <<__CTOR_LIST__>>), attaches
1175      the symbol to it, and builds a relocation. To build the lists
1176      of constructors, all the linker has to do is catenate all the
1177      sections called <<__CTOR_LIST__>> and relocate the data
1178      contained within - exactly the operations it would peform on
1179      standard data.  */
1180 #define SEC_CONSTRUCTOR 0x080
1181
1182   /* The section has contents - a data section could be
1183      <<SEC_ALLOC>> | <<SEC_HAS_CONTENTS>>; a debug section could be
1184      <<SEC_HAS_CONTENTS>>  */
1185 #define SEC_HAS_CONTENTS 0x100
1186
1187   /* An instruction to the linker to not output the section
1188      even if it has information which would normally be written.  */
1189 #define SEC_NEVER_LOAD 0x200
1190
1191   /* The section contains thread local data.  */
1192 #define SEC_THREAD_LOCAL 0x400
1193
1194   /* The section has GOT references.  This flag is only for the
1195      linker, and is currently only used by the elf32-hppa back end.
1196      It will be set if global offset table references were detected
1197      in this section, which indicate to the linker that the section
1198      contains PIC code, and must be handled specially when doing a
1199      static link.  */
1200 #define SEC_HAS_GOT_REF 0x800
1201
1202   /* The section contains common symbols (symbols may be defined
1203      multiple times, the value of a symbol is the amount of
1204      space it requires, and the largest symbol value is the one
1205      used).  Most targets have exactly one of these (which we
1206      translate to bfd_com_section_ptr), but ECOFF has two.  */
1207 #define SEC_IS_COMMON 0x1000
1208
1209   /* The section contains only debugging information.  For
1210      example, this is set for ELF .debug and .stab sections.
1211      strip tests this flag to see if a section can be
1212      discarded.  */
1213 #define SEC_DEBUGGING 0x2000
1214
1215   /* The contents of this section are held in memory pointed to
1216      by the contents field.  This is checked by bfd_get_section_contents,
1217      and the data is retrieved from memory if appropriate.  */
1218 #define SEC_IN_MEMORY 0x4000
1219
1220   /* The contents of this section are to be excluded by the
1221      linker for executable and shared objects unless those
1222      objects are to be further relocated.  */
1223 #define SEC_EXCLUDE 0x8000
1224
1225   /* The contents of this section are to be sorted based on the sum of
1226      the symbol and addend values specified by the associated relocation
1227      entries.  Entries without associated relocation entries will be
1228      appended to the end of the section in an unspecified order.  */
1229 #define SEC_SORT_ENTRIES 0x10000
1230
1231   /* When linking, duplicate sections of the same name should be
1232      discarded, rather than being combined into a single section as
1233      is usually done.  This is similar to how common symbols are
1234      handled.  See SEC_LINK_DUPLICATES below.  */
1235 #define SEC_LINK_ONCE 0x20000
1236
1237   /* If SEC_LINK_ONCE is set, this bitfield describes how the linker
1238      should handle duplicate sections.  */
1239 #define SEC_LINK_DUPLICATES 0x40000
1240
1241   /* This value for SEC_LINK_DUPLICATES means that duplicate
1242      sections with the same name should simply be discarded.  */
1243 #define SEC_LINK_DUPLICATES_DISCARD 0x0
1244
1245   /* This value for SEC_LINK_DUPLICATES means that the linker
1246      should warn if there are any duplicate sections, although
1247      it should still only link one copy.  */
1248 #define SEC_LINK_DUPLICATES_ONE_ONLY 0x80000
1249
1250   /* This value for SEC_LINK_DUPLICATES means that the linker
1251      should warn if any duplicate sections are a different size.  */
1252 #define SEC_LINK_DUPLICATES_SAME_SIZE 0x100000
1253
1254   /* This value for SEC_LINK_DUPLICATES means that the linker
1255      should warn if any duplicate sections contain different
1256      contents.  */
1257 #define SEC_LINK_DUPLICATES_SAME_CONTENTS \
1258   (SEC_LINK_DUPLICATES_ONE_ONLY | SEC_LINK_DUPLICATES_SAME_SIZE)
1259
1260   /* This section was created by the linker as part of dynamic
1261      relocation or other arcane processing.  It is skipped when
1262      going through the first-pass output, trusting that someone
1263      else up the line will take care of it later.  */
1264 #define SEC_LINKER_CREATED 0x200000
1265
1266   /* This section should not be subject to garbage collection.
1267      Also set to inform the linker that this section should not be
1268      listed in the link map as discarded.  */
1269 #define SEC_KEEP 0x400000
1270
1271   /* This section contains "short" data, and should be placed
1272      "near" the GP.  */
1273 #define SEC_SMALL_DATA 0x800000
1274
1275   /* Attempt to merge identical entities in the section.
1276      Entity size is given in the entsize field.  */
1277 #define SEC_MERGE 0x1000000
1278
1279   /* If given with SEC_MERGE, entities to merge are zero terminated
1280      strings where entsize specifies character size instead of fixed
1281      size entries.  */
1282 #define SEC_STRINGS 0x2000000
1283
1284   /* This section contains data about section groups.  */
1285 #define SEC_GROUP 0x4000000
1286
1287   /* The section is a COFF shared library section.  This flag is
1288      only for the linker.  If this type of section appears in
1289      the input file, the linker must copy it to the output file
1290      without changing the vma or size.  FIXME: Although this
1291      was originally intended to be general, it really is COFF
1292      specific (and the flag was renamed to indicate this).  It
1293      might be cleaner to have some more general mechanism to
1294      allow the back end to control what the linker does with
1295      sections.  */
1296 #define SEC_COFF_SHARED_LIBRARY 0x10000000
1297
1298   /* This section contains data which may be shared with other
1299      executables or shared objects. This is for COFF only.  */
1300 #define SEC_COFF_SHARED 0x20000000
1301
1302   /* When a section with this flag is being linked, then if the size of
1303      the input section is less than a page, it should not cross a page
1304      boundary.  If the size of the input section is one page or more,
1305      it should be aligned on a page boundary.  This is for TI
1306      TMS320C54X only.  */
1307 #define SEC_TIC54X_BLOCK 0x40000000
1308
1309   /* Conditionally link this section; do not link if there are no
1310      references found to any symbol in the section.  This is for TI
1311      TMS320C54X only.  */
1312 #define SEC_TIC54X_CLINK 0x80000000
1313
1314   /*  End of section flags.  */
1315
1316   /* Some internal packed boolean fields.  */
1317
1318   /* See the vma field.  */
1319   unsigned int user_set_vma : 1;
1320
1321   /* A mark flag used by some of the linker backends.  */
1322   unsigned int linker_mark : 1;
1323
1324   /* Another mark flag used by some of the linker backends.  Set for
1325      output sections that have an input section.  */
1326   unsigned int linker_has_input : 1;
1327
1328   /* Mark flags used by some linker backends for garbage collection.  */
1329   unsigned int gc_mark : 1;
1330   unsigned int gc_mark_from_eh : 1;
1331
1332   /* The following flags are used by the ELF linker. */
1333
1334   /* Mark sections which have been allocated to segments.  */
1335   unsigned int segment_mark : 1;
1336
1337   /* Type of sec_info information.  */
1338   unsigned int sec_info_type:3;
1339 #define ELF_INFO_TYPE_NONE      0
1340 #define ELF_INFO_TYPE_STABS     1
1341 #define ELF_INFO_TYPE_MERGE     2
1342 #define ELF_INFO_TYPE_EH_FRAME  3
1343 #define ELF_INFO_TYPE_JUST_SYMS 4
1344
1345   /* Nonzero if this section uses RELA relocations, rather than REL.  */
1346   unsigned int use_rela_p:1;
1347
1348   /* Bits used by various backends.  The generic code doesn't touch
1349      these fields.  */
1350
1351   /* Nonzero if this section has TLS related relocations.  */
1352   unsigned int has_tls_reloc:1;
1353
1354   /* Nonzero if this section has a gp reloc.  */
1355   unsigned int has_gp_reloc:1;
1356
1357   /* Nonzero if this section needs the relax finalize pass.  */
1358   unsigned int need_finalize_relax:1;
1359
1360   /* Whether relocations have been processed.  */
1361   unsigned int reloc_done : 1;
1362
1363   /* End of internal packed boolean fields.  */
1364
1365   /*  The virtual memory address of the section - where it will be
1366       at run time.  The symbols are relocated against this.  The
1367       user_set_vma flag is maintained by bfd; if it's not set, the
1368       backend can assign addresses (for example, in <<a.out>>, where
1369       the default address for <<.data>> is dependent on the specific
1370       target and various flags).  */
1371   bfd_vma vma;
1372
1373   /*  The load address of the section - where it would be in a
1374       rom image; really only used for writing section header
1375       information.  */
1376   bfd_vma lma;
1377
1378   /* The size of the section in octets, as it will be output.
1379      Contains a value even if the section has no contents (e.g., the
1380      size of <<.bss>>).  */
1381   bfd_size_type size;
1382
1383   /* For input sections, the original size on disk of the section, in
1384      octets.  This field is used by the linker relaxation code.  It is
1385      currently only set for sections where the linker relaxation scheme
1386      doesn't cache altered section and reloc contents (stabs, eh_frame,
1387      SEC_MERGE, some coff relaxing targets), and thus the original size
1388      needs to be kept to read the section multiple times.
1389      For output sections, rawsize holds the section size calculated on
1390      a previous linker relaxation pass.  */
1391   bfd_size_type rawsize;
1392
1393   /* If this section is going to be output, then this value is the
1394      offset in *bytes* into the output section of the first byte in the
1395      input section (byte ==> smallest addressable unit on the
1396      target).  In most cases, if this was going to start at the
1397      100th octet (8-bit quantity) in the output section, this value
1398      would be 100.  However, if the target byte size is 16 bits
1399      (bfd_octets_per_byte is "2"), this value would be 50.  */
1400   bfd_vma output_offset;
1401
1402   /* The output section through which to map on output.  */
1403   struct bfd_section *output_section;
1404
1405   /* The alignment requirement of the section, as an exponent of 2 -
1406      e.g., 3 aligns to 2^3 (or 8).  */
1407   unsigned int alignment_power;
1408
1409   /* If an input section, a pointer to a vector of relocation
1410      records for the data in this section.  */
1411   struct reloc_cache_entry *relocation;
1412
1413   /* If an output section, a pointer to a vector of pointers to
1414      relocation records for the data in this section.  */
1415   struct reloc_cache_entry **orelocation;
1416
1417   /* The number of relocation records in one of the above.  */
1418   unsigned reloc_count;
1419
1420   /* Information below is back end specific - and not always used
1421      or updated.  */
1422
1423   /* File position of section data.  */
1424   file_ptr filepos;
1425
1426   /* File position of relocation info.  */
1427   file_ptr rel_filepos;
1428
1429   /* File position of line data.  */
1430   file_ptr line_filepos;
1431
1432   /* Pointer to data for applications.  */
1433   void *userdata;
1434
1435   /* If the SEC_IN_MEMORY flag is set, this points to the actual
1436      contents.  */
1437   unsigned char *contents;
1438
1439   /* Attached line number information.  */
1440   alent *lineno;
1441
1442   /* Number of line number records.  */
1443   unsigned int lineno_count;
1444
1445   /* Entity size for merging purposes.  */
1446   unsigned int entsize;
1447
1448   /* Points to the kept section if this section is a link-once section,
1449      and is discarded.  */
1450   struct bfd_section *kept_section;
1451
1452   /* When a section is being output, this value changes as more
1453      linenumbers are written out.  */
1454   file_ptr moving_line_filepos;
1455
1456   /* What the section number is in the target world.  */
1457   int target_index;
1458
1459   void *used_by_bfd;
1460
1461   /* If this is a constructor section then here is a list of the
1462      relocations created to relocate items within it.  */
1463   struct relent_chain *constructor_chain;
1464
1465   /* The BFD which owns the section.  */
1466   bfd *owner;
1467
1468   /* A symbol which points at this section only.  */
1469   struct bfd_symbol *symbol;
1470   struct bfd_symbol **symbol_ptr_ptr;
1471
1472   /* Early in the link process, map_head and map_tail are used to build
1473      a list of input sections attached to an output section.  Later,
1474      output sections use these fields for a list of bfd_link_order
1475      structs.  */
1476   union {
1477     struct bfd_link_order *link_order;
1478     struct bfd_section *s;
1479   } map_head, map_tail;
1480 } asection;
1481
1482 /* These sections are global, and are managed by BFD.  The application
1483    and target back end are not permitted to change the values in
1484    these sections.  New code should use the section_ptr macros rather
1485    than referring directly to the const sections.  The const sections
1486    may eventually vanish.  */
1487 #define BFD_ABS_SECTION_NAME "*ABS*"
1488 #define BFD_UND_SECTION_NAME "*UND*"
1489 #define BFD_COM_SECTION_NAME "*COM*"
1490 #define BFD_IND_SECTION_NAME "*IND*"
1491
1492 /* The absolute section.  */
1493 extern asection bfd_abs_section;
1494 #define bfd_abs_section_ptr ((asection *) &bfd_abs_section)
1495 #define bfd_is_abs_section(sec) ((sec) == bfd_abs_section_ptr)
1496 /* Pointer to the undefined section.  */
1497 extern asection bfd_und_section;
1498 #define bfd_und_section_ptr ((asection *) &bfd_und_section)
1499 #define bfd_is_und_section(sec) ((sec) == bfd_und_section_ptr)
1500 /* Pointer to the common section.  */
1501 extern asection bfd_com_section;
1502 #define bfd_com_section_ptr ((asection *) &bfd_com_section)
1503 /* Pointer to the indirect section.  */
1504 extern asection bfd_ind_section;
1505 #define bfd_ind_section_ptr ((asection *) &bfd_ind_section)
1506 #define bfd_is_ind_section(sec) ((sec) == bfd_ind_section_ptr)
1507
1508 #define bfd_is_const_section(SEC)              \
1509  (   ((SEC) == bfd_abs_section_ptr)            \
1510   || ((SEC) == bfd_und_section_ptr)            \
1511   || ((SEC) == bfd_com_section_ptr)            \
1512   || ((SEC) == bfd_ind_section_ptr))
1513
1514 /* Macros to handle insertion and deletion of a bfd's sections.  These
1515    only handle the list pointers, ie. do not adjust section_count,
1516    target_index etc.  */
1517 #define bfd_section_list_remove(ABFD, S) \
1518   do                                                   \
1519     {                                                  \
1520       asection *_s = S;                                \
1521       asection *_next = _s->next;                      \
1522       asection *_prev = _s->prev;                      \
1523       if (_prev)                                       \
1524         _prev->next = _next;                           \
1525       else                                             \
1526         (ABFD)->sections = _next;                      \
1527       if (_next)                                       \
1528         _next->prev = _prev;                           \
1529       else                                             \
1530         (ABFD)->section_last = _prev;                  \
1531     }                                                  \
1532   while (0)
1533 #define bfd_section_list_append(ABFD, S) \
1534   do                                                   \
1535     {                                                  \
1536       asection *_s = S;                                \
1537       bfd *_abfd = ABFD;                               \
1538       _s->next = NULL;                                 \
1539       if (_abfd->section_last)                         \
1540         {                                              \
1541           _s->prev = _abfd->section_last;              \
1542           _abfd->section_last->next = _s;              \
1543         }                                              \
1544       else                                             \
1545         {                                              \
1546           _s->prev = NULL;                             \
1547           _abfd->sections = _s;                        \
1548         }                                              \
1549       _abfd->section_last = _s;                        \
1550     }                                                  \
1551   while (0)
1552 #define bfd_section_list_prepend(ABFD, S) \
1553   do                                                   \
1554     {                                                  \
1555       asection *_s = S;                                \
1556       bfd *_abfd = ABFD;                               \
1557       _s->prev = NULL;                                 \
1558       if (_abfd->sections)                             \
1559         {                                              \
1560           _s->next = _abfd->sections;                  \
1561           _abfd->sections->prev = _s;                  \
1562         }                                              \
1563       else                                             \
1564         {                                              \
1565           _s->next = NULL;                             \
1566           _abfd->section_last = _s;                    \
1567         }                                              \
1568       _abfd->sections = _s;                            \
1569     }                                                  \
1570   while (0)
1571 #define bfd_section_list_insert_after(ABFD, A, S) \
1572   do                                                   \
1573     {                                                  \
1574       asection *_a = A;                                \
1575       asection *_s = S;                                \
1576       asection *_next = _a->next;                      \
1577       _s->next = _next;                                \
1578       _s->prev = _a;                                   \
1579       _a->next = _s;                                   \
1580       if (_next)                                       \
1581         _next->prev = _s;                              \
1582       else                                             \
1583         (ABFD)->section_last = _s;                     \
1584     }                                                  \
1585   while (0)
1586 #define bfd_section_list_insert_before(ABFD, B, S) \
1587   do                                                   \
1588     {                                                  \
1589       asection *_b = B;                                \
1590       asection *_s = S;                                \
1591       asection *_prev = _b->prev;                      \
1592       _s->prev = _prev;                                \
1593       _s->next = _b;                                   \
1594       _b->prev = _s;                                   \
1595       if (_prev)                                       \
1596         _prev->next = _s;                              \
1597       else                                             \
1598         (ABFD)->sections = _s;                         \
1599     }                                                  \
1600   while (0)
1601 #define bfd_section_removed_from_list(ABFD, S) \
1602   ((S)->next == NULL ? (ABFD)->section_last != (S) : (S)->next->prev != (S))
1603
1604 #define BFD_FAKE_SECTION(SEC, FLAGS, SYM, NAME, IDX)                   \
1605   /* name, id,  index, next, prev, flags, user_set_vma,            */  \
1606   { NAME,  IDX, 0,     NULL, NULL, FLAGS, 0,                           \
1607                                                                        \
1608   /* linker_mark, linker_has_input, gc_mark, gc_mark_from_eh,      */  \
1609      0,           0,                1,       0,                        \
1610                                                                        \
1611   /* segment_mark, sec_info_type, use_rela_p, has_tls_reloc,       */  \
1612      0,            0,             0,          0,                       \
1613                                                                        \
1614   /* has_gp_reloc, need_finalize_relax, reloc_done,                */  \
1615      0,            0,                   0,                             \
1616                                                                        \
1617   /* vma, lma, size, rawsize                                       */  \
1618      0,   0,   0,    0,                                                \
1619                                                                        \
1620   /* output_offset, output_section,              alignment_power,  */  \
1621      0,             (struct bfd_section *) &SEC, 0,                    \
1622                                                                        \
1623   /* relocation, orelocation, reloc_count, filepos, rel_filepos,   */  \
1624      NULL,       NULL,        0,           0,       0,                 \
1625                                                                        \
1626   /* line_filepos, userdata, contents, lineno, lineno_count,       */  \
1627      0,            NULL,     NULL,     NULL,   0,                      \
1628                                                                        \
1629   /* entsize, kept_section, moving_line_filepos,                    */ \
1630      0,       NULL,          0,                                        \
1631                                                                        \
1632   /* target_index, used_by_bfd, constructor_chain, owner,          */  \
1633      0,            NULL,        NULL,              NULL,               \
1634                                                                        \
1635   /* symbol,                    symbol_ptr_ptr,                    */  \
1636      (struct bfd_symbol *) SYM, &SEC.symbol,                           \
1637                                                                        \
1638   /* map_head, map_tail                                            */  \
1639      { NULL }, { NULL }                                                \
1640     }
1641
1642 void bfd_section_list_clear (bfd *);
1643
1644 asection *bfd_get_section_by_name (bfd *abfd, const char *name);
1645
1646 asection *bfd_get_section_by_name_if
1647    (bfd *abfd,
1648     const char *name,
1649     bfd_boolean (*func) (bfd *abfd, asection *sect, void *obj),
1650     void *obj);
1651
1652 char *bfd_get_unique_section_name
1653    (bfd *abfd, const char *templat, int *count);
1654
1655 asection *bfd_make_section_old_way (bfd *abfd, const char *name);
1656
1657 asection *bfd_make_section_anyway_with_flags
1658    (bfd *abfd, const char *name, flagword flags);
1659
1660 asection *bfd_make_section_anyway (bfd *abfd, const char *name);
1661
1662 asection *bfd_make_section_with_flags
1663    (bfd *, const char *name, flagword flags);
1664
1665 asection *bfd_make_section (bfd *, const char *name);
1666
1667 bfd_boolean bfd_set_section_flags
1668    (bfd *abfd, asection *sec, flagword flags);
1669
1670 void bfd_map_over_sections
1671    (bfd *abfd,
1672     void (*func) (bfd *abfd, asection *sect, void *obj),
1673     void *obj);
1674
1675 asection *bfd_sections_find_if
1676    (bfd *abfd,
1677     bfd_boolean (*operation) (bfd *abfd, asection *sect, void *obj),
1678     void *obj);
1679
1680 bfd_boolean bfd_set_section_size
1681    (bfd *abfd, asection *sec, bfd_size_type val);
1682
1683 bfd_boolean bfd_set_section_contents
1684    (bfd *abfd, asection *section, const void *data,
1685     file_ptr offset, bfd_size_type count);
1686
1687 bfd_boolean bfd_get_section_contents
1688    (bfd *abfd, asection *section, void *location, file_ptr offset,
1689     bfd_size_type count);
1690
1691 bfd_boolean bfd_malloc_and_get_section
1692    (bfd *abfd, asection *section, bfd_byte **buf);
1693
1694 bfd_boolean bfd_copy_private_section_data
1695    (bfd *ibfd, asection *isec, bfd *obfd, asection *osec);
1696
1697 #define bfd_copy_private_section_data(ibfd, isection, obfd, osection) \
1698      BFD_SEND (obfd, _bfd_copy_private_section_data, \
1699                (ibfd, isection, obfd, osection))
1700 bfd_boolean bfd_generic_is_group_section (bfd *, const asection *sec);
1701
1702 bfd_boolean bfd_generic_discard_group (bfd *abfd, asection *group);
1703
1704 /* Extracted from archures.c.  */
1705 enum bfd_architecture
1706 {
1707   bfd_arch_unknown,   /* File arch not known.  */
1708   bfd_arch_obscure,   /* Arch known, not one of these.  */
1709   bfd_arch_m68k,      /* Motorola 68xxx */
1710 #define bfd_mach_m68000 1
1711 #define bfd_mach_m68008 2
1712 #define bfd_mach_m68010 3
1713 #define bfd_mach_m68020 4
1714 #define bfd_mach_m68030 5
1715 #define bfd_mach_m68040 6
1716 #define bfd_mach_m68060 7
1717 #define bfd_mach_cpu32  8
1718 #define bfd_mach_mcf_isa_a_nodiv 9
1719 #define bfd_mach_mcf_isa_a 10
1720 #define bfd_mach_mcf_isa_a_mac 11
1721 #define bfd_mach_mcf_isa_a_emac 12
1722 #define bfd_mach_mcf_isa_aplus 13
1723 #define bfd_mach_mcf_isa_aplus_mac 14
1724 #define bfd_mach_mcf_isa_aplus_emac 15
1725 #define bfd_mach_mcf_isa_b_nousp 16
1726 #define bfd_mach_mcf_isa_b_nousp_mac 17
1727 #define bfd_mach_mcf_isa_b_nousp_emac 18
1728 #define bfd_mach_mcf_isa_b 19
1729 #define bfd_mach_mcf_isa_b_mac 20
1730 #define bfd_mach_mcf_isa_b_emac 21
1731 #define bfd_mach_mcf_isa_b_float 22
1732 #define bfd_mach_mcf_isa_b_float_mac 23
1733 #define bfd_mach_mcf_isa_b_float_emac 24
1734   bfd_arch_vax,       /* DEC Vax */
1735   bfd_arch_i960,      /* Intel 960 */
1736     /* The order of the following is important.
1737        lower number indicates a machine type that
1738        only accepts a subset of the instructions
1739        available to machines with higher numbers.
1740        The exception is the "ca", which is
1741        incompatible with all other machines except
1742        "core".  */
1743
1744 #define bfd_mach_i960_core      1
1745 #define bfd_mach_i960_ka_sa     2
1746 #define bfd_mach_i960_kb_sb     3
1747 #define bfd_mach_i960_mc        4
1748 #define bfd_mach_i960_xa        5
1749 #define bfd_mach_i960_ca        6
1750 #define bfd_mach_i960_jx        7
1751 #define bfd_mach_i960_hx        8
1752
1753   bfd_arch_or32,      /* OpenRISC 32 */
1754
1755   bfd_arch_sparc,     /* SPARC */
1756 #define bfd_mach_sparc                 1
1757 /* The difference between v8plus and v9 is that v9 is a true 64 bit env.  */
1758 #define bfd_mach_sparc_sparclet        2
1759 #define bfd_mach_sparc_sparclite       3
1760 #define bfd_mach_sparc_v8plus          4
1761 #define bfd_mach_sparc_v8plusa         5 /* with ultrasparc add'ns.  */
1762 #define bfd_mach_sparc_sparclite_le    6
1763 #define bfd_mach_sparc_v9              7
1764 #define bfd_mach_sparc_v9a             8 /* with ultrasparc add'ns.  */
1765 #define bfd_mach_sparc_v8plusb         9 /* with cheetah add'ns.  */
1766 #define bfd_mach_sparc_v9b             10 /* with cheetah add'ns.  */
1767 /* Nonzero if MACH has the v9 instruction set.  */
1768 #define bfd_mach_sparc_v9_p(mach) \
1769   ((mach) >= bfd_mach_sparc_v8plus && (mach) <= bfd_mach_sparc_v9b \
1770    && (mach) != bfd_mach_sparc_sparclite_le)
1771 /* Nonzero if MACH is a 64 bit sparc architecture.  */
1772 #define bfd_mach_sparc_64bit_p(mach) \
1773   ((mach) >= bfd_mach_sparc_v9 && (mach) != bfd_mach_sparc_v8plusb)
1774   bfd_arch_spu,       /* PowerPC SPU */
1775 #define bfd_mach_spu           256 
1776   bfd_arch_mips,      /* MIPS Rxxxx */
1777 #define bfd_mach_mips3000              3000
1778 #define bfd_mach_mips3900              3900
1779 #define bfd_mach_mips4000              4000
1780 #define bfd_mach_mips4010              4010
1781 #define bfd_mach_mips4100              4100
1782 #define bfd_mach_mips4111              4111
1783 #define bfd_mach_mips4120              4120
1784 #define bfd_mach_mips4300              4300
1785 #define bfd_mach_mips4400              4400
1786 #define bfd_mach_mips4600              4600
1787 #define bfd_mach_mips4650              4650
1788 #define bfd_mach_mips5000              5000
1789 #define bfd_mach_mips5400              5400
1790 #define bfd_mach_mips5500              5500
1791 #define bfd_mach_mips6000              6000
1792 #define bfd_mach_mips7000              7000
1793 #define bfd_mach_mips8000              8000
1794 #define bfd_mach_mips9000              9000
1795 #define bfd_mach_mips10000             10000
1796 #define bfd_mach_mips12000             12000
1797 #define bfd_mach_mips16                16
1798 #define bfd_mach_mips5                 5
1799 #define bfd_mach_mips_sb1              12310201 /* octal 'SB', 01 */
1800 #define bfd_mach_mipsisa32             32
1801 #define bfd_mach_mipsisa32r2           33
1802 #define bfd_mach_mipsisa64             64
1803 #define bfd_mach_mipsisa64r2           65
1804   bfd_arch_i386,      /* Intel 386 */
1805 #define bfd_mach_i386_i386 1
1806 #define bfd_mach_i386_i8086 2
1807 #define bfd_mach_i386_i386_intel_syntax 3
1808 #define bfd_mach_x86_64 64
1809 #define bfd_mach_x86_64_intel_syntax 65
1810   bfd_arch_we32k,     /* AT&T WE32xxx */
1811   bfd_arch_tahoe,     /* CCI/Harris Tahoe */
1812   bfd_arch_i860,      /* Intel 860 */
1813   bfd_arch_i370,      /* IBM 360/370 Mainframes */
1814   bfd_arch_romp,      /* IBM ROMP PC/RT */
1815   bfd_arch_convex,    /* Convex */
1816   bfd_arch_m88k,      /* Motorola 88xxx */
1817   bfd_arch_m98k,      /* Motorola 98xxx */
1818   bfd_arch_pyramid,   /* Pyramid Technology */
1819   bfd_arch_h8300,     /* Renesas H8/300 (formerly Hitachi H8/300) */
1820 #define bfd_mach_h8300    1
1821 #define bfd_mach_h8300h   2
1822 #define bfd_mach_h8300s   3
1823 #define bfd_mach_h8300hn  4
1824 #define bfd_mach_h8300sn  5
1825 #define bfd_mach_h8300sx  6
1826 #define bfd_mach_h8300sxn 7
1827   bfd_arch_pdp11,     /* DEC PDP-11 */
1828   bfd_arch_powerpc,   /* PowerPC */
1829 #define bfd_mach_ppc           32
1830 #define bfd_mach_ppc64         64
1831 #define bfd_mach_ppc_403       403
1832 #define bfd_mach_ppc_403gc     4030
1833 #define bfd_mach_ppc_505       505
1834 #define bfd_mach_ppc_601       601
1835 #define bfd_mach_ppc_602       602
1836 #define bfd_mach_ppc_603       603
1837 #define bfd_mach_ppc_ec603e    6031
1838 #define bfd_mach_ppc_604       604
1839 #define bfd_mach_ppc_620       620
1840 #define bfd_mach_ppc_630       630
1841 #define bfd_mach_ppc_750       750
1842 #define bfd_mach_ppc_860       860
1843 #define bfd_mach_ppc_a35       35
1844 #define bfd_mach_ppc_rs64ii    642
1845 #define bfd_mach_ppc_rs64iii   643
1846 #define bfd_mach_ppc_7400      7400
1847 #define bfd_mach_ppc_e500      500
1848   bfd_arch_rs6000,    /* IBM RS/6000 */
1849 #define bfd_mach_rs6k          6000
1850 #define bfd_mach_rs6k_rs1      6001
1851 #define bfd_mach_rs6k_rsc      6003
1852 #define bfd_mach_rs6k_rs2      6002
1853   bfd_arch_hppa,      /* HP PA RISC */
1854 #define bfd_mach_hppa10        10
1855 #define bfd_mach_hppa11        11
1856 #define bfd_mach_hppa20        20
1857 #define bfd_mach_hppa20w       25
1858   bfd_arch_d10v,      /* Mitsubishi D10V */
1859 #define bfd_mach_d10v          1
1860 #define bfd_mach_d10v_ts2      2
1861 #define bfd_mach_d10v_ts3      3
1862   bfd_arch_d30v,      /* Mitsubishi D30V */
1863   bfd_arch_dlx,       /* DLX */
1864   bfd_arch_m68hc11,   /* Motorola 68HC11 */
1865   bfd_arch_m68hc12,   /* Motorola 68HC12 */
1866 #define bfd_mach_m6812_default 0
1867 #define bfd_mach_m6812         1
1868 #define bfd_mach_m6812s        2
1869   bfd_arch_z8k,       /* Zilog Z8000 */
1870 #define bfd_mach_z8001         1
1871 #define bfd_mach_z8002         2
1872   bfd_arch_h8500,     /* Renesas H8/500 (formerly Hitachi H8/500) */
1873   bfd_arch_sh,        /* Renesas / SuperH SH (formerly Hitachi SH) */
1874 #define bfd_mach_sh            1
1875 #define bfd_mach_sh2        0x20
1876 #define bfd_mach_sh_dsp     0x2d
1877 #define bfd_mach_sh2a       0x2a
1878 #define bfd_mach_sh2a_nofpu 0x2b
1879 #define bfd_mach_sh2a_nofpu_or_sh4_nommu_nofpu 0x2a1
1880 #define bfd_mach_sh2a_nofpu_or_sh3_nommu 0x2a2
1881 #define bfd_mach_sh2a_or_sh4  0x2a3
1882 #define bfd_mach_sh2a_or_sh3e 0x2a4
1883 #define bfd_mach_sh2e       0x2e
1884 #define bfd_mach_sh3        0x30
1885 #define bfd_mach_sh3_nommu  0x31
1886 #define bfd_mach_sh3_dsp    0x3d
1887 #define bfd_mach_sh3e       0x3e
1888 #define bfd_mach_sh4        0x40
1889 #define bfd_mach_sh4_nofpu  0x41
1890 #define bfd_mach_sh4_nommu_nofpu  0x42
1891 #define bfd_mach_sh4a       0x4a
1892 #define bfd_mach_sh4a_nofpu 0x4b
1893 #define bfd_mach_sh4al_dsp  0x4d
1894 #define bfd_mach_sh5        0x50
1895   bfd_arch_alpha,     /* Dec Alpha */
1896 #define bfd_mach_alpha_ev4  0x10
1897 #define bfd_mach_alpha_ev5  0x20
1898 #define bfd_mach_alpha_ev6  0x30
1899   bfd_arch_arm,       /* Advanced Risc Machines ARM.  */
1900 #define bfd_mach_arm_unknown   0
1901 #define bfd_mach_arm_2         1
1902 #define bfd_mach_arm_2a        2
1903 #define bfd_mach_arm_3         3
1904 #define bfd_mach_arm_3M        4
1905 #define bfd_mach_arm_4         5
1906 #define bfd_mach_arm_4T        6
1907 #define bfd_mach_arm_5         7
1908 #define bfd_mach_arm_5T        8
1909 #define bfd_mach_arm_5TE       9
1910 #define bfd_mach_arm_XScale    10
1911 #define bfd_mach_arm_ep9312    11
1912 #define bfd_mach_arm_iWMMXt    12
1913 #define bfd_mach_arm_iWMMXt2   13
1914   bfd_arch_ns32k,     /* National Semiconductors ns32000 */
1915   bfd_arch_w65,       /* WDC 65816 */
1916   bfd_arch_tic30,     /* Texas Instruments TMS320C30 */
1917   bfd_arch_tic4x,     /* Texas Instruments TMS320C3X/4X */
1918 #define bfd_mach_tic3x         30
1919 #define bfd_mach_tic4x         40
1920   bfd_arch_tic54x,    /* Texas Instruments TMS320C54X */
1921   bfd_arch_tic80,     /* TI TMS320c80 (MVP) */
1922   bfd_arch_v850,      /* NEC V850 */
1923 #define bfd_mach_v850          1
1924 #define bfd_mach_v850e         'E'
1925 #define bfd_mach_v850e1        '1'
1926   bfd_arch_arc,       /* ARC Cores */
1927 #define bfd_mach_arc_5         5
1928 #define bfd_mach_arc_6         6
1929 #define bfd_mach_arc_7         7
1930 #define bfd_mach_arc_8         8
1931  bfd_arch_m32c,     /* Renesas M16C/M32C.  */
1932 #define bfd_mach_m16c        0x75
1933 #define bfd_mach_m32c        0x78
1934   bfd_arch_m32r,      /* Renesas M32R (formerly Mitsubishi M32R/D) */
1935 #define bfd_mach_m32r          1 /* For backwards compatibility.  */
1936 #define bfd_mach_m32rx         'x'
1937 #define bfd_mach_m32r2         '2'
1938   bfd_arch_mn10200,   /* Matsushita MN10200 */
1939   bfd_arch_mn10300,   /* Matsushita MN10300 */
1940 #define bfd_mach_mn10300               300
1941 #define bfd_mach_am33          330
1942 #define bfd_mach_am33_2        332
1943   bfd_arch_fr30,
1944 #define bfd_mach_fr30          0x46523330
1945   bfd_arch_frv,
1946 #define bfd_mach_frv           1
1947 #define bfd_mach_frvsimple     2
1948 #define bfd_mach_fr300         300
1949 #define bfd_mach_fr400         400
1950 #define bfd_mach_fr450         450
1951 #define bfd_mach_frvtomcat     499     /* fr500 prototype */
1952 #define bfd_mach_fr500         500
1953 #define bfd_mach_fr550         550
1954   bfd_arch_mcore,
1955   bfd_arch_ia64,      /* HP/Intel ia64 */
1956 #define bfd_mach_ia64_elf64    64
1957 #define bfd_mach_ia64_elf32    32
1958   bfd_arch_ip2k,      /* Ubicom IP2K microcontrollers. */
1959 #define bfd_mach_ip2022        1
1960 #define bfd_mach_ip2022ext     2
1961  bfd_arch_iq2000,     /* Vitesse IQ2000.  */
1962 #define bfd_mach_iq2000        1
1963 #define bfd_mach_iq10          2
1964   bfd_arch_mt,
1965 #define bfd_mach_ms1           1
1966 #define bfd_mach_mrisc2        2
1967 #define bfd_mach_ms2           3
1968   bfd_arch_pj,
1969   bfd_arch_avr,       /* Atmel AVR microcontrollers.  */
1970 #define bfd_mach_avr1          1
1971 #define bfd_mach_avr2          2
1972 #define bfd_mach_avr3          3
1973 #define bfd_mach_avr4          4
1974 #define bfd_mach_avr5          5
1975 #define bfd_mach_avr6          6
1976   bfd_arch_bfin,        /* ADI Blackfin */
1977 #define bfd_mach_bfin          1
1978   bfd_arch_cr16c,       /* National Semiconductor CompactRISC. */
1979 #define bfd_mach_cr16c         1
1980   bfd_arch_crx,       /*  National Semiconductor CRX.  */
1981 #define bfd_mach_crx           1
1982   bfd_arch_cris,      /* Axis CRIS */
1983 #define bfd_mach_cris_v0_v10   255
1984 #define bfd_mach_cris_v32      32
1985 #define bfd_mach_cris_v10_v32  1032
1986   bfd_arch_s390,      /* IBM s390 */
1987 #define bfd_mach_s390_31       31
1988 #define bfd_mach_s390_64       64
1989   bfd_arch_score,     /* Sunplus score */ 
1990   bfd_arch_openrisc,  /* OpenRISC */
1991   bfd_arch_mmix,      /* Donald Knuth's educational processor.  */
1992   bfd_arch_xstormy16,
1993 #define bfd_mach_xstormy16     1
1994   bfd_arch_msp430,    /* Texas Instruments MSP430 architecture.  */
1995 #define bfd_mach_msp11          11
1996 #define bfd_mach_msp110         110
1997 #define bfd_mach_msp12          12
1998 #define bfd_mach_msp13          13
1999 #define bfd_mach_msp14          14
2000 #define bfd_mach_msp15          15
2001 #define bfd_mach_msp16          16
2002 #define bfd_mach_msp21          21
2003 #define bfd_mach_msp31          31
2004 #define bfd_mach_msp32          32
2005 #define bfd_mach_msp33          33
2006 #define bfd_mach_msp41          41
2007 #define bfd_mach_msp42          42
2008 #define bfd_mach_msp43          43
2009 #define bfd_mach_msp44          44
2010   bfd_arch_xc16x,     /* Infineon's XC16X Series.               */
2011 #define bfd_mach_xc16x         1
2012 #define bfd_mach_xc16xl        2
2013 #define bfd_mach_xc16xs         3
2014   bfd_arch_xtensa,    /* Tensilica's Xtensa cores.  */
2015 #define bfd_mach_xtensa        1
2016    bfd_arch_maxq,     /* Dallas MAXQ 10/20 */
2017 #define bfd_mach_maxq10    10
2018 #define bfd_mach_maxq20    20
2019   bfd_arch_z80,
2020 #define bfd_mach_z80strict      1 /* No undocumented opcodes.  */
2021 #define bfd_mach_z80            3 /* With ixl, ixh, iyl, and iyh.  */
2022 #define bfd_mach_z80full        7 /* All undocumented instructions.  */
2023 #define bfd_mach_r800           11 /* R800: successor with multiplication.  */
2024   bfd_arch_last
2025   };
2026
2027 typedef struct bfd_arch_info
2028 {
2029   int bits_per_word;
2030   int bits_per_address;
2031   int bits_per_byte;
2032   enum bfd_architecture arch;
2033   unsigned long mach;
2034   const char *arch_name;
2035   const char *printable_name;
2036   unsigned int section_align_power;
2037   /* TRUE if this is the default machine for the architecture.
2038      The default arch should be the first entry for an arch so that
2039      all the entries for that arch can be accessed via <<next>>.  */
2040   bfd_boolean the_default;
2041   const struct bfd_arch_info * (*compatible)
2042     (const struct bfd_arch_info *a, const struct bfd_arch_info *b);
2043
2044   bfd_boolean (*scan) (const struct bfd_arch_info *, const char *);
2045
2046   const struct bfd_arch_info *next;
2047 }
2048 bfd_arch_info_type;
2049
2050 const char *bfd_printable_name (bfd *abfd);
2051
2052 const bfd_arch_info_type *bfd_scan_arch (const char *string);
2053
2054 const char **bfd_arch_list (void);
2055
2056 const bfd_arch_info_type *bfd_arch_get_compatible
2057    (const bfd *abfd, const bfd *bbfd, bfd_boolean accept_unknowns);
2058
2059 void bfd_set_arch_info (bfd *abfd, const bfd_arch_info_type *arg);
2060
2061 enum bfd_architecture bfd_get_arch (bfd *abfd);
2062
2063 unsigned long bfd_get_mach (bfd *abfd);
2064
2065 unsigned int bfd_arch_bits_per_byte (bfd *abfd);
2066
2067 unsigned int bfd_arch_bits_per_address (bfd *abfd);
2068
2069 const bfd_arch_info_type *bfd_get_arch_info (bfd *abfd);
2070
2071 const bfd_arch_info_type *bfd_lookup_arch
2072    (enum bfd_architecture arch, unsigned long machine);
2073
2074 const char *bfd_printable_arch_mach
2075    (enum bfd_architecture arch, unsigned long machine);
2076
2077 unsigned int bfd_octets_per_byte (bfd *abfd);
2078
2079 unsigned int bfd_arch_mach_octets_per_byte
2080    (enum bfd_architecture arch, unsigned long machine);
2081
2082 /* Extracted from reloc.c.  */
2083 typedef enum bfd_reloc_status
2084 {
2085   /* No errors detected.  */
2086   bfd_reloc_ok,
2087
2088   /* The relocation was performed, but there was an overflow.  */
2089   bfd_reloc_overflow,
2090
2091   /* The address to relocate was not within the section supplied.  */
2092   bfd_reloc_outofrange,
2093
2094   /* Used by special functions.  */
2095   bfd_reloc_continue,
2096
2097   /* Unsupported relocation size requested.  */
2098   bfd_reloc_notsupported,
2099
2100   /* Unused.  */
2101   bfd_reloc_other,
2102
2103   /* The symbol to relocate against was undefined.  */
2104   bfd_reloc_undefined,
2105
2106   /* The relocation was performed, but may not be ok - presently
2107      generated only when linking i960 coff files with i960 b.out
2108      symbols.  If this type is returned, the error_message argument
2109      to bfd_perform_relocation will be set.  */
2110   bfd_reloc_dangerous
2111  }
2112  bfd_reloc_status_type;
2113
2114
2115 typedef struct reloc_cache_entry
2116 {
2117   /* A pointer into the canonical table of pointers.  */
2118   struct bfd_symbol **sym_ptr_ptr;
2119
2120   /* offset in section.  */
2121   bfd_size_type address;
2122
2123   /* addend for relocation value.  */
2124   bfd_vma addend;
2125
2126   /* Pointer to how to perform the required relocation.  */
2127   reloc_howto_type *howto;
2128
2129 }
2130 arelent;
2131
2132 enum complain_overflow
2133 {
2134   /* Do not complain on overflow.  */
2135   complain_overflow_dont,
2136
2137   /* Complain if the value overflows when considered as a signed
2138      number one bit larger than the field.  ie. A bitfield of N bits
2139      is allowed to represent -2**n to 2**n-1.  */
2140   complain_overflow_bitfield,
2141
2142   /* Complain if the value overflows when considered as a signed
2143      number.  */
2144   complain_overflow_signed,
2145
2146   /* Complain if the value overflows when considered as an
2147      unsigned number.  */
2148   complain_overflow_unsigned
2149 };
2150
2151 struct reloc_howto_struct
2152 {
2153   /*  The type field has mainly a documentary use - the back end can
2154       do what it wants with it, though normally the back end's
2155       external idea of what a reloc number is stored
2156       in this field.  For example, a PC relative word relocation
2157       in a coff environment has the type 023 - because that's
2158       what the outside world calls a R_PCRWORD reloc.  */
2159   unsigned int type;
2160
2161   /*  The value the final relocation is shifted right by.  This drops
2162       unwanted data from the relocation.  */
2163   unsigned int rightshift;
2164
2165   /*  The size of the item to be relocated.  This is *not* a
2166       power-of-two measure.  To get the number of bytes operated
2167       on by a type of relocation, use bfd_get_reloc_size.  */
2168   int size;
2169
2170   /*  The number of bits in the item to be relocated.  This is used
2171       when doing overflow checking.  */
2172   unsigned int bitsize;
2173
2174   /*  Notes that the relocation is relative to the location in the
2175       data section of the addend.  The relocation function will
2176       subtract from the relocation value the address of the location
2177       being relocated.  */
2178   bfd_boolean pc_relative;
2179
2180   /*  The bit position of the reloc value in the destination.
2181       The relocated value is left shifted by this amount.  */
2182   unsigned int bitpos;
2183
2184   /* What type of overflow error should be checked for when
2185      relocating.  */
2186   enum complain_overflow complain_on_overflow;
2187
2188   /* If this field is non null, then the supplied function is
2189      called rather than the normal function.  This allows really
2190      strange relocation methods to be accommodated (e.g., i960 callj
2191      instructions).  */
2192   bfd_reloc_status_type (*special_function)
2193     (bfd *, arelent *, struct bfd_symbol *, void *, asection *,
2194      bfd *, char **);
2195
2196   /* The textual name of the relocation type.  */
2197   char *name;
2198
2199   /* Some formats record a relocation addend in the section contents
2200      rather than with the relocation.  For ELF formats this is the
2201      distinction between USE_REL and USE_RELA (though the code checks
2202      for USE_REL == 1/0).  The value of this field is TRUE if the
2203      addend is recorded with the section contents; when performing a
2204      partial link (ld -r) the section contents (the data) will be
2205      modified.  The value of this field is FALSE if addends are
2206      recorded with the relocation (in arelent.addend); when performing
2207      a partial link the relocation will be modified.
2208      All relocations for all ELF USE_RELA targets should set this field
2209      to FALSE (values of TRUE should be looked on with suspicion).
2210      However, the converse is not true: not all relocations of all ELF
2211      USE_REL targets set this field to TRUE.  Why this is so is peculiar
2212      to each particular target.  For relocs that aren't used in partial
2213      links (e.g. GOT stuff) it doesn't matter what this is set to.  */
2214   bfd_boolean partial_inplace;
2215
2216   /* src_mask selects the part of the instruction (or data) to be used
2217      in the relocation sum.  If the target relocations don't have an
2218      addend in the reloc, eg. ELF USE_REL, src_mask will normally equal
2219      dst_mask to extract the addend from the section contents.  If
2220      relocations do have an addend in the reloc, eg. ELF USE_RELA, this
2221      field should be zero.  Non-zero values for ELF USE_RELA targets are
2222      bogus as in those cases the value in the dst_mask part of the
2223      section contents should be treated as garbage.  */
2224   bfd_vma src_mask;
2225
2226   /* dst_mask selects which parts of the instruction (or data) are
2227      replaced with a relocated value.  */
2228   bfd_vma dst_mask;
2229
2230   /* When some formats create PC relative instructions, they leave
2231      the value of the pc of the place being relocated in the offset
2232      slot of the instruction, so that a PC relative relocation can
2233      be made just by adding in an ordinary offset (e.g., sun3 a.out).
2234      Some formats leave the displacement part of an instruction
2235      empty (e.g., m88k bcs); this flag signals the fact.  */
2236   bfd_boolean pcrel_offset;
2237 };
2238
2239 #define HOWTO(C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
2240   { (unsigned) C, R, S, B, P, BI, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC }
2241 #define NEWHOWTO(FUNCTION, NAME, SIZE, REL, IN) \
2242   HOWTO (0, 0, SIZE, 0, REL, 0, complain_overflow_dont, FUNCTION, \
2243          NAME, FALSE, 0, 0, IN)
2244
2245 #define EMPTY_HOWTO(C) \
2246   HOWTO ((C), 0, 0, 0, FALSE, 0, complain_overflow_dont, NULL, \
2247          NULL, FALSE, 0, 0, FALSE)
2248
2249 #define HOWTO_PREPARE(relocation, symbol)               \
2250   {                                                     \
2251     if (symbol != NULL)                                 \
2252       {                                                 \
2253         if (bfd_is_com_section (symbol->section))       \
2254           {                                             \
2255             relocation = 0;                             \
2256           }                                             \
2257         else                                            \
2258           {                                             \
2259             relocation = symbol->value;                 \
2260           }                                             \
2261       }                                                 \
2262   }
2263
2264 unsigned int bfd_get_reloc_size (reloc_howto_type *);
2265
2266 typedef struct relent_chain
2267 {
2268   arelent relent;
2269   struct relent_chain *next;
2270 }
2271 arelent_chain;
2272
2273 bfd_reloc_status_type bfd_check_overflow
2274    (enum complain_overflow how,
2275     unsigned int bitsize,
2276     unsigned int rightshift,
2277     unsigned int addrsize,
2278     bfd_vma relocation);
2279
2280 bfd_reloc_status_type bfd_perform_relocation
2281    (bfd *abfd,
2282     arelent *reloc_entry,
2283     void *data,
2284     asection *input_section,
2285     bfd *output_bfd,
2286     char **error_message);
2287
2288 bfd_reloc_status_type bfd_install_relocation
2289    (bfd *abfd,
2290     arelent *reloc_entry,
2291     void *data, bfd_vma data_start,
2292     asection *input_section,
2293     char **error_message);
2294
2295 enum bfd_reloc_code_real {
2296   _dummy_first_bfd_reloc_code_real,
2297
2298
2299 /* Basic absolute relocations of N bits.  */
2300   BFD_RELOC_64,
2301   BFD_RELOC_32,
2302   BFD_RELOC_26,
2303   BFD_RELOC_24,
2304   BFD_RELOC_16,
2305   BFD_RELOC_14,
2306   BFD_RELOC_8,
2307
2308 /* PC-relative relocations.  Sometimes these are relative to the address
2309 of the relocation itself; sometimes they are relative to the start of
2310 the section containing the relocation.  It depends on the specific target.
2311
2312 The 24-bit relocation is used in some Intel 960 configurations.  */
2313   BFD_RELOC_64_PCREL,
2314   BFD_RELOC_32_PCREL,
2315   BFD_RELOC_24_PCREL,
2316   BFD_RELOC_16_PCREL,
2317   BFD_RELOC_12_PCREL,
2318   BFD_RELOC_8_PCREL,
2319
2320 /* Section relative relocations.  Some targets need this for DWARF2.  */
2321   BFD_RELOC_32_SECREL,
2322
2323 /* For ELF.  */
2324   BFD_RELOC_32_GOT_PCREL,
2325   BFD_RELOC_16_GOT_PCREL,
2326   BFD_RELOC_8_GOT_PCREL,
2327   BFD_RELOC_32_GOTOFF,
2328   BFD_RELOC_16_GOTOFF,
2329   BFD_RELOC_LO16_GOTOFF,
2330   BFD_RELOC_HI16_GOTOFF,
2331   BFD_RELOC_HI16_S_GOTOFF,
2332   BFD_RELOC_8_GOTOFF,
2333   BFD_RELOC_64_PLT_PCREL,
2334   BFD_RELOC_32_PLT_PCREL,
2335   BFD_RELOC_24_PLT_PCREL,
2336   BFD_RELOC_16_PLT_PCREL,
2337   BFD_RELOC_8_PLT_PCREL,
2338   BFD_RELOC_64_PLTOFF,
2339   BFD_RELOC_32_PLTOFF,
2340   BFD_RELOC_16_PLTOFF,
2341   BFD_RELOC_LO16_PLTOFF,
2342   BFD_RELOC_HI16_PLTOFF,
2343   BFD_RELOC_HI16_S_PLTOFF,
2344   BFD_RELOC_8_PLTOFF,
2345
2346 /* Relocations used by 68K ELF.  */
2347   BFD_RELOC_68K_GLOB_DAT,
2348   BFD_RELOC_68K_JMP_SLOT,
2349   BFD_RELOC_68K_RELATIVE,
2350
2351 /* Linkage-table relative.  */
2352   BFD_RELOC_32_BASEREL,
2353   BFD_RELOC_16_BASEREL,
2354   BFD_RELOC_LO16_BASEREL,
2355   BFD_RELOC_HI16_BASEREL,
2356   BFD_RELOC_HI16_S_BASEREL,
2357   BFD_RELOC_8_BASEREL,
2358   BFD_RELOC_RVA,
2359
2360 /* Absolute 8-bit relocation, but used to form an address like 0xFFnn.  */
2361   BFD_RELOC_8_FFnn,
2362
2363 /* These PC-relative relocations are stored as word displacements --
2364 i.e., byte displacements shifted right two bits.  The 30-bit word
2365 displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
2366 SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
2367 signed 16-bit displacement is used on the MIPS, and the 23-bit
2368 displacement is used on the Alpha.  */
2369   BFD_RELOC_32_PCREL_S2,
2370   BFD_RELOC_16_PCREL_S2,
2371   BFD_RELOC_23_PCREL_S2,
2372
2373 /* High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
2374 the target word.  These are used on the SPARC.  */
2375   BFD_RELOC_HI22,
2376   BFD_RELOC_LO10,
2377
2378 /* For systems that allocate a Global Pointer register, these are
2379 displacements off that register.  These relocation types are
2380 handled specially, because the value the register will have is
2381 decided relatively late.  */
2382   BFD_RELOC_GPREL16,
2383   BFD_RELOC_GPREL32,
2384
2385 /* Reloc types used for i960/b.out.  */
2386   BFD_RELOC_I960_CALLJ,
2387
2388 /* SPARC ELF relocations.  There is probably some overlap with other
2389 relocation types already defined.  */
2390   BFD_RELOC_NONE,
2391   BFD_RELOC_SPARC_WDISP22,
2392   BFD_RELOC_SPARC22,
2393   BFD_RELOC_SPARC13,
2394   BFD_RELOC_SPARC_GOT10,
2395   BFD_RELOC_SPARC_GOT13,
2396   BFD_RELOC_SPARC_GOT22,
2397   BFD_RELOC_SPARC_PC10,
2398   BFD_RELOC_SPARC_PC22,
2399   BFD_RELOC_SPARC_WPLT30,
2400   BFD_RELOC_SPARC_COPY,
2401   BFD_RELOC_SPARC_GLOB_DAT,
2402   BFD_RELOC_SPARC_JMP_SLOT,
2403   BFD_RELOC_SPARC_RELATIVE,
2404   BFD_RELOC_SPARC_UA16,
2405   BFD_RELOC_SPARC_UA32,
2406   BFD_RELOC_SPARC_UA64,
2407
2408 /* I think these are specific to SPARC a.out (e.g., Sun 4).  */
2409   BFD_RELOC_SPARC_BASE13,
2410   BFD_RELOC_SPARC_BASE22,
2411
2412 /* SPARC64 relocations  */
2413 #define BFD_RELOC_SPARC_64 BFD_RELOC_64
2414   BFD_RELOC_SPARC_10,
2415   BFD_RELOC_SPARC_11,
2416   BFD_RELOC_SPARC_OLO10,
2417   BFD_RELOC_SPARC_HH22,
2418   BFD_RELOC_SPARC_HM10,
2419   BFD_RELOC_SPARC_LM22,
2420   BFD_RELOC_SPARC_PC_HH22,
2421   BFD_RELOC_SPARC_PC_HM10,
2422   BFD_RELOC_SPARC_PC_LM22,
2423   BFD_RELOC_SPARC_WDISP16,
2424   BFD_RELOC_SPARC_WDISP19,
2425   BFD_RELOC_SPARC_7,
2426   BFD_RELOC_SPARC_6,
2427   BFD_RELOC_SPARC_5,
2428 #define BFD_RELOC_SPARC_DISP64 BFD_RELOC_64_PCREL
2429   BFD_RELOC_SPARC_PLT32,
2430   BFD_RELOC_SPARC_PLT64,
2431   BFD_RELOC_SPARC_HIX22,
2432   BFD_RELOC_SPARC_LOX10,
2433   BFD_RELOC_SPARC_H44,
2434   BFD_RELOC_SPARC_M44,
2435   BFD_RELOC_SPARC_L44,
2436   BFD_RELOC_SPARC_REGISTER,
2437
2438 /* SPARC little endian relocation  */
2439   BFD_RELOC_SPARC_REV32,
2440
2441 /* SPARC TLS relocations  */
2442   BFD_RELOC_SPARC_TLS_GD_HI22,
2443   BFD_RELOC_SPARC_TLS_GD_LO10,
2444   BFD_RELOC_SPARC_TLS_GD_ADD,
2445   BFD_RELOC_SPARC_TLS_GD_CALL,
2446   BFD_RELOC_SPARC_TLS_LDM_HI22,
2447   BFD_RELOC_SPARC_TLS_LDM_LO10,
2448   BFD_RELOC_SPARC_TLS_LDM_ADD,
2449   BFD_RELOC_SPARC_TLS_LDM_CALL,
2450   BFD_RELOC_SPARC_TLS_LDO_HIX22,
2451   BFD_RELOC_SPARC_TLS_LDO_LOX10,
2452   BFD_RELOC_SPARC_TLS_LDO_ADD,
2453   BFD_RELOC_SPARC_TLS_IE_HI22,
2454   BFD_RELOC_SPARC_TLS_IE_LO10,
2455   BFD_RELOC_SPARC_TLS_IE_LD,
2456   BFD_RELOC_SPARC_TLS_IE_LDX,
2457   BFD_RELOC_SPARC_TLS_IE_ADD,
2458   BFD_RELOC_SPARC_TLS_LE_HIX22,
2459   BFD_RELOC_SPARC_TLS_LE_LOX10,
2460   BFD_RELOC_SPARC_TLS_DTPMOD32,
2461   BFD_RELOC_SPARC_TLS_DTPMOD64,
2462   BFD_RELOC_SPARC_TLS_DTPOFF32,
2463   BFD_RELOC_SPARC_TLS_DTPOFF64,
2464   BFD_RELOC_SPARC_TLS_TPOFF32,
2465   BFD_RELOC_SPARC_TLS_TPOFF64,
2466
2467 /* SPU Relocations.  */
2468   BFD_RELOC_SPU_IMM7,
2469   BFD_RELOC_SPU_IMM8,
2470   BFD_RELOC_SPU_IMM10,
2471   BFD_RELOC_SPU_IMM10W,
2472   BFD_RELOC_SPU_IMM16,
2473   BFD_RELOC_SPU_IMM16W,
2474   BFD_RELOC_SPU_IMM18,
2475   BFD_RELOC_SPU_PCREL9a,
2476   BFD_RELOC_SPU_PCREL9b,
2477   BFD_RELOC_SPU_PCREL16,
2478   BFD_RELOC_SPU_LO16,
2479   BFD_RELOC_SPU_HI16,
2480
2481 /* Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
2482 "addend" in some special way.
2483 For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
2484 writing; when reading, it will be the absolute section symbol.  The
2485 addend is the displacement in bytes of the "lda" instruction from
2486 the "ldah" instruction (which is at the address of this reloc).  */
2487   BFD_RELOC_ALPHA_GPDISP_HI16,
2488
2489 /* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
2490 with GPDISP_HI16 relocs.  The addend is ignored when writing the
2491 relocations out, and is filled in with the file's GP value on
2492 reading, for convenience.  */
2493   BFD_RELOC_ALPHA_GPDISP_LO16,
2494
2495 /* The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
2496 relocation except that there is no accompanying GPDISP_LO16
2497 relocation.  */
2498   BFD_RELOC_ALPHA_GPDISP,
2499
2500 /* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
2501 the assembler turns it into a LDQ instruction to load the address of
2502 the symbol, and then fills in a register in the real instruction.
2503
2504 The LITERAL reloc, at the LDQ instruction, refers to the .lita
2505 section symbol.  The addend is ignored when writing, but is filled
2506 in with the file's GP value on reading, for convenience, as with the
2507 GPDISP_LO16 reloc.
2508
2509 The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
2510 It should refer to the symbol to be referenced, as with 16_GOTOFF,
2511 but it generates output not based on the position within the .got
2512 section, but relative to the GP value chosen for the file during the
2513 final link stage.
2514
2515 The LITUSE reloc, on the instruction using the loaded address, gives
2516 information to the linker that it might be able to use to optimize
2517 away some literal section references.  The symbol is ignored (read
2518 as the absolute section symbol), and the "addend" indicates the type
2519 of instruction using the register:
2520 1 - "memory" fmt insn
2521 2 - byte-manipulation (byte offset reg)
2522 3 - jsr (target of branch)  */
2523   BFD_RELOC_ALPHA_LITERAL,
2524   BFD_RELOC_ALPHA_ELF_LITERAL,
2525   BFD_RELOC_ALPHA_LITUSE,
2526
2527 /* The HINT relocation indicates a value that should be filled into the
2528 "hint" field of a jmp/jsr/ret instruction, for possible branch-
2529 prediction logic which may be provided on some processors.  */
2530   BFD_RELOC_ALPHA_HINT,
2531
2532 /* The LINKAGE relocation outputs a linkage pair in the object file,
2533 which is filled by the linker.  */
2534   BFD_RELOC_ALPHA_LINKAGE,
2535
2536 /* The CODEADDR relocation outputs a STO_CA in the object file,
2537 which is filled by the linker.  */
2538   BFD_RELOC_ALPHA_CODEADDR,
2539
2540 /* The GPREL_HI/LO relocations together form a 32-bit offset from the
2541 GP register.  */
2542   BFD_RELOC_ALPHA_GPREL_HI16,
2543   BFD_RELOC_ALPHA_GPREL_LO16,
2544
2545 /* Like BFD_RELOC_23_PCREL_S2, except that the source and target must
2546 share a common GP, and the target address is adjusted for
2547 STO_ALPHA_STD_GPLOAD.  */
2548   BFD_RELOC_ALPHA_BRSGP,
2549
2550 /* Alpha thread-local storage relocations.  */
2551   BFD_RELOC_ALPHA_TLSGD,
2552   BFD_RELOC_ALPHA_TLSLDM,
2553   BFD_RELOC_ALPHA_DTPMOD64,
2554   BFD_RELOC_ALPHA_GOTDTPREL16,
2555   BFD_RELOC_ALPHA_DTPREL64,
2556   BFD_RELOC_ALPHA_DTPREL_HI16,
2557   BFD_RELOC_ALPHA_DTPREL_LO16,
2558   BFD_RELOC_ALPHA_DTPREL16,
2559   BFD_RELOC_ALPHA_GOTTPREL16,
2560   BFD_RELOC_ALPHA_TPREL64,
2561   BFD_RELOC_ALPHA_TPREL_HI16,
2562   BFD_RELOC_ALPHA_TPREL_LO16,
2563   BFD_RELOC_ALPHA_TPREL16,
2564
2565 /* Bits 27..2 of the relocation address shifted right 2 bits;
2566 simple reloc otherwise.  */
2567   BFD_RELOC_MIPS_JMP,
2568
2569 /* The MIPS16 jump instruction.  */
2570   BFD_RELOC_MIPS16_JMP,
2571
2572 /* MIPS16 GP relative reloc.  */
2573   BFD_RELOC_MIPS16_GPREL,
2574
2575 /* High 16 bits of 32-bit value; simple reloc.  */
2576   BFD_RELOC_HI16,
2577
2578 /* High 16 bits of 32-bit value but the low 16 bits will be sign
2579 extended and added to form the final result.  If the low 16
2580 bits form a negative number, we need to add one to the high value
2581 to compensate for the borrow when the low bits are added.  */
2582   BFD_RELOC_HI16_S,
2583
2584 /* Low 16 bits.  */
2585   BFD_RELOC_LO16,
2586
2587 /* High 16 bits of 32-bit pc-relative value  */
2588   BFD_RELOC_HI16_PCREL,
2589
2590 /* High 16 bits of 32-bit pc-relative value, adjusted  */
2591   BFD_RELOC_HI16_S_PCREL,
2592
2593 /* Low 16 bits of pc-relative value  */
2594   BFD_RELOC_LO16_PCREL,
2595
2596 /* MIPS16 high 16 bits of 32-bit value.  */
2597   BFD_RELOC_MIPS16_HI16,
2598
2599 /* MIPS16 high 16 bits of 32-bit value but the low 16 bits will be sign
2600 extended and added to form the final result.  If the low 16
2601 bits form a negative number, we need to add one to the high value
2602 to compensate for the borrow when the low bits are added.  */
2603   BFD_RELOC_MIPS16_HI16_S,
2604
2605 /* MIPS16 low 16 bits.  */
2606   BFD_RELOC_MIPS16_LO16,
2607
2608 /* Relocation against a MIPS literal section.  */
2609   BFD_RELOC_MIPS_LITERAL,
2610
2611 /* MIPS ELF relocations.  */
2612   BFD_RELOC_MIPS_GOT16,
2613   BFD_RELOC_MIPS_CALL16,
2614   BFD_RELOC_MIPS_GOT_HI16,
2615   BFD_RELOC_MIPS_GOT_LO16,
2616   BFD_RELOC_MIPS_CALL_HI16,
2617   BFD_RELOC_MIPS_CALL_LO16,
2618   BFD_RELOC_MIPS_SUB,
2619   BFD_RELOC_MIPS_GOT_PAGE,
2620   BFD_RELOC_MIPS_GOT_OFST,
2621   BFD_RELOC_MIPS_GOT_DISP,
2622   BFD_RELOC_MIPS_SHIFT5,
2623   BFD_RELOC_MIPS_SHIFT6,
2624   BFD_RELOC_MIPS_INSERT_A,
2625   BFD_RELOC_MIPS_INSERT_B,
2626   BFD_RELOC_MIPS_DELETE,
2627   BFD_RELOC_MIPS_HIGHEST,
2628   BFD_RELOC_MIPS_HIGHER,
2629   BFD_RELOC_MIPS_SCN_DISP,
2630   BFD_RELOC_MIPS_REL16,
2631   BFD_RELOC_MIPS_RELGOT,
2632   BFD_RELOC_MIPS_JALR,
2633   BFD_RELOC_MIPS_TLS_DTPMOD32,
2634   BFD_RELOC_MIPS_TLS_DTPREL32,
2635   BFD_RELOC_MIPS_TLS_DTPMOD64,
2636   BFD_RELOC_MIPS_TLS_DTPREL64,
2637   BFD_RELOC_MIPS_TLS_GD,
2638   BFD_RELOC_MIPS_TLS_LDM,
2639   BFD_RELOC_MIPS_TLS_DTPREL_HI16,
2640   BFD_RELOC_MIPS_TLS_DTPREL_LO16,
2641   BFD_RELOC_MIPS_TLS_GOTTPREL,
2642   BFD_RELOC_MIPS_TLS_TPREL32,
2643   BFD_RELOC_MIPS_TLS_TPREL64,
2644   BFD_RELOC_MIPS_TLS_TPREL_HI16,
2645   BFD_RELOC_MIPS_TLS_TPREL_LO16,
2646
2647
2648 /* MIPS ELF relocations (VxWorks extensions).  */
2649   BFD_RELOC_MIPS_COPY,
2650   BFD_RELOC_MIPS_JUMP_SLOT,
2651
2652
2653 /* Fujitsu Frv Relocations.  */
2654   BFD_RELOC_FRV_LABEL16,
2655   BFD_RELOC_FRV_LABEL24,
2656   BFD_RELOC_FRV_LO16,
2657   BFD_RELOC_FRV_HI16,
2658   BFD_RELOC_FRV_GPREL12,
2659   BFD_RELOC_FRV_GPRELU12,
2660   BFD_RELOC_FRV_GPREL32,
2661   BFD_RELOC_FRV_GPRELHI,
2662   BFD_RELOC_FRV_GPRELLO,
2663   BFD_RELOC_FRV_GOT12,
2664   BFD_RELOC_FRV_GOTHI,
2665   BFD_RELOC_FRV_GOTLO,
2666   BFD_RELOC_FRV_FUNCDESC,
2667   BFD_RELOC_FRV_FUNCDESC_GOT12,
2668   BFD_RELOC_FRV_FUNCDESC_GOTHI,
2669   BFD_RELOC_FRV_FUNCDESC_GOTLO,
2670   BFD_RELOC_FRV_FUNCDESC_VALUE,
2671   BFD_RELOC_FRV_FUNCDESC_GOTOFF12,
2672   BFD_RELOC_FRV_FUNCDESC_GOTOFFHI,
2673   BFD_RELOC_FRV_FUNCDESC_GOTOFFLO,
2674   BFD_RELOC_FRV_GOTOFF12,
2675   BFD_RELOC_FRV_GOTOFFHI,
2676   BFD_RELOC_FRV_GOTOFFLO,
2677   BFD_RELOC_FRV_GETTLSOFF,
2678   BFD_RELOC_FRV_TLSDESC_VALUE,
2679   BFD_RELOC_FRV_GOTTLSDESC12,
2680   BFD_RELOC_FRV_GOTTLSDESCHI,
2681   BFD_RELOC_FRV_GOTTLSDESCLO,
2682   BFD_RELOC_FRV_TLSMOFF12,
2683   BFD_RELOC_FRV_TLSMOFFHI,
2684   BFD_RELOC_FRV_TLSMOFFLO,
2685   BFD_RELOC_FRV_GOTTLSOFF12,
2686   BFD_RELOC_FRV_GOTTLSOFFHI,
2687   BFD_RELOC_FRV_GOTTLSOFFLO,
2688   BFD_RELOC_FRV_TLSOFF,
2689   BFD_RELOC_FRV_TLSDESC_RELAX,
2690   BFD_RELOC_FRV_GETTLSOFF_RELAX,
2691   BFD_RELOC_FRV_TLSOFF_RELAX,
2692   BFD_RELOC_FRV_TLSMOFF,
2693
2694
2695 /* This is a 24bit GOT-relative reloc for the mn10300.  */
2696   BFD_RELOC_MN10300_GOTOFF24,
2697
2698 /* This is a 32bit GOT-relative reloc for the mn10300, offset by two bytes
2699 in the instruction.  */
2700   BFD_RELOC_MN10300_GOT32,
2701
2702 /* This is a 24bit GOT-relative reloc for the mn10300, offset by two bytes
2703 in the instruction.  */
2704   BFD_RELOC_MN10300_GOT24,
2705
2706 /* This is a 16bit GOT-relative reloc for the mn10300, offset by two bytes
2707 in the instruction.  */
2708   BFD_RELOC_MN10300_GOT16,
2709
2710 /* Copy symbol at runtime.  */
2711   BFD_RELOC_MN10300_COPY,
2712
2713 /* Create GOT entry.  */
2714   BFD_RELOC_MN10300_GLOB_DAT,
2715
2716 /* Create PLT entry.  */
2717   BFD_RELOC_MN10300_JMP_SLOT,
2718
2719 /* Adjust by program base.  */
2720   BFD_RELOC_MN10300_RELATIVE,
2721
2722
2723 /* i386/elf relocations  */
2724   BFD_RELOC_386_GOT32,
2725   BFD_RELOC_386_PLT32,
2726   BFD_RELOC_386_COPY,
2727   BFD_RELOC_386_GLOB_DAT,
2728   BFD_RELOC_386_JUMP_SLOT,
2729   BFD_RELOC_386_RELATIVE,
2730   BFD_RELOC_386_GOTOFF,
2731   BFD_RELOC_386_GOTPC,
2732   BFD_RELOC_386_TLS_TPOFF,
2733   BFD_RELOC_386_TLS_IE,
2734   BFD_RELOC_386_TLS_GOTIE,
2735   BFD_RELOC_386_TLS_LE,
2736   BFD_RELOC_386_TLS_GD,
2737   BFD_RELOC_386_TLS_LDM,
2738   BFD_RELOC_386_TLS_LDO_32,
2739   BFD_RELOC_386_TLS_IE_32,
2740   BFD_RELOC_386_TLS_LE_32,
2741   BFD_RELOC_386_TLS_DTPMOD32,
2742   BFD_RELOC_386_TLS_DTPOFF32,
2743   BFD_RELOC_386_TLS_TPOFF32,
2744   BFD_RELOC_386_TLS_GOTDESC,
2745   BFD_RELOC_386_TLS_DESC_CALL,
2746   BFD_RELOC_386_TLS_DESC,
2747
2748 /* x86-64/elf relocations  */
2749   BFD_RELOC_X86_64_GOT32,
2750   BFD_RELOC_X86_64_PLT32,
2751   BFD_RELOC_X86_64_COPY,
2752   BFD_RELOC_X86_64_GLOB_DAT,
2753   BFD_RELOC_X86_64_JUMP_SLOT,
2754   BFD_RELOC_X86_64_RELATIVE,
2755   BFD_RELOC_X86_64_GOTPCREL,
2756   BFD_RELOC_X86_64_32S,
2757   BFD_RELOC_X86_64_DTPMOD64,
2758   BFD_RELOC_X86_64_DTPOFF64,
2759   BFD_RELOC_X86_64_TPOFF64,
2760   BFD_RELOC_X86_64_TLSGD,
2761   BFD_RELOC_X86_64_TLSLD,
2762   BFD_RELOC_X86_64_DTPOFF32,
2763   BFD_RELOC_X86_64_GOTTPOFF,
2764   BFD_RELOC_X86_64_TPOFF32,
2765   BFD_RELOC_X86_64_GOTOFF64,
2766   BFD_RELOC_X86_64_GOTPC32,
2767   BFD_RELOC_X86_64_GOT64,
2768   BFD_RELOC_X86_64_GOTPCREL64,
2769   BFD_RELOC_X86_64_GOTPC64,
2770   BFD_RELOC_X86_64_GOTPLT64,
2771   BFD_RELOC_X86_64_PLTOFF64,
2772   BFD_RELOC_X86_64_GOTPC32_TLSDESC,
2773   BFD_RELOC_X86_64_TLSDESC_CALL,
2774   BFD_RELOC_X86_64_TLSDESC,
2775
2776 /* ns32k relocations  */
2777   BFD_RELOC_NS32K_IMM_8,
2778   BFD_RELOC_NS32K_IMM_16,
2779   BFD_RELOC_NS32K_IMM_32,
2780   BFD_RELOC_NS32K_IMM_8_PCREL,
2781   BFD_RELOC_NS32K_IMM_16_PCREL,
2782   BFD_RELOC_NS32K_IMM_32_PCREL,
2783   BFD_RELOC_NS32K_DISP_8,
2784   BFD_RELOC_NS32K_DISP_16,
2785   BFD_RELOC_NS32K_DISP_32,
2786   BFD_RELOC_NS32K_DISP_8_PCREL,
2787   BFD_RELOC_NS32K_DISP_16_PCREL,
2788   BFD_RELOC_NS32K_DISP_32_PCREL,
2789
2790 /* PDP11 relocations  */
2791   BFD_RELOC_PDP11_DISP_8_PCREL,
2792   BFD_RELOC_PDP11_DISP_6_PCREL,
2793
2794 /* Picojava relocs.  Not all of these appear in object files.  */
2795   BFD_RELOC_PJ_CODE_HI16,
2796   BFD_RELOC_PJ_CODE_LO16,
2797   BFD_RELOC_PJ_CODE_DIR16,
2798   BFD_RELOC_PJ_CODE_DIR32,
2799   BFD_RELOC_PJ_CODE_REL16,
2800   BFD_RELOC_PJ_CODE_REL32,
2801
2802 /* Power(rs6000) and PowerPC relocations.  */
2803   BFD_RELOC_PPC_B26,
2804   BFD_RELOC_PPC_BA26,
2805   BFD_RELOC_PPC_TOC16,
2806   BFD_RELOC_PPC_B16,
2807   BFD_RELOC_PPC_B16_BRTAKEN,
2808   BFD_RELOC_PPC_B16_BRNTAKEN,
2809   BFD_RELOC_PPC_BA16,
2810   BFD_RELOC_PPC_BA16_BRTAKEN,
2811   BFD_RELOC_PPC_BA16_BRNTAKEN,
2812   BFD_RELOC_PPC_COPY,
2813   BFD_RELOC_PPC_GLOB_DAT,
2814   BFD_RELOC_PPC_JMP_SLOT,
2815   BFD_RELOC_PPC_RELATIVE,
2816   BFD_RELOC_PPC_LOCAL24PC,
2817   BFD_RELOC_PPC_EMB_NADDR32,
2818   BFD_RELOC_PPC_EMB_NADDR16,
2819   BFD_RELOC_PPC_EMB_NADDR16_LO,
2820   BFD_RELOC_PPC_EMB_NADDR16_HI,
2821   BFD_RELOC_PPC_EMB_NADDR16_HA,
2822   BFD_RELOC_PPC_EMB_SDAI16,
2823   BFD_RELOC_PPC_EMB_SDA2I16,
2824   BFD_RELOC_PPC_EMB_SDA2REL,
2825   BFD_RELOC_PPC_EMB_SDA21,
2826   BFD_RELOC_PPC_EMB_MRKREF,
2827   BFD_RELOC_PPC_EMB_RELSEC16,
2828   BFD_RELOC_PPC_EMB_RELST_LO,
2829   BFD_RELOC_PPC_EMB_RELST_HI,
2830   BFD_RELOC_PPC_EMB_RELST_HA,
2831   BFD_RELOC_PPC_EMB_BIT_FLD,
2832   BFD_RELOC_PPC_EMB_RELSDA,
2833   BFD_RELOC_PPC64_HIGHER,
2834   BFD_RELOC_PPC64_HIGHER_S,
2835   BFD_RELOC_PPC64_HIGHEST,
2836   BFD_RELOC_PPC64_HIGHEST_S,
2837   BFD_RELOC_PPC64_TOC16_LO,
2838   BFD_RELOC_PPC64_TOC16_HI,
2839   BFD_RELOC_PPC64_TOC16_HA,
2840   BFD_RELOC_PPC64_TOC,
2841   BFD_RELOC_PPC64_PLTGOT16,
2842   BFD_RELOC_PPC64_PLTGOT16_LO,
2843   BFD_RELOC_PPC64_PLTGOT16_HI,
2844   BFD_RELOC_PPC64_PLTGOT16_HA,
2845   BFD_RELOC_PPC64_ADDR16_DS,
2846   BFD_RELOC_PPC64_ADDR16_LO_DS,
2847   BFD_RELOC_PPC64_GOT16_DS,
2848   BFD_RELOC_PPC64_GOT16_LO_DS,
2849   BFD_RELOC_PPC64_PLT16_LO_DS,
2850   BFD_RELOC_PPC64_SECTOFF_DS,
2851   BFD_RELOC_PPC64_SECTOFF_LO_DS,
2852   BFD_RELOC_PPC64_TOC16_DS,
2853   BFD_RELOC_PPC64_TOC16_LO_DS,
2854   BFD_RELOC_PPC64_PLTGOT16_DS,
2855   BFD_RELOC_PPC64_PLTGOT16_LO_DS,
2856
2857 /* PowerPC and PowerPC64 thread-local storage relocations.  */
2858   BFD_RELOC_PPC_TLS,
2859   BFD_RELOC_PPC_DTPMOD,
2860   BFD_RELOC_PPC_TPREL16,
2861   BFD_RELOC_PPC_TPREL16_LO,
2862   BFD_RELOC_PPC_TPREL16_HI,
2863   BFD_RELOC_PPC_TPREL16_HA,
2864   BFD_RELOC_PPC_TPREL,
2865   BFD_RELOC_PPC_DTPREL16,
2866   BFD_RELOC_PPC_DTPREL16_LO,
2867   BFD_RELOC_PPC_DTPREL16_HI,
2868   BFD_RELOC_PPC_DTPREL16_HA,
2869   BFD_RELOC_PPC_DTPREL,
2870   BFD_RELOC_PPC_GOT_TLSGD16,
2871   BFD_RELOC_PPC_GOT_TLSGD16_LO,
2872   BFD_RELOC_PPC_GOT_TLSGD16_HI,
2873   BFD_RELOC_PPC_GOT_TLSGD16_HA,
2874   BFD_RELOC_PPC_GOT_TLSLD16,
2875   BFD_RELOC_PPC_GOT_TLSLD16_LO,
2876   BFD_RELOC_PPC_GOT_TLSLD16_HI,
2877   BFD_RELOC_PPC_GOT_TLSLD16_HA,
2878   BFD_RELOC_PPC_GOT_TPREL16,
2879   BFD_RELOC_PPC_GOT_TPREL16_LO,
2880   BFD_RELOC_PPC_GOT_TPREL16_HI,
2881   BFD_RELOC_PPC_GOT_TPREL16_HA,
2882   BFD_RELOC_PPC_GOT_DTPREL16,
2883   BFD_RELOC_PPC_GOT_DTPREL16_LO,
2884   BFD_RELOC_PPC_GOT_DTPREL16_HI,
2885   BFD_RELOC_PPC_GOT_DTPREL16_HA,
2886   BFD_RELOC_PPC64_TPREL16_DS,
2887   BFD_RELOC_PPC64_TPREL16_LO_DS,
2888   BFD_RELOC_PPC64_TPREL16_HIGHER,
2889   BFD_RELOC_PPC64_TPREL16_HIGHERA,
2890   BFD_RELOC_PPC64_TPREL16_HIGHEST,
2891   BFD_RELOC_PPC64_TPREL16_HIGHESTA,
2892   BFD_RELOC_PPC64_DTPREL16_DS,
2893   BFD_RELOC_PPC64_DTPREL16_LO_DS,
2894   BFD_RELOC_PPC64_DTPREL16_HIGHER,
2895   BFD_RELOC_PPC64_DTPREL16_HIGHERA,
2896   BFD_RELOC_PPC64_DTPREL16_HIGHEST,
2897   BFD_RELOC_PPC64_DTPREL16_HIGHESTA,
2898
2899 /* IBM 370/390 relocations  */
2900   BFD_RELOC_I370_D12,
2901
2902 /* The type of reloc used to build a constructor table - at the moment
2903 probably a 32 bit wide absolute relocation, but the target can choose.
2904 It generally does map to one of the other relocation types.  */
2905   BFD_RELOC_CTOR,
2906
2907 /* ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
2908 not stored in the instruction.  */
2909   BFD_RELOC_ARM_PCREL_BRANCH,
2910
2911 /* ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
2912 not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2913 field in the instruction.  */
2914   BFD_RELOC_ARM_PCREL_BLX,
2915
2916 /* Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
2917 not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
2918 field in the instruction.  */
2919   BFD_RELOC_THUMB_PCREL_BLX,
2920
2921 /* ARM 26-bit pc-relative branch for an unconditional BL or BLX instruction.  */
2922   BFD_RELOC_ARM_PCREL_CALL,
2923
2924 /* ARM 26-bit pc-relative branch for B or conditional BL instruction.  */
2925   BFD_RELOC_ARM_PCREL_JUMP,
2926
2927 /* Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
2928 The lowest bit must be zero and is not stored in the instruction.
2929 Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
2930 "nn" one smaller in all cases.  Note further that BRANCH23
2931 corresponds to R_ARM_THM_CALL.  */
2932   BFD_RELOC_THUMB_PCREL_BRANCH7,
2933   BFD_RELOC_THUMB_PCREL_BRANCH9,
2934   BFD_RELOC_THUMB_PCREL_BRANCH12,
2935   BFD_RELOC_THUMB_PCREL_BRANCH20,
2936   BFD_RELOC_THUMB_PCREL_BRANCH23,
2937   BFD_RELOC_THUMB_PCREL_BRANCH25,
2938
2939 /* 12-bit immediate offset, used in ARM-format ldr and str instructions.  */
2940   BFD_RELOC_ARM_OFFSET_IMM,
2941
2942 /* 5-bit immediate offset, used in Thumb-format ldr and str instructions.  */
2943   BFD_RELOC_ARM_THUMB_OFFSET,
2944
2945 /* Pc-relative or absolute relocation depending on target.  Used for
2946 entries in .init_array sections.  */
2947   BFD_RELOC_ARM_TARGET1,
2948
2949 /* Read-only segment base relative address.  */
2950   BFD_RELOC_ARM_ROSEGREL32,
2951
2952 /* Data segment base relative address.  */
2953   BFD_RELOC_ARM_SBREL32,
2954
2955 /* This reloc is used for references to RTTI data from exception handling
2956 tables.  The actual definition depends on the target.  It may be a
2957 pc-relative or some form of GOT-indirect relocation.  */
2958   BFD_RELOC_ARM_TARGET2,
2959
2960 /* 31-bit PC relative address.  */
2961   BFD_RELOC_ARM_PREL31,
2962
2963 /* Low and High halfword relocations for MOVW and MOVT instructions.  */
2964   BFD_RELOC_ARM_MOVW,
2965   BFD_RELOC_ARM_MOVT,
2966   BFD_RELOC_ARM_MOVW_PCREL,
2967   BFD_RELOC_ARM_MOVT_PCREL,
2968   BFD_RELOC_ARM_THUMB_MOVW,
2969   BFD_RELOC_ARM_THUMB_MOVT,
2970   BFD_RELOC_ARM_THUMB_MOVW_PCREL,
2971   BFD_RELOC_ARM_THUMB_MOVT_PCREL,
2972
2973 /* Relocations for setting up GOTs and PLTs for shared libraries.  */
2974   BFD_RELOC_ARM_JUMP_SLOT,
2975   BFD_RELOC_ARM_GLOB_DAT,
2976   BFD_RELOC_ARM_GOT32,
2977   BFD_RELOC_ARM_PLT32,
2978   BFD_RELOC_ARM_RELATIVE,
2979   BFD_RELOC_ARM_GOTOFF,
2980   BFD_RELOC_ARM_GOTPC,
2981
2982 /* ARM thread-local storage relocations.  */
2983   BFD_RELOC_ARM_TLS_GD32,
2984   BFD_RELOC_ARM_TLS_LDO32,
2985   BFD_RELOC_ARM_TLS_LDM32,
2986   BFD_RELOC_ARM_TLS_DTPOFF32,
2987   BFD_RELOC_ARM_TLS_DTPMOD32,
2988   BFD_RELOC_ARM_TLS_TPOFF32,
2989   BFD_RELOC_ARM_TLS_IE32,
2990   BFD_RELOC_ARM_TLS_LE32,
2991
2992 /* ARM group relocations.  */
2993   BFD_RELOC_ARM_ALU_PC_G0_NC,
2994   BFD_RELOC_ARM_ALU_PC_G0,
2995   BFD_RELOC_ARM_ALU_PC_G1_NC,
2996   BFD_RELOC_ARM_ALU_PC_G1,
2997   BFD_RELOC_ARM_ALU_PC_G2,
2998   BFD_RELOC_ARM_LDR_PC_G0,
2999   BFD_RELOC_ARM_LDR_PC_G1,
3000   BFD_RELOC_ARM_LDR_PC_G2,
3001   BFD_RELOC_ARM_LDRS_PC_G0,
3002   BFD_RELOC_ARM_LDRS_PC_G1,
3003   BFD_RELOC_ARM_LDRS_PC_G2,
3004   BFD_RELOC_ARM_LDC_PC_G0,
3005   BFD_RELOC_ARM_LDC_PC_G1,
3006   BFD_RELOC_ARM_LDC_PC_G2,
3007   BFD_RELOC_ARM_ALU_SB_G0_NC,
3008   BFD_RELOC_ARM_ALU_SB_G0,
3009   BFD_RELOC_ARM_ALU_SB_G1_NC,
3010   BFD_RELOC_ARM_ALU_SB_G1,
3011   BFD_RELOC_ARM_ALU_SB_G2,
3012   BFD_RELOC_ARM_LDR_SB_G0,
3013   BFD_RELOC_ARM_LDR_SB_G1,
3014   BFD_RELOC_ARM_LDR_SB_G2,
3015   BFD_RELOC_ARM_LDRS_SB_G0,
3016   BFD_RELOC_ARM_LDRS_SB_G1,
3017   BFD_RELOC_ARM_LDRS_SB_G2,
3018   BFD_RELOC_ARM_LDC_SB_G0,
3019   BFD_RELOC_ARM_LDC_SB_G1,
3020   BFD_RELOC_ARM_LDC_SB_G2,
3021
3022 /* These relocs are only used within the ARM assembler.  They are not
3023 (at present) written to any object files.  */
3024   BFD_RELOC_ARM_IMMEDIATE,
3025   BFD_RELOC_ARM_ADRL_IMMEDIATE,
3026   BFD_RELOC_ARM_T32_IMMEDIATE,
3027   BFD_RELOC_ARM_T32_ADD_IMM,
3028   BFD_RELOC_ARM_T32_IMM12,
3029   BFD_RELOC_ARM_T32_ADD_PC12,
3030   BFD_RELOC_ARM_SHIFT_IMM,
3031   BFD_RELOC_ARM_SMC,
3032   BFD_RELOC_ARM_SWI,
3033   BFD_RELOC_ARM_MULTI,
3034   BFD_RELOC_ARM_CP_OFF_IMM,
3035   BFD_RELOC_ARM_CP_OFF_IMM_S2,
3036   BFD_RELOC_ARM_T32_CP_OFF_IMM,
3037   BFD_RELOC_ARM_T32_CP_OFF_IMM_S2,
3038   BFD_RELOC_ARM_ADR_IMM,
3039   BFD_RELOC_ARM_LDR_IMM,
3040   BFD_RELOC_ARM_LITERAL,
3041   BFD_RELOC_ARM_IN_POOL,
3042   BFD_RELOC_ARM_OFFSET_IMM8,
3043   BFD_RELOC_ARM_T32_OFFSET_U8,
3044   BFD_RELOC_ARM_T32_OFFSET_IMM,
3045   BFD_RELOC_ARM_HWLITERAL,
3046   BFD_RELOC_ARM_THUMB_ADD,
3047   BFD_RELOC_ARM_THUMB_IMM,
3048   BFD_RELOC_ARM_THUMB_SHIFT,
3049
3050 /* Renesas / SuperH SH relocs.  Not all of these appear in object files.  */
3051   BFD_RELOC_SH_PCDISP8BY2,
3052   BFD_RELOC_SH_PCDISP12BY2,
3053   BFD_RELOC_SH_IMM3,
3054   BFD_RELOC_SH_IMM3U,
3055   BFD_RELOC_SH_DISP12,
3056   BFD_RELOC_SH_DISP12BY2,
3057   BFD_RELOC_SH_DISP12BY4,
3058   BFD_RELOC_SH_DISP12BY8,
3059   BFD_RELOC_SH_DISP20,
3060   BFD_RELOC_SH_DISP20BY8,
3061   BFD_RELOC_SH_IMM4,
3062   BFD_RELOC_SH_IMM4BY2,
3063   BFD_RELOC_SH_IMM4BY4,
3064   BFD_RELOC_SH_IMM8,
3065   BFD_RELOC_SH_IMM8BY2,
3066   BFD_RELOC_SH_IMM8BY4,
3067   BFD_RELOC_SH_PCRELIMM8BY2,
3068   BFD_RELOC_SH_PCRELIMM8BY4,
3069   BFD_RELOC_SH_SWITCH16,
3070   BFD_RELOC_SH_SWITCH32,
3071   BFD_RELOC_SH_USES,
3072   BFD_RELOC_SH_COUNT,
3073   BFD_RELOC_SH_ALIGN,
3074   BFD_RELOC_SH_CODE,
3075   BFD_RELOC_SH_DATA,
3076   BFD_RELOC_SH_LABEL,
3077   BFD_RELOC_SH_LOOP_START,
3078   BFD_RELOC_SH_LOOP_END,
3079   BFD_RELOC_SH_COPY,
3080   BFD_RELOC_SH_GLOB_DAT,
3081   BFD_RELOC_SH_JMP_SLOT,
3082   BFD_RELOC_SH_RELATIVE,
3083   BFD_RELOC_SH_GOTPC,
3084   BFD_RELOC_SH_GOT_LOW16,
3085   BFD_RELOC_SH_GOT_MEDLOW16,
3086   BFD_RELOC_SH_GOT_MEDHI16,
3087   BFD_RELOC_SH_GOT_HI16,
3088   BFD_RELOC_SH_GOTPLT_LOW16,
3089   BFD_RELOC_SH_GOTPLT_MEDLOW16,
3090   BFD_RELOC_SH_GOTPLT_MEDHI16,
3091   BFD_RELOC_SH_GOTPLT_HI16,
3092   BFD_RELOC_SH_PLT_LOW16,
3093   BFD_RELOC_SH_PLT_MEDLOW16,
3094   BFD_RELOC_SH_PLT_MEDHI16,
3095   BFD_RELOC_SH_PLT_HI16,
3096   BFD_RELOC_SH_GOTOFF_LOW16,
3097   BFD_RELOC_SH_GOTOFF_MEDLOW16,
3098   BFD_RELOC_SH_GOTOFF_MEDHI16,
3099   BFD_RELOC_SH_GOTOFF_HI16,
3100   BFD_RELOC_SH_GOTPC_LOW16,
3101   BFD_RELOC_SH_GOTPC_MEDLOW16,
3102   BFD_RELOC_SH_GOTPC_MEDHI16,
3103   BFD_RELOC_SH_GOTPC_HI16,
3104   BFD_RELOC_SH_COPY64,
3105   BFD_RELOC_SH_GLOB_DAT64,
3106   BFD_RELOC_SH_JMP_SLOT64,
3107   BFD_RELOC_SH_RELATIVE64,
3108   BFD_RELOC_SH_GOT10BY4,
3109   BFD_RELOC_SH_GOT10BY8,
3110   BFD_RELOC_SH_GOTPLT10BY4,
3111   BFD_RELOC_SH_GOTPLT10BY8,
3112   BFD_RELOC_SH_GOTPLT32,
3113   BFD_RELOC_SH_SHMEDIA_CODE,
3114   BFD_RELOC_SH_IMMU5,
3115   BFD_RELOC_SH_IMMS6,
3116   BFD_RELOC_SH_IMMS6BY32,
3117   BFD_RELOC_SH_IMMU6,
3118   BFD_RELOC_SH_IMMS10,
3119   BFD_RELOC_SH_IMMS10BY2,
3120   BFD_RELOC_SH_IMMS10BY4,
3121   BFD_RELOC_SH_IMMS10BY8,
3122   BFD_RELOC_SH_IMMS16,
3123   BFD_RELOC_SH_IMMU16,
3124   BFD_RELOC_SH_IMM_LOW16,
3125   BFD_RELOC_SH_IMM_LOW16_PCREL,
3126   BFD_RELOC_SH_IMM_MEDLOW16,
3127   BFD_RELOC_SH_IMM_MEDLOW16_PCREL,
3128   BFD_RELOC_SH_IMM_MEDHI16,
3129   BFD_RELOC_SH_IMM_MEDHI16_PCREL,
3130   BFD_RELOC_SH_IMM_HI16,
3131   BFD_RELOC_SH_IMM_HI16_PCREL,
3132   BFD_RELOC_SH_PT_16,
3133   BFD_RELOC_SH_TLS_GD_32,
3134   BFD_RELOC_SH_TLS_LD_32,
3135   BFD_RELOC_SH_TLS_LDO_32,
3136   BFD_RELOC_SH_TLS_IE_32,
3137   BFD_RELOC_SH_TLS_LE_32,
3138   BFD_RELOC_SH_TLS_DTPMOD32,
3139   BFD_RELOC_SH_TLS_DTPOFF32,
3140   BFD_RELOC_SH_TLS_TPOFF32,
3141
3142 /* ARC Cores relocs.
3143 ARC 22 bit pc-relative branch.  The lowest two bits must be zero and are
3144 not stored in the instruction.  The high 20 bits are installed in bits 26
3145 through 7 of the instruction.  */
3146   BFD_RELOC_ARC_B22_PCREL,
3147
3148 /* ARC 26 bit absolute branch.  The lowest two bits must be zero and are not
3149 stored in the instruction.  The high 24 bits are installed in bits 23
3150 through 0.  */
3151   BFD_RELOC_ARC_B26,
3152
3153 /* ADI Blackfin 16 bit immediate absolute reloc.  */
3154   BFD_RELOC_BFIN_16_IMM,
3155
3156 /* ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.  */
3157   BFD_RELOC_BFIN_16_HIGH,
3158
3159 /* ADI Blackfin 'a' part of LSETUP.  */
3160   BFD_RELOC_BFIN_4_PCREL,
3161
3162 /* ADI Blackfin.  */
3163   BFD_RELOC_BFIN_5_PCREL,
3164
3165 /* ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.  */
3166   BFD_RELOC_BFIN_16_LOW,
3167
3168 /* ADI Blackfin.  */
3169   BFD_RELOC_BFIN_10_PCREL,
3170
3171 /* ADI Blackfin 'b' part of LSETUP.  */
3172   BFD_RELOC_BFIN_11_PCREL,
3173
3174 /* ADI Blackfin.  */
3175   BFD_RELOC_BFIN_12_PCREL_JUMP,
3176
3177 /* ADI Blackfin Short jump, pcrel.  */
3178   BFD_RELOC_BFIN_12_PCREL_JUMP_S,
3179
3180 /* ADI Blackfin Call.x not implemented.  */
3181   BFD_RELOC_BFIN_24_PCREL_CALL_X,
3182
3183 /* ADI Blackfin Long Jump pcrel.  */
3184   BFD_RELOC_BFIN_24_PCREL_JUMP_L,
3185
3186 /* ADI Blackfin FD-PIC relocations.  */
3187   BFD_RELOC_BFIN_GOT17M4,
3188   BFD_RELOC_BFIN_GOTHI,
3189   BFD_RELOC_BFIN_GOTLO,
3190   BFD_RELOC_BFIN_FUNCDESC,
3191   BFD_RELOC_BFIN_FUNCDESC_GOT17M4,
3192   BFD_RELOC_BFIN_FUNCDESC_GOTHI,
3193   BFD_RELOC_BFIN_FUNCDESC_GOTLO,
3194   BFD_RELOC_BFIN_FUNCDESC_VALUE,
3195   BFD_RELOC_BFIN_FUNCDESC_GOTOFF17M4,
3196   BFD_RELOC_BFIN_FUNCDESC_GOTOFFHI,
3197   BFD_RELOC_BFIN_FUNCDESC_GOTOFFLO,
3198   BFD_RELOC_BFIN_GOTOFF17M4,
3199   BFD_RELOC_BFIN_GOTOFFHI,
3200   BFD_RELOC_BFIN_GOTOFFLO,
3201
3202 /* ADI Blackfin GOT relocation.  */
3203   BFD_RELOC_BFIN_GOT,
3204
3205 /* ADI Blackfin PLTPC relocation.  */
3206   BFD_RELOC_BFIN_PLTPC,
3207
3208 /* ADI Blackfin arithmetic relocation.  */
3209   BFD_ARELOC_BFIN_PUSH,
3210
3211 /* ADI Blackfin arithmetic relocation.  */
3212   BFD_ARELOC_BFIN_CONST,
3213
3214 /* ADI Blackfin arithmetic relocation.  */
3215   BFD_ARELOC_BFIN_ADD,
3216
3217 /* ADI Blackfin arithmetic relocation.  */
3218   BFD_ARELOC_BFIN_SUB,
3219
3220 /* ADI Blackfin arithmetic relocation.  */
3221   BFD_ARELOC_BFIN_MULT,
3222
3223 /* ADI Blackfin arithmetic relocation.  */
3224   BFD_ARELOC_BFIN_DIV,
3225
3226 /* ADI Blackfin arithmetic relocation.  */
3227   BFD_ARELOC_BFIN_MOD,
3228
3229 /* ADI Blackfin arithmetic relocation.  */
3230   BFD_ARELOC_BFIN_LSHIFT,
3231
3232 /* ADI Blackfin arithmetic relocation.  */
3233   BFD_ARELOC_BFIN_RSHIFT,
3234
3235 /* ADI Blackfin arithmetic relocation.  */
3236   BFD_ARELOC_BFIN_AND,
3237
3238 /* ADI Blackfin arithmetic relocation.  */
3239   BFD_ARELOC_BFIN_OR,
3240
3241 /* ADI Blackfin arithmetic relocation.  */
3242   BFD_ARELOC_BFIN_XOR,
3243
3244 /* ADI Blackfin arithmetic relocation.  */
3245   BFD_ARELOC_BFIN_LAND,
3246
3247 /* ADI Blackfin arithmetic relocation.  */
3248   BFD_ARELOC_BFIN_LOR,
3249
3250 /* ADI Blackfin arithmetic relocation.  */
3251   BFD_ARELOC_BFIN_LEN,
3252
3253 /* ADI Blackfin arithmetic relocation.  */
3254   BFD_ARELOC_BFIN_NEG,
3255
3256 /* ADI Blackfin arithmetic relocation.  */
3257   BFD_ARELOC_BFIN_COMP,
3258
3259 /* ADI Blackfin arithmetic relocation.  */
3260   BFD_ARELOC_BFIN_PAGE,
3261
3262 /* ADI Blackfin arithmetic relocation.  */
3263   BFD_ARELOC_BFIN_HWPAGE,
3264
3265 /* ADI Blackfin arithmetic relocation.  */
3266   BFD_ARELOC_BFIN_ADDR,
3267
3268 /* Mitsubishi D10V relocs.
3269 This is a 10-bit reloc with the right 2 bits
3270 assumed to be 0.  */
3271   BFD_RELOC_D10V_10_PCREL_R,
3272
3273 /* Mitsubishi D10V relocs.
3274 This is a 10-bit reloc with the right 2 bits
3275 assumed to be 0.  This is the same as the previous reloc
3276 except it is in the left container, i.e.,
3277 shifted left 15 bits.  */
3278   BFD_RELOC_D10V_10_PCREL_L,
3279
3280 /* This is an 18-bit reloc with the right 2 bits
3281 assumed to be 0.  */
3282   BFD_RELOC_D10V_18,
3283
3284 /* This is an 18-bit reloc with the right 2 bits
3285 assumed to be 0.  */
3286   BFD_RELOC_D10V_18_PCREL,
3287
3288 /* Mitsubishi D30V relocs.
3289 This is a 6-bit absolute reloc.  */
3290   BFD_RELOC_D30V_6,
3291
3292 /* This is a 6-bit pc-relative reloc with
3293 the right 3 bits assumed to be 0.  */
3294   BFD_RELOC_D30V_9_PCREL,
3295
3296 /* This is a 6-bit pc-relative reloc with
3297 the right 3 bits assumed to be 0. Same
3298 as the previous reloc but on the right side
3299 of the container.  */
3300   BFD_RELOC_D30V_9_PCREL_R,
3301
3302 /* This is a 12-bit absolute reloc with the
3303 right 3 bitsassumed to be 0.  */
3304   BFD_RELOC_D30V_15,
3305
3306 /* This is a 12-bit pc-relative reloc with
3307 the right 3 bits assumed to be 0.  */
3308   BFD_RELOC_D30V_15_PCREL,
3309
3310 /* This is a 12-bit pc-relative reloc with
3311 the right 3 bits assumed to be 0. Same
3312 as the previous reloc but on the right side
3313 of the container.  */
3314   BFD_RELOC_D30V_15_PCREL_R,
3315
3316 /* This is an 18-bit absolute reloc with
3317 the right 3 bits assumed to be 0.  */
3318   BFD_RELOC_D30V_21,
3319
3320 /* This is an 18-bit pc-relative reloc with
3321 the right 3 bits assumed to be 0.  */
3322   BFD_RELOC_D30V_21_PCREL,
3323
3324 /* This is an 18-bit pc-relative reloc with
3325 the right 3 bits assumed to be 0. Same
3326 as the previous reloc but on the right side
3327 of the container.  */
3328   BFD_RELOC_D30V_21_PCREL_R,
3329
3330 /* This is a 32-bit absolute reloc.  */
3331   BFD_RELOC_D30V_32,
3332
3333 /* This is a 32-bit pc-relative reloc.  */
3334   BFD_RELOC_D30V_32_PCREL,
3335
3336 /* DLX relocs  */
3337   BFD_RELOC_DLX_HI16_S,
3338
3339 /* DLX relocs  */
3340   BFD_RELOC_DLX_LO16,
3341
3342 /* DLX relocs  */
3343   BFD_RELOC_DLX_JMP26,
3344
3345 /* Renesas M16C/M32C Relocations.  */
3346   BFD_RELOC_M32C_HI8,
3347   BFD_RELOC_M32C_RL_JUMP,
3348   BFD_RELOC_M32C_RL_1ADDR,
3349   BFD_RELOC_M32C_RL_2ADDR,
3350
3351 /* Renesas M32R (formerly Mitsubishi M32R) relocs.
3352 This is a 24 bit absolute address.  */
3353   BFD_RELOC_M32R_24,
3354
3355 /* This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.  */
3356   BFD_RELOC_M32R_10_PCREL,
3357
3358 /* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
3359   BFD_RELOC_M32R_18_PCREL,
3360
3361 /* This is a 26-bit reloc with the right 2 bits assumed to be 0.  */
3362   BFD_RELOC_M32R_26_PCREL,
3363
3364 /* This is a 16-bit reloc containing the high 16 bits of an address
3365 used when the lower 16 bits are treated as unsigned.  */
3366   BFD_RELOC_M32R_HI16_ULO,
3367
3368 /* This is a 16-bit reloc containing the high 16 bits of an address
3369 used when the lower 16 bits are treated as signed.  */
3370   BFD_RELOC_M32R_HI16_SLO,
3371
3372 /* This is a 16-bit reloc containing the lower 16 bits of an address.  */
3373   BFD_RELOC_M32R_LO16,
3374
3375 /* This is a 16-bit reloc containing the small data area offset for use in
3376 add3, load, and store instructions.  */
3377   BFD_RELOC_M32R_SDA16,
3378
3379 /* For PIC.  */
3380   BFD_RELOC_M32R_GOT24,
3381   BFD_RELOC_M32R_26_PLTREL,
3382   BFD_RELOC_M32R_COPY,
3383   BFD_RELOC_M32R_GLOB_DAT,
3384   BFD_RELOC_M32R_JMP_SLOT,
3385   BFD_RELOC_M32R_RELATIVE,
3386   BFD_RELOC_M32R_GOTOFF,
3387   BFD_RELOC_M32R_GOTOFF_HI_ULO,
3388   BFD_RELOC_M32R_GOTOFF_HI_SLO,
3389   BFD_RELOC_M32R_GOTOFF_LO,
3390   BFD_RELOC_M32R_GOTPC24,
3391   BFD_RELOC_M32R_GOT16_HI_ULO,
3392   BFD_RELOC_M32R_GOT16_HI_SLO,
3393   BFD_RELOC_M32R_GOT16_LO,
3394   BFD_RELOC_M32R_GOTPC_HI_ULO,
3395   BFD_RELOC_M32R_GOTPC_HI_SLO,
3396   BFD_RELOC_M32R_GOTPC_LO,
3397
3398 /* This is a 9-bit reloc  */
3399   BFD_RELOC_V850_9_PCREL,
3400
3401 /* This is a 22-bit reloc  */
3402   BFD_RELOC_V850_22_PCREL,
3403
3404 /* This is a 16 bit offset from the short data area pointer.  */
3405   BFD_RELOC_V850_SDA_16_16_OFFSET,
3406
3407 /* This is a 16 bit offset (of which only 15 bits are used) from the
3408 short data area pointer.  */
3409   BFD_RELOC_V850_SDA_15_16_OFFSET,
3410
3411 /* This is a 16 bit offset from the zero data area pointer.  */
3412   BFD_RELOC_V850_ZDA_16_16_OFFSET,
3413
3414 /* This is a 16 bit offset (of which only 15 bits are used) from the
3415 zero data area pointer.  */
3416   BFD_RELOC_V850_ZDA_15_16_OFFSET,
3417
3418 /* This is an 8 bit offset (of which only 6 bits are used) from the
3419 tiny data area pointer.  */
3420   BFD_RELOC_V850_TDA_6_8_OFFSET,
3421
3422 /* This is an 8bit offset (of which only 7 bits are used) from the tiny
3423 data area pointer.  */
3424   BFD_RELOC_V850_TDA_7_8_OFFSET,
3425
3426 /* This is a 7 bit offset from the tiny data area pointer.  */
3427   BFD_RELOC_V850_TDA_7_7_OFFSET,
3428
3429 /* This is a 16 bit offset from the tiny data area pointer.  */
3430   BFD_RELOC_V850_TDA_16_16_OFFSET,
3431
3432 /* This is a 5 bit offset (of which only 4 bits are used) from the tiny
3433 data area pointer.  */
3434   BFD_RELOC_V850_TDA_4_5_OFFSET,
3435
3436 /* This is a 4 bit offset from the tiny data area pointer.  */
3437   BFD_RELOC_V850_TDA_4_4_OFFSET,
3438
3439 /* This is a 16 bit offset from the short data area pointer, with the
3440 bits placed non-contiguously in the instruction.  */
3441   BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET,
3442
3443 /* This is a 16 bit offset from the zero data area pointer, with the
3444 bits placed non-contiguously in the instruction.  */
3445   BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET,
3446
3447 /* This is a 6 bit offset from the call table base pointer.  */
3448   BFD_RELOC_V850_CALLT_6_7_OFFSET,
3449
3450 /* This is a 16 bit offset from the call table base pointer.  */
3451   BFD_RELOC_V850_CALLT_16_16_OFFSET,
3452
3453 /* Used for relaxing indirect function calls.  */
3454   BFD_RELOC_V850_LONGCALL,
3455
3456 /* Used for relaxing indirect jumps.  */
3457   BFD_RELOC_V850_LONGJUMP,
3458
3459 /* Used to maintain alignment whilst relaxing.  */
3460   BFD_RELOC_V850_ALIGN,
3461
3462 /* This is a variation of BFD_RELOC_LO16 that can be used in v850e ld.bu
3463 instructions.  */
3464   BFD_RELOC_V850_LO16_SPLIT_OFFSET,
3465
3466 /* This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
3467 instruction.  */
3468   BFD_RELOC_MN10300_32_PCREL,
3469
3470 /* This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
3471 instruction.  */
3472   BFD_RELOC_MN10300_16_PCREL,
3473
3474 /* This is a 8bit DP reloc for the tms320c30, where the most
3475 significant 8 bits of a 24 bit word are placed into the least
3476 significant 8 bits of the opcode.  */
3477   BFD_RELOC_TIC30_LDP,
3478
3479 /* This is a 7bit reloc for the tms320c54x, where the least
3480 significant 7 bits of a 16 bit word are placed into the least
3481 significant 7 bits of the opcode.  */
3482   BFD_RELOC_TIC54X_PARTLS7,
3483
3484 /* This is a 9bit DP reloc for the tms320c54x, where the most
3485 significant 9 bits of a 16 bit word are placed into the least
3486 significant 9 bits of the opcode.  */
3487   BFD_RELOC_TIC54X_PARTMS9,
3488
3489 /* This is an extended address 23-bit reloc for the tms320c54x.  */
3490   BFD_RELOC_TIC54X_23,
3491
3492 /* This is a 16-bit reloc for the tms320c54x, where the least
3493 significant 16 bits of a 23-bit extended address are placed into
3494 the opcode.  */
3495   BFD_RELOC_TIC54X_16_OF_23,
3496
3497 /* This is a reloc for the tms320c54x, where the most
3498 significant 7 bits of a 23-bit extended address are placed into
3499 the opcode.  */
3500   BFD_RELOC_TIC54X_MS7_OF_23,
3501
3502 /* This is a 48 bit reloc for the FR30 that stores 32 bits.  */
3503   BFD_RELOC_FR30_48,
3504
3505 /* This is a 32 bit reloc for the FR30 that stores 20 bits split up into
3506 two sections.  */
3507   BFD_RELOC_FR30_20,
3508
3509 /* This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
3510 4 bits.  */
3511   BFD_RELOC_FR30_6_IN_4,
3512
3513 /* This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
3514 into 8 bits.  */
3515   BFD_RELOC_FR30_8_IN_8,
3516
3517 /* This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
3518 into 8 bits.  */
3519   BFD_RELOC_FR30_9_IN_8,
3520
3521 /* This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
3522 into 8 bits.  */
3523   BFD_RELOC_FR30_10_IN_8,
3524
3525 /* This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
3526 short offset into 8 bits.  */
3527   BFD_RELOC_FR30_9_PCREL,
3528
3529 /* This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
3530 short offset into 11 bits.  */
3531   BFD_RELOC_FR30_12_PCREL,
3532
3533 /* Motorola Mcore relocations.  */
3534   BFD_RELOC_MCORE_PCREL_IMM8BY4,
3535   BFD_RELOC_MCORE_PCREL_IMM11BY2,
3536   BFD_RELOC_MCORE_PCREL_IMM4BY2,
3537   BFD_RELOC_MCORE_PCREL_32,
3538   BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2,
3539   BFD_RELOC_MCORE_RVA,
3540
3541 /* These are relocations for the GETA instruction.  */
3542   BFD_RELOC_MMIX_GETA,
3543   BFD_RELOC_MMIX_GETA_1,
3544   BFD_RELOC_MMIX_GETA_2,
3545   BFD_RELOC_MMIX_GETA_3,
3546
3547 /* These are relocations for a conditional branch instruction.  */
3548   BFD_RELOC_MMIX_CBRANCH,
3549   BFD_RELOC_MMIX_CBRANCH_J,
3550   BFD_RELOC_MMIX_CBRANCH_1,
3551   BFD_RELOC_MMIX_CBRANCH_2,
3552   BFD_RELOC_MMIX_CBRANCH_3,
3553
3554 /* These are relocations for the PUSHJ instruction.  */
3555   BFD_RELOC_MMIX_PUSHJ,
3556   BFD_RELOC_MMIX_PUSHJ_1,
3557   BFD_RELOC_MMIX_PUSHJ_2,
3558   BFD_RELOC_MMIX_PUSHJ_3,
3559   BFD_RELOC_MMIX_PUSHJ_STUBBABLE,
3560
3561 /* These are relocations for the JMP instruction.  */
3562   BFD_RELOC_MMIX_JMP,
3563   BFD_RELOC_MMIX_JMP_1,
3564   BFD_RELOC_MMIX_JMP_2,
3565   BFD_RELOC_MMIX_JMP_3,
3566
3567 /* This is a relocation for a relative address as in a GETA instruction or
3568 a branch.  */
3569   BFD_RELOC_MMIX_ADDR19,
3570
3571 /* This is a relocation for a relative address as in a JMP instruction.  */
3572   BFD_RELOC_MMIX_ADDR27,
3573
3574 /* This is a relocation for an instruction field that may be a general
3575 register or a value 0..255.  */
3576   BFD_RELOC_MMIX_REG_OR_BYTE,
3577
3578 /* This is a relocation for an instruction field that may be a general
3579 register.  */
3580   BFD_RELOC_MMIX_REG,
3581
3582 /* This is a relocation for two instruction fields holding a register and
3583 an offset, the equivalent of the relocation.  */
3584   BFD_RELOC_MMIX_BASE_PLUS_OFFSET,
3585
3586 /* This relocation is an assertion that the expression is not allocated as
3587 a global register.  It does not modify contents.  */
3588   BFD_RELOC_MMIX_LOCAL,
3589
3590 /* This is a 16 bit reloc for the AVR that stores 8 bit pc relative
3591 short offset into 7 bits.  */
3592   BFD_RELOC_AVR_7_PCREL,
3593
3594 /* This is a 16 bit reloc for the AVR that stores 13 bit pc relative
3595 short offset into 12 bits.  */
3596   BFD_RELOC_AVR_13_PCREL,
3597
3598 /* This is a 16 bit reloc for the AVR that stores 17 bit value (usually
3599 program memory address) into 16 bits.  */
3600   BFD_RELOC_AVR_16_PM,
3601
3602 /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3603 data memory address) into 8 bit immediate value of LDI insn.  */
3604   BFD_RELOC_AVR_LO8_LDI,
3605
3606 /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3607 of data memory address) into 8 bit immediate value of LDI insn.  */
3608   BFD_RELOC_AVR_HI8_LDI,
3609
3610 /* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3611 of program memory address) into 8 bit immediate value of LDI insn.  */
3612   BFD_RELOC_AVR_HH8_LDI,
3613
3614 /* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3615 of 32 bit value) into 8 bit immediate value of LDI insn.  */
3616   BFD_RELOC_AVR_MS8_LDI,
3617
3618 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3619 (usually data memory address) into 8 bit immediate value of SUBI insn.  */
3620   BFD_RELOC_AVR_LO8_LDI_NEG,
3621
3622 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3623 (high 8 bit of data memory address) into 8 bit immediate value of
3624 SUBI insn.  */
3625   BFD_RELOC_AVR_HI8_LDI_NEG,
3626
3627 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3628 (most high 8 bit of program memory address) into 8 bit immediate value
3629 of LDI or SUBI insn.  */
3630   BFD_RELOC_AVR_HH8_LDI_NEG,
3631
3632 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value (msb
3633 of 32 bit value) into 8 bit immediate value of LDI insn.  */
3634   BFD_RELOC_AVR_MS8_LDI_NEG,
3635
3636 /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
3637 command address) into 8 bit immediate value of LDI insn.  */
3638   BFD_RELOC_AVR_LO8_LDI_PM,
3639
3640 /* This is a 16 bit reloc for the AVR that stores 8 bit value 
3641 (command address) into 8 bit immediate value of LDI insn. If the address
3642 is beyond the 128k boundary, the linker inserts a jump stub for this reloc
3643 in the lower 128k.  */
3644   BFD_RELOC_AVR_LO8_LDI_GS,
3645
3646 /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3647 of command address) into 8 bit immediate value of LDI insn.  */
3648   BFD_RELOC_AVR_HI8_LDI_PM,
3649
3650 /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
3651 of command address) into 8 bit immediate value of LDI insn.  If the address
3652 is beyond the 128k boundary, the linker inserts a jump stub for this reloc
3653 below 128k.  */
3654   BFD_RELOC_AVR_HI8_LDI_GS,
3655
3656 /* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
3657 of command address) into 8 bit immediate value of LDI insn.  */
3658   BFD_RELOC_AVR_HH8_LDI_PM,
3659
3660 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3661 (usually command address) into 8 bit immediate value of SUBI insn.  */
3662   BFD_RELOC_AVR_LO8_LDI_PM_NEG,
3663
3664 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3665 (high 8 bit of 16 bit command address) into 8 bit immediate value
3666 of SUBI insn.  */
3667   BFD_RELOC_AVR_HI8_LDI_PM_NEG,
3668
3669 /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
3670 (high 6 bit of 22 bit command address) into 8 bit immediate
3671 value of SUBI insn.  */
3672   BFD_RELOC_AVR_HH8_LDI_PM_NEG,
3673
3674 /* This is a 32 bit reloc for the AVR that stores 23 bit value
3675 into 22 bits.  */
3676   BFD_RELOC_AVR_CALL,
3677
3678 /* This is a 16 bit reloc for the AVR that stores all needed bits
3679 for absolute addressing with ldi with overflow check to linktime  */
3680   BFD_RELOC_AVR_LDI,
3681
3682 /* This is a 6 bit reloc for the AVR that stores offset for ldd/std
3683 instructions  */
3684   BFD_RELOC_AVR_6,
3685
3686 /* This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
3687 instructions  */
3688   BFD_RELOC_AVR_6_ADIW,
3689
3690 /* Direct 12 bit.  */
3691   BFD_RELOC_390_12,
3692
3693 /* 12 bit GOT offset.  */
3694   BFD_RELOC_390_GOT12,
3695
3696 /* 32 bit PC relative PLT address.  */
3697   BFD_RELOC_390_PLT32,
3698
3699 /* Copy symbol at runtime.  */
3700   BFD_RELOC_390_COPY,
3701
3702 /* Create GOT entry.  */
3703   BFD_RELOC_390_GLOB_DAT,
3704
3705 /* Create PLT entry.  */
3706   BFD_RELOC_390_JMP_SLOT,
3707
3708 /* Adjust by program base.  */
3709   BFD_RELOC_390_RELATIVE,
3710
3711 /* 32 bit PC relative offset to GOT.  */
3712   BFD_RELOC_390_GOTPC,
3713
3714 /* 16 bit GOT offset.  */
3715   BFD_RELOC_390_GOT16,
3716
3717 /* PC relative 16 bit shifted by 1.  */
3718   BFD_RELOC_390_PC16DBL,
3719
3720 /* 16 bit PC rel. PLT shifted by 1.  */
3721   BFD_RELOC_390_PLT16DBL,
3722
3723 /* PC relative 32 bit shifted by 1.  */
3724   BFD_RELOC_390_PC32DBL,
3725
3726 /* 32 bit PC rel. PLT shifted by 1.  */
3727   BFD_RELOC_390_PLT32DBL,
3728
3729 /* 32 bit PC rel. GOT shifted by 1.  */
3730   BFD_RELOC_390_GOTPCDBL,
3731
3732 /* 64 bit GOT offset.  */
3733   BFD_RELOC_390_GOT64,
3734
3735 /* 64 bit PC relative PLT address.  */
3736   BFD_RELOC_390_PLT64,
3737
3738 /* 32 bit rel. offset to GOT entry.  */
3739   BFD_RELOC_390_GOTENT,
3740
3741 /* 64 bit offset to GOT.  */
3742   BFD_RELOC_390_GOTOFF64,
3743
3744 /* 12-bit offset to symbol-entry within GOT, with PLT handling.  */
3745   BFD_RELOC_390_GOTPLT12,
3746
3747 /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
3748   BFD_RELOC_390_GOTPLT16,
3749
3750 /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
3751   BFD_RELOC_390_GOTPLT32,
3752
3753 /* 64-bit offset to symbol-entry within GOT, with PLT handling.  */
3754   BFD_RELOC_390_GOTPLT64,
3755
3756 /* 32-bit rel. offset to symbol-entry within GOT, with PLT handling.  */
3757   BFD_RELOC_390_GOTPLTENT,
3758
3759 /* 16-bit rel. offset from the GOT to a PLT entry.  */
3760   BFD_RELOC_390_PLTOFF16,
3761
3762 /* 32-bit rel. offset from the GOT to a PLT entry.  */
3763   BFD_RELOC_390_PLTOFF32,
3764
3765 /* 64-bit rel. offset from the GOT to a PLT entry.  */
3766   BFD_RELOC_390_PLTOFF64,
3767
3768 /* s390 tls relocations.  */
3769   BFD_RELOC_390_TLS_LOAD,
3770   BFD_RELOC_390_TLS_GDCALL,
3771   BFD_RELOC_390_TLS_LDCALL,
3772   BFD_RELOC_390_TLS_GD32,
3773   BFD_RELOC_390_TLS_GD64,
3774   BFD_RELOC_390_TLS_GOTIE12,
3775   BFD_RELOC_390_TLS_GOTIE32,
3776   BFD_RELOC_390_TLS_GOTIE64,
3777   BFD_RELOC_390_TLS_LDM32,
3778   BFD_RELOC_390_TLS_LDM64,
3779   BFD_RELOC_390_TLS_IE32,
3780   BFD_RELOC_390_TLS_IE64,
3781   BFD_RELOC_390_TLS_IEENT,
3782   BFD_RELOC_390_TLS_LE32,
3783   BFD_RELOC_390_TLS_LE64,
3784   BFD_RELOC_390_TLS_LDO32,
3785   BFD_RELOC_390_TLS_LDO64,
3786   BFD_RELOC_390_TLS_DTPMOD,
3787   BFD_RELOC_390_TLS_DTPOFF,
3788   BFD_RELOC_390_TLS_TPOFF,
3789
3790 /* Long displacement extension.  */
3791   BFD_RELOC_390_20,
3792   BFD_RELOC_390_GOT20,
3793   BFD_RELOC_390_GOTPLT20,
3794   BFD_RELOC_390_TLS_GOTIE20,
3795
3796 /* Score relocations  */
3797   BFD_RELOC_SCORE_DUMMY1,
3798
3799 /* Low 16 bit for load/store  */
3800   BFD_RELOC_SCORE_GPREL15,
3801
3802 /* This is a 24-bit reloc with the right 1 bit assumed to be 0  */
3803   BFD_RELOC_SCORE_DUMMY2,
3804   BFD_RELOC_SCORE_JMP,
3805
3806 /* This is a 19-bit reloc with the right 1 bit assumed to be 0  */
3807   BFD_RELOC_SCORE_BRANCH,
3808
3809 /* This is a 11-bit reloc with the right 1 bit assumed to be 0  */
3810   BFD_RELOC_SCORE16_JMP,
3811
3812 /* This is a 8-bit reloc with the right 1 bit assumed to be 0  */
3813   BFD_RELOC_SCORE16_BRANCH,
3814
3815 /* Undocumented Score relocs  */
3816   BFD_RELOC_SCORE_GOT15,
3817   BFD_RELOC_SCORE_GOT_LO16,
3818   BFD_RELOC_SCORE_CALL15,
3819   BFD_RELOC_SCORE_DUMMY_HI16,
3820
3821 /* Scenix IP2K - 9-bit register number / data address  */
3822   BFD_RELOC_IP2K_FR9,
3823
3824 /* Scenix IP2K - 4-bit register/data bank number  */
3825   BFD_RELOC_IP2K_BANK,
3826
3827 /* Scenix IP2K - low 13 bits of instruction word address  */
3828   BFD_RELOC_IP2K_ADDR16CJP,
3829
3830 /* Scenix IP2K - high 3 bits of instruction word address  */
3831   BFD_RELOC_IP2K_PAGE3,
3832
3833 /* Scenix IP2K - ext/low/high 8 bits of data address  */
3834   BFD_RELOC_IP2K_LO8DATA,
3835   BFD_RELOC_IP2K_HI8DATA,
3836   BFD_RELOC_IP2K_EX8DATA,
3837
3838 /* Scenix IP2K - low/high 8 bits of instruction word address  */
3839   BFD_RELOC_IP2K_LO8INSN,
3840   BFD_RELOC_IP2K_HI8INSN,
3841
3842 /* Scenix IP2K - even/odd PC modifier to modify snb pcl.0  */
3843   BFD_RELOC_IP2K_PC_SKIP,
3844
3845 /* Scenix IP2K - 16 bit word address in text section.  */
3846   BFD_RELOC_IP2K_TEXT,
3847
3848 /* Scenix IP2K - 7-bit sp or dp offset  */
3849   BFD_RELOC_IP2K_FR_OFFSET,
3850
3851 /* Scenix VPE4K coprocessor - data/insn-space addressing  */
3852   BFD_RELOC_VPE4KMATH_DATA,
3853   BFD_RELOC_VPE4KMATH_INSN,
3854
3855 /* These two relocations are used by the linker to determine which of
3856 the entries in a C++ virtual function table are actually used.  When
3857 the --gc-sections option is given, the linker will zero out the entries
3858 that are not used, so that the code for those functions need not be
3859 included in the output.
3860
3861 VTABLE_INHERIT is a zero-space relocation used to describe to the
3862 linker the inheritance tree of a C++ virtual function table.  The
3863 relocation's symbol should be the parent class' vtable, and the
3864 relocation should be located at the child vtable.
3865
3866 VTABLE_ENTRY is a zero-space relocation that describes the use of a
3867 virtual function table entry.  The reloc's symbol should refer to the
3868 table of the class mentioned in the code.  Off of that base, an offset
3869 describes the entry that is being used.  For Rela hosts, this offset
3870 is stored in the reloc's addend.  For Rel hosts, we are forced to put
3871 this offset in the reloc's section offset.  */
3872   BFD_RELOC_VTABLE_INHERIT,
3873   BFD_RELOC_VTABLE_ENTRY,
3874
3875 /* Intel IA64 Relocations.  */
3876   BFD_RELOC_IA64_IMM14,
3877   BFD_RELOC_IA64_IMM22,
3878   BFD_RELOC_IA64_IMM64,
3879   BFD_RELOC_IA64_DIR32MSB,
3880   BFD_RELOC_IA64_DIR32LSB,
3881   BFD_RELOC_IA64_DIR64MSB,
3882   BFD_RELOC_IA64_DIR64LSB,
3883   BFD_RELOC_IA64_GPREL22,
3884   BFD_RELOC_IA64_GPREL64I,
3885   BFD_RELOC_IA64_GPREL32MSB,
3886   BFD_RELOC_IA64_GPREL32LSB,
3887   BFD_RELOC_IA64_GPREL64MSB,
3888   BFD_RELOC_IA64_GPREL64LSB,
3889   BFD_RELOC_IA64_LTOFF22,
3890   BFD_RELOC_IA64_LTOFF64I,
3891   BFD_RELOC_IA64_PLTOFF22,
3892   BFD_RELOC_IA64_PLTOFF64I,
3893   BFD_RELOC_IA64_PLTOFF64MSB,
3894   BFD_RELOC_IA64_PLTOFF64LSB,
3895   BFD_RELOC_IA64_FPTR64I,
3896   BFD_RELOC_IA64_FPTR32MSB,
3897   BFD_RELOC_IA64_FPTR32LSB,
3898   BFD_RELOC_IA64_FPTR64MSB,
3899   BFD_RELOC_IA64_FPTR64LSB,
3900   BFD_RELOC_IA64_PCREL21B,
3901   BFD_RELOC_IA64_PCREL21BI,
3902   BFD_RELOC_IA64_PCREL21M,
3903   BFD_RELOC_IA64_PCREL21F,
3904   BFD_RELOC_IA64_PCREL22,
3905   BFD_RELOC_IA64_PCREL60B,
3906   BFD_RELOC_IA64_PCREL64I,
3907   BFD_RELOC_IA64_PCREL32MSB,
3908   BFD_RELOC_IA64_PCREL32LSB,
3909   BFD_RELOC_IA64_PCREL64MSB,
3910   BFD_RELOC_IA64_PCREL64LSB,
3911   BFD_RELOC_IA64_LTOFF_FPTR22,
3912   BFD_RELOC_IA64_LTOFF_FPTR64I,
3913   BFD_RELOC_IA64_LTOFF_FPTR32MSB,
3914   BFD_RELOC_IA64_LTOFF_FPTR32LSB,
3915   BFD_RELOC_IA64_LTOFF_FPTR64MSB,
3916   BFD_RELOC_IA64_LTOFF_FPTR64LSB,
3917   BFD_RELOC_IA64_SEGREL32MSB,
3918   BFD_RELOC_IA64_SEGREL32LSB,
3919   BFD_RELOC_IA64_SEGREL64MSB,
3920   BFD_RELOC_IA64_SEGREL64LSB,
3921   BFD_RELOC_IA64_SECREL32MSB,
3922   BFD_RELOC_IA64_SECREL32LSB,
3923   BFD_RELOC_IA64_SECREL64MSB,
3924   BFD_RELOC_IA64_SECREL64LSB,
3925   BFD_RELOC_IA64_REL32MSB,
3926   BFD_RELOC_IA64_REL32LSB,
3927   BFD_RELOC_IA64_REL64MSB,
3928   BFD_RELOC_IA64_REL64LSB,
3929   BFD_RELOC_IA64_LTV32MSB,
3930   BFD_RELOC_IA64_LTV32LSB,
3931   BFD_RELOC_IA64_LTV64MSB,
3932   BFD_RELOC_IA64_LTV64LSB,
3933   BFD_RELOC_IA64_IPLTMSB,
3934   BFD_RELOC_IA64_IPLTLSB,
3935   BFD_RELOC_IA64_COPY,
3936   BFD_RELOC_IA64_LTOFF22X,
3937   BFD_RELOC_IA64_LDXMOV,
3938   BFD_RELOC_IA64_TPREL14,
3939   BFD_RELOC_IA64_TPREL22,
3940   BFD_RELOC_IA64_TPREL64I,
3941   BFD_RELOC_IA64_TPREL64MSB,
3942   BFD_RELOC_IA64_TPREL64LSB,
3943   BFD_RELOC_IA64_LTOFF_TPREL22,
3944   BFD_RELOC_IA64_DTPMOD64MSB,
3945   BFD_RELOC_IA64_DTPMOD64LSB,
3946   BFD_RELOC_IA64_LTOFF_DTPMOD22,
3947   BFD_RELOC_IA64_DTPREL14,
3948   BFD_RELOC_IA64_DTPREL22,
3949   BFD_RELOC_IA64_DTPREL64I,
3950   BFD_RELOC_IA64_DTPREL32MSB,
3951   BFD_RELOC_IA64_DTPREL32LSB,
3952   BFD_RELOC_IA64_DTPREL64MSB,
3953   BFD_RELOC_IA64_DTPREL64LSB,
3954   BFD_RELOC_IA64_LTOFF_DTPREL22,
3955
3956 /* Motorola 68HC11 reloc.
3957 This is the 8 bit high part of an absolute address.  */
3958   BFD_RELOC_M68HC11_HI8,
3959
3960 /* Motorola 68HC11 reloc.
3961 This is the 8 bit low part of an absolute address.  */
3962   BFD_RELOC_M68HC11_LO8,
3963
3964 /* Motorola 68HC11 reloc.
3965 This is the 3 bit of a value.  */
3966   BFD_RELOC_M68HC11_3B,
3967
3968 /* Motorola 68HC11 reloc.
3969 This reloc marks the beginning of a jump/call instruction.
3970 It is used for linker relaxation to correctly identify beginning
3971 of instruction and change some branches to use PC-relative
3972 addressing mode.  */
3973   BFD_RELOC_M68HC11_RL_JUMP,
3974
3975 /* Motorola 68HC11 reloc.
3976 This reloc marks a group of several instructions that gcc generates
3977 and for which the linker relaxation pass can modify and/or remove
3978 some of them.  */
3979   BFD_RELOC_M68HC11_RL_GROUP,
3980
3981 /* Motorola 68HC11 reloc.
3982 This is the 16-bit lower part of an address.  It is used for 'call'
3983 instruction to specify the symbol address without any special
3984 transformation (due to memory bank window).  */
3985   BFD_RELOC_M68HC11_LO16,
3986
3987 /* Motorola 68HC11 reloc.
3988 This is a 8-bit reloc that specifies the page number of an address.
3989 It is used by 'call' instruction to specify the page number of
3990 the symbol.  */
3991   BFD_RELOC_M68HC11_PAGE,
3992
3993 /* Motorola 68HC11 reloc.
3994 This is a 24-bit reloc that represents the address with a 16-bit
3995 value and a 8-bit page number.  The symbol address is transformed
3996 to follow the 16K memory bank of 68HC12 (seen as mapped in the window).  */
3997   BFD_RELOC_M68HC11_24,
3998
3999 /* Motorola 68HC12 reloc.
4000 This is the 5 bits of a value.  */
4001   BFD_RELOC_M68HC12_5B,
4002
4003 /* NS CR16C Relocations.  */
4004   BFD_RELOC_16C_NUM08,
4005   BFD_RELOC_16C_NUM08_C,
4006   BFD_RELOC_16C_NUM16,
4007   BFD_RELOC_16C_NUM16_C,
4008   BFD_RELOC_16C_NUM32,
4009   BFD_RELOC_16C_NUM32_C,
4010   BFD_RELOC_16C_DISP04,
4011   BFD_RELOC_16C_DISP04_C,
4012   BFD_RELOC_16C_DISP08,
4013   BFD_RELOC_16C_DISP08_C,
4014   BFD_RELOC_16C_DISP16,
4015   BFD_RELOC_16C_DISP16_C,
4016   BFD_RELOC_16C_DISP24,
4017   BFD_RELOC_16C_DISP24_C,
4018   BFD_RELOC_16C_DISP24a,
4019   BFD_RELOC_16C_DISP24a_C,
4020   BFD_RELOC_16C_REG04,
4021   BFD_RELOC_16C_REG04_C,
4022   BFD_RELOC_16C_REG04a,
4023   BFD_RELOC_16C_REG04a_C,
4024   BFD_RELOC_16C_REG14,
4025   BFD_RELOC_16C_REG14_C,
4026   BFD_RELOC_16C_REG16,
4027   BFD_RELOC_16C_REG16_C,
4028   BFD_RELOC_16C_REG20,
4029   BFD_RELOC_16C_REG20_C,
4030   BFD_RELOC_16C_ABS20,
4031   BFD_RELOC_16C_ABS20_C,
4032   BFD_RELOC_16C_ABS24,
4033   BFD_RELOC_16C_ABS24_C,
4034   BFD_RELOC_16C_IMM04,
4035   BFD_RELOC_16C_IMM04_C,
4036   BFD_RELOC_16C_IMM16,
4037   BFD_RELOC_16C_IMM16_C,
4038   BFD_RELOC_16C_IMM20,
4039   BFD_RELOC_16C_IMM20_C,
4040   BFD_RELOC_16C_IMM24,
4041   BFD_RELOC_16C_IMM24_C,
4042   BFD_RELOC_16C_IMM32,
4043   BFD_RELOC_16C_IMM32_C,
4044
4045 /* NS CRX Relocations.  */
4046   BFD_RELOC_CRX_REL4,
4047   BFD_RELOC_CRX_REL8,
4048   BFD_RELOC_CRX_REL8_CMP,
4049   BFD_RELOC_CRX_REL16,
4050   BFD_RELOC_CRX_REL24,
4051   BFD_RELOC_CRX_REL32,
4052   BFD_RELOC_CRX_REGREL12,
4053   BFD_RELOC_CRX_REGREL22,
4054   BFD_RELOC_CRX_REGREL28,
4055   BFD_RELOC_CRX_REGREL32,
4056   BFD_RELOC_CRX_ABS16,
4057   BFD_RELOC_CRX_ABS32,
4058   BFD_RELOC_CRX_NUM8,
4059   BFD_RELOC_CRX_NUM16,
4060   BFD_RELOC_CRX_NUM32,
4061   BFD_RELOC_CRX_IMM16,
4062   BFD_RELOC_CRX_IMM32,
4063   BFD_RELOC_CRX_SWITCH8,
4064   BFD_RELOC_CRX_SWITCH16,
4065   BFD_RELOC_CRX_SWITCH32,
4066
4067 /* These relocs are only used within the CRIS assembler.  They are not
4068 (at present) written to any object files.  */
4069   BFD_RELOC_CRIS_BDISP8,
4070   BFD_RELOC_CRIS_UNSIGNED_5,
4071   BFD_RELOC_CRIS_SIGNED_6,
4072   BFD_RELOC_CRIS_UNSIGNED_6,
4073   BFD_RELOC_CRIS_SIGNED_8,
4074   BFD_RELOC_CRIS_UNSIGNED_8,
4075   BFD_RELOC_CRIS_SIGNED_16,
4076   BFD_RELOC_CRIS_UNSIGNED_16,
4077   BFD_RELOC_CRIS_LAPCQ_OFFSET,
4078   BFD_RELOC_CRIS_UNSIGNED_4,
4079
4080 /* Relocs used in ELF shared libraries for CRIS.  */
4081   BFD_RELOC_CRIS_COPY,
4082   BFD_RELOC_CRIS_GLOB_DAT,
4083   BFD_RELOC_CRIS_JUMP_SLOT,
4084   BFD_RELOC_CRIS_RELATIVE,
4085
4086 /* 32-bit offset to symbol-entry within GOT.  */
4087   BFD_RELOC_CRIS_32_GOT,
4088
4089 /* 16-bit offset to symbol-entry within GOT.  */
4090   BFD_RELOC_CRIS_16_GOT,
4091
4092 /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
4093   BFD_RELOC_CRIS_32_GOTPLT,
4094
4095 /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
4096   BFD_RELOC_CRIS_16_GOTPLT,
4097
4098 /* 32-bit offset to symbol, relative to GOT.  */
4099   BFD_RELOC_CRIS_32_GOTREL,
4100
4101 /* 32-bit offset to symbol with PLT entry, relative to GOT.  */
4102   BFD_RELOC_CRIS_32_PLT_GOTREL,
4103
4104 /* 32-bit offset to symbol with PLT entry, relative to this relocation.  */
4105   BFD_RELOC_CRIS_32_PLT_PCREL,
4106
4107 /* Intel i860 Relocations.  */
4108   BFD_RELOC_860_COPY,
4109   BFD_RELOC_860_GLOB_DAT,
4110   BFD_RELOC_860_JUMP_SLOT,
4111   BFD_RELOC_860_RELATIVE,
4112   BFD_RELOC_860_PC26,
4113   BFD_RELOC_860_PLT26,
4114   BFD_RELOC_860_PC16,
4115   BFD_RELOC_860_LOW0,
4116   BFD_RELOC_860_SPLIT0,
4117   BFD_RELOC_860_LOW1,
4118   BFD_RELOC_860_SPLIT1,
4119   BFD_RELOC_860_LOW2,
4120   BFD_RELOC_860_SPLIT2,
4121   BFD_RELOC_860_LOW3,
4122   BFD_RELOC_860_LOGOT0,
4123   BFD_RELOC_860_SPGOT0,
4124   BFD_RELOC_860_LOGOT1,
4125   BFD_RELOC_860_SPGOT1,
4126   BFD_RELOC_860_LOGOTOFF0,
4127   BFD_RELOC_860_SPGOTOFF0,
4128   BFD_RELOC_860_LOGOTOFF1,
4129   BFD_RELOC_860_SPGOTOFF1,
4130   BFD_RELOC_860_LOGOTOFF2,
4131   BFD_RELOC_860_LOGOTOFF3,
4132   BFD_RELOC_860_LOPC,
4133   BFD_RELOC_860_HIGHADJ,
4134   BFD_RELOC_860_HAGOT,
4135   BFD_RELOC_860_HAGOTOFF,
4136   BFD_RELOC_860_HAPC,
4137   BFD_RELOC_860_HIGH,
4138   BFD_RELOC_860_HIGOT,
4139   BFD_RELOC_860_HIGOTOFF,
4140
4141 /* OpenRISC Relocations.  */
4142   BFD_RELOC_OPENRISC_ABS_26,
4143   BFD_RELOC_OPENRISC_REL_26,
4144
4145 /* H8 elf Relocations.  */
4146   BFD_RELOC_H8_DIR16A8,
4147   BFD_RELOC_H8_DIR16R8,
4148   BFD_RELOC_H8_DIR24A8,
4149   BFD_RELOC_H8_DIR24R8,
4150   BFD_RELOC_H8_DIR32A16,
4151
4152 /* Sony Xstormy16 Relocations.  */
4153   BFD_RELOC_XSTORMY16_REL_12,
4154   BFD_RELOC_XSTORMY16_12,
4155   BFD_RELOC_XSTORMY16_24,
4156   BFD_RELOC_XSTORMY16_FPTR16,
4157
4158 /* Infineon Relocations.  */
4159   BFD_RELOC_XC16X_PAG,
4160   BFD_RELOC_XC16X_POF,
4161   BFD_RELOC_XC16X_SEG,
4162   BFD_RELOC_XC16X_SOF,
4163
4164 /* Relocations used by VAX ELF.  */
4165   BFD_RELOC_VAX_GLOB_DAT,
4166   BFD_RELOC_VAX_JMP_SLOT,
4167   BFD_RELOC_VAX_RELATIVE,
4168
4169 /* Morpho MT - 16 bit immediate relocation.  */
4170   BFD_RELOC_MT_PC16,
4171
4172 /* Morpho MT - Hi 16 bits of an address.  */
4173   BFD_RELOC_MT_HI16,
4174
4175 /* Morpho MT - Low 16 bits of an address.  */
4176   BFD_RELOC_MT_LO16,
4177
4178 /* Morpho MT - Used to tell the linker which vtable entries are used.  */
4179   BFD_RELOC_MT_GNU_VTINHERIT,
4180
4181 /* Morpho MT - Used to tell the linker which vtable entries are used.  */
4182   BFD_RELOC_MT_GNU_VTENTRY,
4183
4184 /* Morpho MT - 8 bit immediate relocation.  */
4185   BFD_RELOC_MT_PCINSN8,
4186
4187 /* msp430 specific relocation codes  */
4188   BFD_RELOC_MSP430_10_PCREL,
4189   BFD_RELOC_MSP430_16_PCREL,
4190   BFD_RELOC_MSP430_16,
4191   BFD_RELOC_MSP430_16_PCREL_BYTE,
4192   BFD_RELOC_MSP430_16_BYTE,
4193   BFD_RELOC_MSP430_2X_PCREL,
4194   BFD_RELOC_MSP430_RL_PCREL,
4195
4196 /* IQ2000 Relocations.  */
4197   BFD_RELOC_IQ2000_OFFSET_16,
4198   BFD_RELOC_IQ2000_OFFSET_21,
4199   BFD_RELOC_IQ2000_UHI16,
4200
4201 /* Special Xtensa relocation used only by PLT entries in ELF shared
4202 objects to indicate that the runtime linker should set the value
4203 to one of its own internal functions or data structures.  */
4204   BFD_RELOC_XTENSA_RTLD,
4205
4206 /* Xtensa relocations for ELF shared objects.  */
4207   BFD_RELOC_XTENSA_GLOB_DAT,
4208   BFD_RELOC_XTENSA_JMP_SLOT,
4209   BFD_RELOC_XTENSA_RELATIVE,
4210
4211 /* Xtensa relocation used in ELF object files for symbols that may require
4212 PLT entries.  Otherwise, this is just a generic 32-bit relocation.  */
4213   BFD_RELOC_XTENSA_PLT,
4214
4215 /* Xtensa relocations to mark the difference of two local symbols.
4216 These are only needed to support linker relaxation and can be ignored
4217 when not relaxing.  The field is set to the value of the difference
4218 assuming no relaxation.  The relocation encodes the position of the
4219 first symbol so the linker can determine whether to adjust the field
4220 value.  */
4221   BFD_RELOC_XTENSA_DIFF8,
4222   BFD_RELOC_XTENSA_DIFF16,
4223   BFD_RELOC_XTENSA_DIFF32,
4224
4225 /* Generic Xtensa relocations for instruction operands.  Only the slot
4226 number is encoded in the relocation.  The relocation applies to the
4227 last PC-relative immediate operand, or if there are no PC-relative
4228 immediates, to the last immediate operand.  */
4229   BFD_RELOC_XTENSA_SLOT0_OP,
4230   BFD_RELOC_XTENSA_SLOT1_OP,
4231   BFD_RELOC_XTENSA_SLOT2_OP,
4232   BFD_RELOC_XTENSA_SLOT3_OP,
4233   BFD_RELOC_XTENSA_SLOT4_OP,
4234   BFD_RELOC_XTENSA_SLOT5_OP,
4235   BFD_RELOC_XTENSA_SLOT6_OP,
4236   BFD_RELOC_XTENSA_SLOT7_OP,
4237   BFD_RELOC_XTENSA_SLOT8_OP,
4238   BFD_RELOC_XTENSA_SLOT9_OP,
4239   BFD_RELOC_XTENSA_SLOT10_OP,
4240   BFD_RELOC_XTENSA_SLOT11_OP,
4241   BFD_RELOC_XTENSA_SLOT12_OP,
4242   BFD_RELOC_XTENSA_SLOT13_OP,
4243   BFD_RELOC_XTENSA_SLOT14_OP,
4244
4245 /* Alternate Xtensa relocations.  Only the slot is encoded in the
4246 relocation.  The meaning of these relocations is opcode-specific.  */
4247   BFD_RELOC_XTENSA_SLOT0_ALT,
4248   BFD_RELOC_XTENSA_SLOT1_ALT,
4249   BFD_RELOC_XTENSA_SLOT2_ALT,
4250   BFD_RELOC_XTENSA_SLOT3_ALT,
4251   BFD_RELOC_XTENSA_SLOT4_ALT,
4252   BFD_RELOC_XTENSA_SLOT5_ALT,
4253   BFD_RELOC_XTENSA_SLOT6_ALT,
4254   BFD_RELOC_XTENSA_SLOT7_ALT,
4255   BFD_RELOC_XTENSA_SLOT8_ALT,
4256   BFD_RELOC_XTENSA_SLOT9_ALT,
4257   BFD_RELOC_XTENSA_SLOT10_ALT,
4258   BFD_RELOC_XTENSA_SLOT11_ALT,
4259   BFD_RELOC_XTENSA_SLOT12_ALT,
4260   BFD_RELOC_XTENSA_SLOT13_ALT,
4261   BFD_RELOC_XTENSA_SLOT14_ALT,
4262
4263 /* Xtensa relocations for backward compatibility.  These have all been
4264 replaced by BFD_RELOC_XTENSA_SLOT0_OP.  */
4265   BFD_RELOC_XTENSA_OP0,
4266   BFD_RELOC_XTENSA_OP1,
4267   BFD_RELOC_XTENSA_OP2,
4268
4269 /* Xtensa relocation to mark that the assembler expanded the
4270 instructions from an original target.  The expansion size is
4271 encoded in the reloc size.  */
4272   BFD_RELOC_XTENSA_ASM_EXPAND,
4273
4274 /* Xtensa relocation to mark that the linker should simplify
4275 assembler-expanded instructions.  This is commonly used
4276 internally by the linker after analysis of a
4277 BFD_RELOC_XTENSA_ASM_EXPAND.  */
4278   BFD_RELOC_XTENSA_ASM_SIMPLIFY,
4279
4280 /* 8 bit signed offset in (ix+d) or (iy+d).  */
4281   BFD_RELOC_Z80_DISP8,
4282
4283 /* DJNZ offset.  */
4284   BFD_RELOC_Z8K_DISP7,
4285
4286 /* CALR offset.  */
4287   BFD_RELOC_Z8K_CALLR,
4288
4289 /* 4 bit value.  */
4290   BFD_RELOC_Z8K_IMM4L,
4291   BFD_RELOC_UNUSED };
4292 typedef enum bfd_reloc_code_real bfd_reloc_code_real_type;
4293 reloc_howto_type *bfd_reloc_type_lookup
4294    (bfd *abfd, bfd_reloc_code_real_type code);
4295
4296 const char *bfd_get_reloc_code_name (bfd_reloc_code_real_type code);
4297
4298 /* Extracted from syms.c.  */
4299
4300 typedef struct bfd_symbol
4301 {
4302   /* A pointer to the BFD which owns the symbol. This information
4303      is necessary so that a back end can work out what additional
4304      information (invisible to the application writer) is carried
4305      with the symbol.
4306
4307      This field is *almost* redundant, since you can use section->owner
4308      instead, except that some symbols point to the global sections
4309      bfd_{abs,com,und}_section.  This could be fixed by making
4310      these globals be per-bfd (or per-target-flavor).  FIXME.  */
4311   struct bfd *the_bfd; /* Use bfd_asymbol_bfd(sym) to access this field.  */
4312
4313   /* The text of the symbol. The name is left alone, and not copied; the
4314      application may not alter it.  */
4315   const char *name;
4316
4317   /* The value of the symbol.  This really should be a union of a
4318      numeric value with a pointer, since some flags indicate that
4319      a pointer to another symbol is stored here.  */
4320   symvalue value;
4321
4322   /* Attributes of a symbol.  */
4323 #define BSF_NO_FLAGS    0x00
4324
4325   /* The symbol has local scope; <<static>> in <<C>>. The value
4326      is the offset into the section of the data.  */
4327 #define BSF_LOCAL      0x01
4328
4329   /* The symbol has global scope; initialized data in <<C>>. The
4330      value is the offset into the section of the data.  */
4331 #define BSF_GLOBAL     0x02
4332
4333   /* The symbol has global scope and is exported. The value is
4334      the offset into the section of the data.  */
4335 #define BSF_EXPORT     BSF_GLOBAL /* No real difference.  */
4336
4337   /* A normal C symbol would be one of:
4338      <<BSF_LOCAL>>, <<BSF_FORT_COMM>>,  <<BSF_UNDEFINED>> or
4339      <<BSF_GLOBAL>>.  */
4340
4341   /* The symbol is a debugging record. The value has an arbitrary
4342      meaning, unless BSF_DEBUGGING_RELOC is also set.  */
4343 #define BSF_DEBUGGING  0x08
4344
4345   /* The symbol denotes a function entry point.  Used in ELF,
4346      perhaps others someday.  */
4347 #define BSF_FUNCTION    0x10
4348
4349   /* Used by the linker.  */
4350 #define BSF_KEEP        0x20
4351 #define BSF_KEEP_G      0x40
4352
4353   /* A weak global symbol, overridable without warnings by
4354      a regular global symbol of the same name.  */
4355 #define BSF_WEAK        0x80
4356
4357   /* This symbol was created to point to a section, e.g. ELF's
4358      STT_SECTION symbols.  */
4359 #define BSF_SECTION_SYM 0x100
4360
4361   /* The symbol used to be a common symbol, but now it is
4362      allocated.  */
4363 #define BSF_OLD_COMMON  0x200
4364
4365   /* The default value for common data.  */
4366 #define BFD_FORT_COMM_DEFAULT_VALUE 0
4367
4368   /* In some files the type of a symbol sometimes alters its
4369      location in an output file - ie in coff a <<ISFCN>> symbol
4370      which is also <<C_EXT>> symbol appears where it was
4371      declared and not at the end of a section.  This bit is set
4372      by the target BFD part to convey this information.  */
4373 #define BSF_NOT_AT_END    0x400
4374
4375   /* Signal that the symbol is the label of constructor section.  */
4376 #define BSF_CONSTRUCTOR   0x800
4377
4378   /* Signal that the symbol is a warning symbol.  The name is a
4379      warning.  The name of the next symbol is the one to warn about;
4380      if a reference is made to a symbol with the same name as the next
4381      symbol, a warning is issued by the linker.  */
4382 #define BSF_WARNING       0x1000
4383
4384   /* Signal that the symbol is indirect.  This symbol is an indirect
4385      pointer to the symbol with the same name as the next symbol.  */
4386 #define BSF_INDIRECT      0x2000
4387
4388   /* BSF_FILE marks symbols that contain a file name.  This is used
4389      for ELF STT_FILE symbols.  */
4390 #define BSF_FILE          0x4000
4391
4392   /* Symbol is from dynamic linking information.  */
4393 #define BSF_DYNAMIC       0x8000
4394
4395   /* The symbol denotes a data object.  Used in ELF, and perhaps
4396      others someday.  */
4397 #define BSF_OBJECT        0x10000
4398
4399   /* This symbol is a debugging symbol.  The value is the offset
4400      into the section of the data.  BSF_DEBUGGING should be set
4401      as well.  */
4402 #define BSF_DEBUGGING_RELOC 0x20000
4403
4404   /* This symbol is thread local.  Used in ELF.  */
4405 #define BSF_THREAD_LOCAL  0x40000
4406
4407   flagword flags;
4408
4409   /* A pointer to the section to which this symbol is
4410      relative.  This will always be non NULL, there are special
4411      sections for undefined and absolute symbols.  */
4412   struct bfd_section *section;
4413
4414   /* Back end special data.  */
4415   union
4416     {
4417       void *p;
4418       bfd_vma i;
4419     }
4420   udata;
4421 }
4422 asymbol;
4423
4424 #define bfd_get_symtab_upper_bound(abfd) \
4425      BFD_SEND (abfd, _bfd_get_symtab_upper_bound, (abfd))
4426
4427 bfd_boolean bfd_is_local_label (bfd *abfd, asymbol *sym);
4428
4429 bfd_boolean bfd_is_local_label_name (bfd *abfd, const char *name);
4430
4431 #define bfd_is_local_label_name(abfd, name) \
4432   BFD_SEND (abfd, _bfd_is_local_label_name, (abfd, name))
4433
4434 bfd_boolean bfd_is_target_special_symbol (bfd *abfd, asymbol *sym);
4435
4436 #define bfd_is_target_special_symbol(abfd, sym) \
4437   BFD_SEND (abfd, _bfd_is_target_special_symbol, (abfd, sym))
4438
4439 #define bfd_canonicalize_symtab(abfd, location) \
4440   BFD_SEND (abfd, _bfd_canonicalize_symtab, (abfd, location))
4441
4442 bfd_boolean bfd_set_symtab
4443    (bfd *abfd, asymbol **location, unsigned int count);
4444
4445 void bfd_print_symbol_vandf (bfd *abfd, void *file, asymbol *symbol);
4446
4447 #define bfd_make_empty_symbol(abfd) \
4448   BFD_SEND (abfd, _bfd_make_empty_symbol, (abfd))
4449
4450 asymbol *_bfd_generic_make_empty_symbol (bfd *);
4451
4452 #define bfd_make_debug_symbol(abfd,ptr,size) \
4453   BFD_SEND (abfd, _bfd_make_debug_symbol, (abfd, ptr, size))
4454
4455 int bfd_decode_symclass (asymbol *symbol);
4456
4457 bfd_boolean bfd_is_undefined_symclass (int symclass);
4458
4459 void bfd_symbol_info (asymbol *symbol, symbol_info *ret);
4460
4461 bfd_boolean bfd_copy_private_symbol_data
4462    (bfd *ibfd, asymbol *isym, bfd *obfd, asymbol *osym);
4463
4464 #define bfd_copy_private_symbol_data(ibfd, isymbol, obfd, osymbol) \
4465   BFD_SEND (obfd, _bfd_copy_private_symbol_data, \
4466             (ibfd, isymbol, obfd, osymbol))
4467
4468 /* Extracted from bfd.c.  */
4469 struct bfd
4470 {
4471   /* A unique identifier of the BFD  */
4472   unsigned int id;
4473
4474   /* The filename the application opened the BFD with.  */
4475   const char *filename;
4476
4477   /* A pointer to the target jump table.  */
4478   const struct bfd_target *xvec;
4479
4480   /* The IOSTREAM, and corresponding IO vector that provide access
4481      to the file backing the BFD.  */
4482   void *iostream;
4483   const struct bfd_iovec *iovec;
4484
4485   /* Is the file descriptor being cached?  That is, can it be closed as
4486      needed, and re-opened when accessed later?  */
4487   bfd_boolean cacheable;
4488
4489   /* Marks whether there was a default target specified when the
4490      BFD was opened. This is used to select which matching algorithm
4491      to use to choose the back end.  */
4492   bfd_boolean target_defaulted;
4493
4494   /* The caching routines use these to maintain a
4495      least-recently-used list of BFDs.  */
4496   struct bfd *lru_prev, *lru_next;
4497
4498   /* When a file is closed by the caching routines, BFD retains
4499      state information on the file here...  */
4500   ufile_ptr where;
4501
4502   /* ... and here: (``once'' means at least once).  */
4503   bfd_boolean opened_once;
4504
4505   /* Set if we have a locally maintained mtime value, rather than
4506      getting it from the file each time.  */
4507   bfd_boolean mtime_set;
4508
4509   /* File modified time, if mtime_set is TRUE.  */
4510   long mtime;
4511
4512   /* Reserved for an unimplemented file locking extension.  */
4513   int ifd;
4514
4515   /* The format which belongs to the BFD. (object, core, etc.)  */
4516   bfd_format format;
4517
4518   /* The direction with which the BFD was opened.  */
4519   enum bfd_direction
4520     {
4521       no_direction = 0,
4522       read_direction = 1,
4523       write_direction = 2,
4524       both_direction = 3
4525     }
4526   direction;
4527
4528   /* Format_specific flags.  */
4529   flagword flags;
4530
4531   /* Currently my_archive is tested before adding origin to
4532      anything. I believe that this can become always an add of
4533      origin, with origin set to 0 for non archive files.  */
4534   ufile_ptr origin;
4535
4536   /* Remember when output has begun, to stop strange things
4537      from happening.  */
4538   bfd_boolean output_has_begun;
4539
4540   /* A hash table for section names.  */
4541   struct bfd_hash_table section_htab;
4542
4543   /* Pointer to linked list of sections.  */
4544   struct bfd_section *sections;
4545
4546   /* The last section on the section list.  */
4547   struct bfd_section *section_last;
4548
4549   /* The number of sections.  */
4550   unsigned int section_count;
4551
4552   /* Stuff only useful for object files:
4553      The start address.  */
4554   bfd_vma start_address;
4555
4556   /* Used for input and output.  */
4557   unsigned int symcount;
4558
4559   /* Symbol table for output BFD (with symcount entries).  */
4560   struct bfd_symbol  **outsymbols;
4561
4562   /* Used for slurped dynamic symbol tables.  */
4563   unsigned int dynsymcount;
4564
4565   /* Pointer to structure which contains architecture information.  */
4566   const struct bfd_arch_info *arch_info;
4567
4568   /* Flag set if symbols from this BFD should not be exported.  */
4569   bfd_boolean no_export;
4570
4571   /* Stuff only useful for archives.  */
4572   void *arelt_data;
4573   struct bfd *my_archive;      /* The containing archive BFD.  */
4574   struct bfd *next;            /* The next BFD in the archive.  */
4575   struct bfd *archive_head;    /* The first BFD in the archive.  */
4576   bfd_boolean has_armap;
4577
4578   /* A chain of BFD structures involved in a link.  */
4579   struct bfd *link_next;
4580
4581   /* A field used by _bfd_generic_link_add_archive_symbols.  This will
4582      be used only for archive elements.  */
4583   int archive_pass;
4584
4585   /* Used by the back end to hold private data.  */
4586   union
4587     {
4588       struct aout_data_struct *aout_data;
4589       struct artdata *aout_ar_data;
4590       struct _oasys_data *oasys_obj_data;
4591       struct _oasys_ar_data *oasys_ar_data;
4592       struct coff_tdata *coff_obj_data;
4593       struct pe_tdata *pe_obj_data;
4594       struct xcoff_tdata *xcoff_obj_data;
4595       struct ecoff_tdata *ecoff_obj_data;
4596       struct ieee_data_struct *ieee_data;
4597       struct ieee_ar_data_struct *ieee_ar_data;
4598       struct srec_data_struct *srec_data;
4599       struct ihex_data_struct *ihex_data;
4600       struct tekhex_data_struct *tekhex_data;
4601       struct elf_obj_tdata *elf_obj_data;
4602       struct nlm_obj_tdata *nlm_obj_data;
4603       struct bout_data_struct *bout_data;
4604       struct mmo_data_struct *mmo_data;
4605       struct sun_core_struct *sun_core_data;
4606       struct sco5_core_struct *sco5_core_data;
4607       struct trad_core_struct *trad_core_data;
4608       struct som_data_struct *som_data;
4609       struct hpux_core_struct *hpux_core_data;
4610       struct hppabsd_core_struct *hppabsd_core_data;
4611       struct sgi_core_struct *sgi_core_data;
4612       struct lynx_core_struct *lynx_core_data;
4613       struct osf_core_struct *osf_core_data;
4614       struct cisco_core_struct *cisco_core_data;
4615       struct versados_data_struct *versados_data;
4616       struct netbsd_core_struct *netbsd_core_data;
4617       struct mach_o_data_struct *mach_o_data;
4618       struct mach_o_fat_data_struct *mach_o_fat_data;
4619       struct bfd_pef_data_struct *pef_data;
4620       struct bfd_pef_xlib_data_struct *pef_xlib_data;
4621       struct bfd_sym_data_struct *sym_data;
4622       void *any;
4623     }
4624   tdata;
4625
4626   /* Used by the application to hold private data.  */
4627   void *usrdata;
4628
4629   /* Where all the allocated stuff under this BFD goes.  This is a
4630      struct objalloc *, but we use void * to avoid requiring the inclusion
4631      of objalloc.h.  */
4632   void *memory;
4633 };
4634
4635 typedef enum bfd_error
4636 {
4637   bfd_error_no_error = 0,
4638   bfd_error_system_call,
4639   bfd_error_invalid_target,
4640   bfd_error_wrong_format,
4641   bfd_error_wrong_object_format,
4642   bfd_error_invalid_operation,
4643   bfd_error_no_memory,
4644   bfd_error_no_symbols,
4645   bfd_error_no_armap,
4646   bfd_error_no_more_archived_files,
4647   bfd_error_malformed_archive,
4648   bfd_error_file_not_recognized,
4649   bfd_error_file_ambiguously_recognized,
4650   bfd_error_no_contents,
4651   bfd_error_nonrepresentable_section,
4652   bfd_error_no_debug_section,
4653   bfd_error_bad_value,
4654   bfd_error_file_truncated,
4655   bfd_error_file_too_big,
4656   bfd_error_on_input,
4657   bfd_error_invalid_error_code
4658 }
4659 bfd_error_type;
4660
4661 bfd_error_type bfd_get_error (void);
4662
4663 void bfd_set_error (bfd_error_type error_tag, ...);
4664
4665 const char *bfd_errmsg (bfd_error_type error_tag);
4666
4667 void bfd_perror (const char *message);
4668
4669 typedef void (*bfd_error_handler_type) (const char *, ...);
4670
4671 bfd_error_handler_type bfd_set_error_handler (bfd_error_handler_type);
4672
4673 void bfd_set_error_program_name (const char *);
4674
4675 bfd_error_handler_type bfd_get_error_handler (void);
4676
4677 long bfd_get_reloc_upper_bound (bfd *abfd, asection *sect);
4678
4679 long bfd_canonicalize_reloc
4680    (bfd *abfd, asection *sec, arelent **loc, asymbol **syms);
4681
4682 void bfd_set_reloc
4683    (bfd *abfd, asection *sec, arelent **rel, unsigned int count);
4684
4685 bfd_boolean bfd_set_file_flags (bfd *abfd, flagword flags);
4686
4687 int bfd_get_arch_size (bfd *abfd);
4688
4689 int bfd_get_sign_extend_vma (bfd *abfd);
4690
4691 bfd_boolean bfd_set_start_address (bfd *abfd, bfd_vma vma);
4692
4693 unsigned int bfd_get_gp_size (bfd *abfd);
4694
4695 void bfd_set_gp_size (bfd *abfd, unsigned int i);
4696
4697 bfd_vma bfd_scan_vma (const char *string, const char **end, int base);
4698
4699 bfd_boolean bfd_copy_private_header_data (bfd *ibfd, bfd *obfd);
4700
4701 #define bfd_copy_private_header_data(ibfd, obfd) \
4702      BFD_SEND (obfd, _bfd_copy_private_header_data, \
4703                (ibfd, obfd))
4704 bfd_boolean bfd_copy_private_bfd_data (bfd *ibfd, bfd *obfd);
4705
4706 #define bfd_copy_private_bfd_data(ibfd, obfd) \
4707      BFD_SEND (obfd, _bfd_copy_private_bfd_data, \
4708                (ibfd, obfd))
4709 bfd_boolean bfd_merge_private_bfd_data (bfd *ibfd, bfd *obfd);
4710
4711 #define bfd_merge_private_bfd_data(ibfd, obfd) \
4712      BFD_SEND (obfd, _bfd_merge_private_bfd_data, \
4713                (ibfd, obfd))
4714 bfd_boolean bfd_set_private_flags (bfd *abfd, flagword flags);
4715
4716 #define bfd_set_private_flags(abfd, flags) \
4717      BFD_SEND (abfd, _bfd_set_private_flags, (abfd, flags))
4718 #define bfd_sizeof_headers(abfd, info) \
4719        BFD_SEND (abfd, _bfd_sizeof_headers, (abfd, info))
4720
4721 #define bfd_find_nearest_line(abfd, sec, syms, off, file, func, line) \
4722        BFD_SEND (abfd, _bfd_find_nearest_line, \
4723                  (abfd, sec, syms, off, file, func, line))
4724
4725 #define bfd_find_line(abfd, syms, sym, file, line) \
4726        BFD_SEND (abfd, _bfd_find_line, \
4727                  (abfd, syms, sym, file, line))
4728
4729 #define bfd_find_inliner_info(abfd, file, func, line) \
4730        BFD_SEND (abfd, _bfd_find_inliner_info, \
4731                  (abfd, file, func, line))
4732
4733 #define bfd_debug_info_start(abfd) \
4734        BFD_SEND (abfd, _bfd_debug_info_start, (abfd))
4735
4736 #define bfd_debug_info_end(abfd) \
4737        BFD_SEND (abfd, _bfd_debug_info_end, (abfd))
4738
4739 #define bfd_debug_info_accumulate(abfd, section) \
4740        BFD_SEND (abfd, _bfd_debug_info_accumulate, (abfd, section))
4741
4742 #define bfd_stat_arch_elt(abfd, stat) \
4743        BFD_SEND (abfd, _bfd_stat_arch_elt,(abfd, stat))
4744
4745 #define bfd_update_armap_timestamp(abfd) \
4746        BFD_SEND (abfd, _bfd_update_armap_timestamp, (abfd))
4747
4748 #define bfd_set_arch_mach(abfd, arch, mach)\
4749        BFD_SEND ( abfd, _bfd_set_arch_mach, (abfd, arch, mach))
4750
4751 #define bfd_relax_section(abfd, section, link_info, again) \
4752        BFD_SEND (abfd, _bfd_relax_section, (abfd, section, link_info, again))
4753
4754 #define bfd_gc_sections(abfd, link_info) \
4755        BFD_SEND (abfd, _bfd_gc_sections, (abfd, link_info))
4756
4757 #define bfd_merge_sections(abfd, link_info) \
4758        BFD_SEND (abfd, _bfd_merge_sections, (abfd, link_info))
4759
4760 #define bfd_is_group_section(abfd, sec) \
4761        BFD_SEND (abfd, _bfd_is_group_section, (abfd, sec))
4762
4763 #define bfd_discard_group(abfd, sec) \
4764        BFD_SEND (abfd, _bfd_discard_group, (abfd, sec))
4765
4766 #define bfd_link_hash_table_create(abfd) \
4767        BFD_SEND (abfd, _bfd_link_hash_table_create, (abfd))
4768
4769 #define bfd_link_hash_table_free(abfd, hash) \
4770        BFD_SEND (abfd, _bfd_link_hash_table_free, (hash))
4771
4772 #define bfd_link_add_symbols(abfd, info) \
4773        BFD_SEND (abfd, _bfd_link_add_symbols, (abfd, info))
4774
4775 #define bfd_link_just_syms(abfd, sec, info) \
4776        BFD_SEND (abfd, _bfd_link_just_syms, (sec, info))
4777
4778 #define bfd_final_link(abfd, info) \
4779        BFD_SEND (abfd, _bfd_final_link, (abfd, info))
4780
4781 #define bfd_free_cached_info(abfd) \
4782        BFD_SEND (abfd, _bfd_free_cached_info, (abfd))
4783
4784 #define bfd_get_dynamic_symtab_upper_bound(abfd) \
4785        BFD_SEND (abfd, _bfd_get_dynamic_symtab_upper_bound, (abfd))
4786
4787 #define bfd_print_private_bfd_data(abfd, file)\
4788        BFD_SEND (abfd, _bfd_print_private_bfd_data, (abfd, file))
4789
4790 #define bfd_canonicalize_dynamic_symtab(abfd, asymbols) \
4791        BFD_SEND (abfd, _bfd_canonicalize_dynamic_symtab, (abfd, asymbols))
4792
4793 #define bfd_get_synthetic_symtab(abfd, count, syms, dyncount, dynsyms, ret) \
4794        BFD_SEND (abfd, _bfd_get_synthetic_symtab, (abfd, count, syms, \
4795                                                    dyncount, dynsyms, ret))
4796
4797 #define bfd_get_dynamic_reloc_upper_bound(abfd) \
4798        BFD_SEND (abfd, _bfd_get_dynamic_reloc_upper_bound, (abfd))
4799
4800 #define bfd_canonicalize_dynamic_reloc(abfd, arels, asyms) \
4801        BFD_SEND (abfd, _bfd_canonicalize_dynamic_reloc, (abfd, arels, asyms))
4802
4803 extern bfd_byte *bfd_get_relocated_section_contents
4804   (bfd *, struct bfd_link_info *, struct bfd_link_order *, bfd_byte *,
4805    bfd_boolean, asymbol **);
4806
4807 bfd_boolean bfd_alt_mach_code (bfd *abfd, int alternative);
4808
4809 struct bfd_preserve
4810 {
4811   void *marker;
4812   void *tdata;
4813   flagword flags;
4814   const struct bfd_arch_info *arch_info;
4815   struct bfd_section *sections;
4816   struct bfd_section *section_last;
4817   unsigned int section_count;
4818   struct bfd_hash_table section_htab;
4819 };
4820
4821 bfd_boolean bfd_preserve_save (bfd *, struct bfd_preserve *);
4822
4823 void bfd_preserve_restore (bfd *, struct bfd_preserve *);
4824
4825 void bfd_preserve_finish (bfd *, struct bfd_preserve *);
4826
4827 bfd_vma bfd_emul_get_maxpagesize (const char *);
4828
4829 void bfd_emul_set_maxpagesize (const char *, bfd_vma);
4830
4831 bfd_vma bfd_emul_get_commonpagesize (const char *);
4832
4833 void bfd_emul_set_commonpagesize (const char *, bfd_vma);
4834
4835 /* Extracted from archive.c.  */
4836 symindex bfd_get_next_mapent
4837    (bfd *abfd, symindex previous, carsym **sym);
4838
4839 bfd_boolean bfd_set_archive_head (bfd *output, bfd *new_head);
4840
4841 bfd *bfd_openr_next_archived_file (bfd *archive, bfd *previous);
4842
4843 /* Extracted from corefile.c.  */
4844 const char *bfd_core_file_failing_command (bfd *abfd);
4845
4846 int bfd_core_file_failing_signal (bfd *abfd);
4847
4848 bfd_boolean core_file_matches_executable_p
4849    (bfd *core_bfd, bfd *exec_bfd);
4850
4851 bfd_boolean generic_core_file_matches_executable_p
4852    (bfd *core_bfd, bfd *exec_bfd);
4853
4854 /* Extracted from targets.c.  */
4855 #define BFD_SEND(bfd, message, arglist) \
4856   ((*((bfd)->xvec->message)) arglist)
4857
4858 #ifdef DEBUG_BFD_SEND
4859 #undef BFD_SEND
4860 #define BFD_SEND(bfd, message, arglist) \
4861   (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
4862     ((*((bfd)->xvec->message)) arglist) : \
4863     (bfd_assert (__FILE__,__LINE__), NULL))
4864 #endif
4865 #define BFD_SEND_FMT(bfd, message, arglist) \
4866   (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist)
4867
4868 #ifdef DEBUG_BFD_SEND
4869 #undef BFD_SEND_FMT
4870 #define BFD_SEND_FMT(bfd, message, arglist) \
4871   (((bfd) && (bfd)->xvec && (bfd)->xvec->message) ? \
4872    (((bfd)->xvec->message[(int) ((bfd)->format)]) arglist) : \
4873    (bfd_assert (__FILE__,__LINE__), NULL))
4874 #endif
4875
4876 enum bfd_flavour
4877 {
4878   bfd_target_unknown_flavour,
4879   bfd_target_aout_flavour,
4880   bfd_target_coff_flavour,
4881   bfd_target_ecoff_flavour,
4882   bfd_target_xcoff_flavour,
4883   bfd_target_elf_flavour,
4884   bfd_target_ieee_flavour,
4885   bfd_target_nlm_flavour,
4886   bfd_target_oasys_flavour,
4887   bfd_target_tekhex_flavour,
4888   bfd_target_srec_flavour,
4889   bfd_target_ihex_flavour,
4890   bfd_target_som_flavour,
4891   bfd_target_os9k_flavour,
4892   bfd_target_versados_flavour,
4893   bfd_target_msdos_flavour,
4894   bfd_target_ovax_flavour,
4895   bfd_target_evax_flavour,
4896   bfd_target_mmo_flavour,
4897   bfd_target_mach_o_flavour,
4898   bfd_target_pef_flavour,
4899   bfd_target_pef_xlib_flavour,
4900   bfd_target_sym_flavour
4901 };
4902
4903 enum bfd_endian { BFD_ENDIAN_BIG, BFD_ENDIAN_LITTLE, BFD_ENDIAN_UNKNOWN };
4904
4905 /* Forward declaration.  */
4906 typedef struct bfd_link_info _bfd_link_info;
4907
4908 typedef struct bfd_target
4909 {
4910   /* Identifies the kind of target, e.g., SunOS4, Ultrix, etc.  */
4911   char *name;
4912
4913  /* The "flavour" of a back end is a general indication about
4914     the contents of a file.  */
4915   enum bfd_flavour flavour;
4916
4917   /* The order of bytes within the data area of a file.  */
4918   enum bfd_endian byteorder;
4919
4920  /* The order of bytes within the header parts of a file.  */
4921   enum bfd_endian header_byteorder;
4922
4923   /* A mask of all the flags which an executable may have set -
4924      from the set <<BFD_NO_FLAGS>>, <<HAS_RELOC>>, ...<<D_PAGED>>.  */
4925   flagword object_flags;
4926
4927  /* A mask of all the flags which a section may have set - from
4928     the set <<SEC_NO_FLAGS>>, <<SEC_ALLOC>>, ...<<SET_NEVER_LOAD>>.  */
4929   flagword section_flags;
4930
4931  /* The character normally found at the front of a symbol.
4932     (if any), perhaps `_'.  */
4933   char symbol_leading_char;
4934
4935  /* The pad character for file names within an archive header.  */
4936   char ar_pad_char;
4937
4938   /* The maximum number of characters in an archive header.  */
4939   unsigned short ar_max_namelen;
4940
4941   /* Entries for byte swapping for data. These are different from the
4942      other entry points, since they don't take a BFD as the first argument.
4943      Certain other handlers could do the same.  */
4944   bfd_uint64_t   (*bfd_getx64) (const void *);
4945   bfd_int64_t    (*bfd_getx_signed_64) (const void *);
4946   void           (*bfd_putx64) (bfd_uint64_t, void *);
4947   bfd_vma        (*bfd_getx32) (const void *);
4948   bfd_signed_vma (*bfd_getx_signed_32) (const void *);
4949   void           (*bfd_putx32) (bfd_vma, void *);
4950   bfd_vma        (*bfd_getx16) (const void *);
4951   bfd_signed_vma (*bfd_getx_signed_16) (const void *);
4952   void           (*bfd_putx16) (bfd_vma, void *);
4953
4954   /* Byte swapping for the headers.  */
4955   bfd_uint64_t   (*bfd_h_getx64) (const void *);
4956   bfd_int64_t    (*bfd_h_getx_signed_64) (const void *);
4957   void           (*bfd_h_putx64) (bfd_uint64_t, void *);
4958   bfd_vma        (*bfd_h_getx32) (const void *);
4959   bfd_signed_vma (*bfd_h_getx_signed_32) (const void *);
4960   void           (*bfd_h_putx32) (bfd_vma, void *);
4961   bfd_vma        (*bfd_h_getx16) (const void *);
4962   bfd_signed_vma (*bfd_h_getx_signed_16) (const void *);
4963   void           (*bfd_h_putx16) (bfd_vma, void *);
4964
4965   /* Format dependent routines: these are vectors of entry points
4966      within the target vector structure, one for each format to check.  */
4967
4968   /* Check the format of a file being read.  Return a <<bfd_target *>> or zero.  */
4969   const struct bfd_target *(*_bfd_check_format[bfd_type_end]) (bfd *);
4970
4971   /* Set the format of a file being written.  */
4972   bfd_boolean (*_bfd_set_format[bfd_type_end]) (bfd *);
4973
4974   /* Write cached information into a file being written, at <<bfd_close>>.  */
4975   bfd_boolean (*_bfd_write_contents[bfd_type_end]) (bfd *);
4976
4977
4978   /* Generic entry points.  */
4979 #define BFD_JUMP_TABLE_GENERIC(NAME) \
4980   NAME##_close_and_cleanup, \
4981   NAME##_bfd_free_cached_info, \
4982   NAME##_new_section_hook, \
4983   NAME##_get_section_contents, \
4984   NAME##_get_section_contents_in_window
4985
4986   /* Called when the BFD is being closed to do any necessary cleanup.  */
4987   bfd_boolean (*_close_and_cleanup) (bfd *);
4988   /* Ask the BFD to free all cached information.  */
4989   bfd_boolean (*_bfd_free_cached_info) (bfd *);
4990   /* Called when a new section is created.  */
4991   bfd_boolean (*_new_section_hook) (bfd *, sec_ptr);
4992   /* Read the contents of a section.  */
4993   bfd_boolean (*_bfd_get_section_contents)
4994     (bfd *, sec_ptr, void *, file_ptr, bfd_size_type);
4995   bfd_boolean (*_bfd_get_section_contents_in_window)
4996     (bfd *, sec_ptr, bfd_window *, file_ptr, bfd_size_type);
4997
4998   /* Entry points to copy private data.  */
4999 #define BFD_JUMP_TABLE_COPY(NAME) \
5000   NAME##_bfd_copy_private_bfd_data, \
5001   NAME##_bfd_merge_private_bfd_data, \
5002   _bfd_generic_init_private_section_data, \
5003   NAME##_bfd_copy_private_section_data, \
5004   NAME##_bfd_copy_private_symbol_data, \
5005   NAME##_bfd_copy_private_header_data, \
5006   NAME##_bfd_set_private_flags, \
5007   NAME##_bfd_print_private_bfd_data
5008
5009   /* Called to copy BFD general private data from one object file
5010      to another.  */
5011   bfd_boolean (*_bfd_copy_private_bfd_data) (bfd *, bfd *);
5012   /* Called to merge BFD general private data from one object file
5013      to a common output file when linking.  */
5014   bfd_boolean (*_bfd_merge_private_bfd_data) (bfd *, bfd *);
5015   /* Called to initialize BFD private section data from one object file
5016      to another.  */
5017 #define bfd_init_private_section_data(ibfd, isec, obfd, osec, link_info) \
5018   BFD_SEND (obfd, _bfd_init_private_section_data, (ibfd, isec, obfd, osec, link_info))
5019   bfd_boolean (*_bfd_init_private_section_data)
5020     (bfd *, sec_ptr, bfd *, sec_ptr, struct bfd_link_info *);
5021   /* Called to copy BFD private section data from one object file
5022      to another.  */
5023   bfd_boolean (*_bfd_copy_private_section_data)
5024     (bfd *, sec_ptr, bfd *, sec_ptr);
5025   /* Called to copy BFD private symbol data from one symbol
5026      to another.  */
5027   bfd_boolean (*_bfd_copy_private_symbol_data)
5028     (bfd *, asymbol *, bfd *, asymbol *);
5029   /* Called to copy BFD private header data from one object file
5030      to another.  */
5031   bfd_boolean (*_bfd_copy_private_header_data)
5032     (bfd *, bfd *);
5033   /* Called to set private backend flags.  */
5034   bfd_boolean (*_bfd_set_private_flags) (bfd *, flagword);
5035
5036   /* Called to print private BFD data.  */
5037   bfd_boolean (*_bfd_print_private_bfd_data) (bfd *, void *);
5038
5039   /* Core file entry points.  */
5040 #define BFD_JUMP_TABLE_CORE(NAME) \
5041   NAME##_core_file_failing_command, \
5042   NAME##_core_file_failing_signal, \
5043   NAME##_core_file_matches_executable_p
5044
5045   char *      (*_core_file_failing_command) (bfd *);
5046   int         (*_core_file_failing_signal) (bfd *);
5047   bfd_boolean (*_core_file_matches_executable_p) (bfd *, bfd *);
5048
5049   /* Archive entry points.  */
5050 #define BFD_JUMP_TABLE_ARCHIVE(NAME) \
5051   NAME##_slurp_armap, \
5052   NAME##_slurp_extended_name_table, \
5053   NAME##_construct_extended_name_table, \
5054   NAME##_truncate_arname, \
5055   NAME##_write_armap, \
5056   NAME##_read_ar_hdr, \
5057   NAME##_openr_next_archived_file, \
5058   NAME##_get_elt_at_index, \
5059   NAME##_generic_stat_arch_elt, \
5060   NAME##_update_armap_timestamp
5061
5062   bfd_boolean (*_bfd_slurp_armap) (bfd *);
5063   bfd_boolean (*_bfd_slurp_extended_name_table) (bfd *);
5064   bfd_boolean (*_bfd_construct_extended_name_table)
5065     (bfd *, char **, bfd_size_type *, const char **);
5066   void        (*_bfd_truncate_arname) (bfd *, const char *, char *);
5067   bfd_boolean (*write_armap)
5068     (bfd *, unsigned int, struct orl *, unsigned int, int);
5069   void *      (*_bfd_read_ar_hdr_fn) (bfd *);
5070   bfd *       (*openr_next_archived_file) (bfd *, bfd *);
5071 #define bfd_get_elt_at_index(b,i) BFD_SEND (b, _bfd_get_elt_at_index, (b,i))
5072   bfd *       (*_bfd_get_elt_at_index) (bfd *, symindex);
5073   int         (*_bfd_stat_arch_elt) (bfd *, struct stat *);
5074   bfd_boolean (*_bfd_update_armap_timestamp) (bfd *);
5075
5076   /* Entry points used for symbols.  */
5077 #define BFD_JUMP_TABLE_SYMBOLS(NAME) \
5078   NAME##_get_symtab_upper_bound, \
5079   NAME##_canonicalize_symtab, \
5080   NAME##_make_empty_symbol, \
5081   NAME##_print_symbol, \
5082   NAME##_get_symbol_info, \
5083   NAME##_bfd_is_local_label_name, \
5084   NAME##_bfd_is_target_special_symbol, \
5085   NAME##_get_lineno, \
5086   NAME##_find_nearest_line, \
5087   _bfd_generic_find_line, \
5088   NAME##_find_inliner_info, \
5089   NAME##_bfd_make_debug_symbol, \
5090   NAME##_read_minisymbols, \
5091   NAME##_minisymbol_to_symbol
5092
5093   long        (*_bfd_get_symtab_upper_bound) (bfd *);
5094   long        (*_bfd_canonicalize_symtab)
5095     (bfd *, struct bfd_symbol **);
5096   struct bfd_symbol *
5097               (*_bfd_make_empty_symbol) (bfd *);
5098   void        (*_bfd_print_symbol)
5099     (bfd *, void *, struct bfd_symbol *, bfd_print_symbol_type);
5100 #define bfd_print_symbol(b,p,s,e) BFD_SEND (b, _bfd_print_symbol, (b,p,s,e))
5101   void        (*_bfd_get_symbol_info)
5102     (bfd *, struct bfd_symbol *, symbol_info *);
5103 #define bfd_get_symbol_info(b,p,e) BFD_SEND (b, _bfd_get_symbol_info, (b,p,e))
5104   bfd_boolean (*_bfd_is_local_label_name) (bfd *, const char *);
5105   bfd_boolean (*_bfd_is_target_special_symbol) (bfd *, asymbol *);
5106   alent *     (*_get_lineno) (bfd *, struct bfd_symbol *);
5107   bfd_boolean (*_bfd_find_nearest_line)
5108     (bfd *, struct bfd_section *, struct bfd_symbol **, bfd_vma,
5109      const char **, const char **, unsigned int *);
5110   bfd_boolean (*_bfd_find_line)
5111     (bfd *, struct bfd_symbol **, struct bfd_symbol *,
5112      const char **, unsigned int *);
5113   bfd_boolean (*_bfd_find_inliner_info)
5114     (bfd *, const char **, const char **, unsigned int *);
5115  /* Back-door to allow format-aware applications to create debug symbols
5116     while using BFD for everything else.  Currently used by the assembler
5117     when creating COFF files.  */
5118   asymbol *   (*_bfd_make_debug_symbol)
5119     (bfd *, void *, unsigned long size);
5120 #define bfd_read_minisymbols(b, d, m, s) \
5121   BFD_SEND (b, _read_minisymbols, (b, d, m, s))
5122   long        (*_read_minisymbols)
5123     (bfd *, bfd_boolean, void **, unsigned int *);
5124 #define bfd_minisymbol_to_symbol(b, d, m, f) \
5125   BFD_SEND (b, _minisymbol_to_symbol, (b, d, m, f))
5126   asymbol *   (*_minisymbol_to_symbol)
5127     (bfd *, bfd_boolean, const void *, asymbol *);
5128
5129   /* Routines for relocs.  */
5130 #define BFD_JUMP_TABLE_RELOCS(NAME) \
5131   NAME##_get_reloc_upper_bound, \
5132   NAME##_canonicalize_reloc, \
5133   NAME##_bfd_reloc_type_lookup
5134
5135   long        (*_get_reloc_upper_bound) (bfd *, sec_ptr);
5136   long        (*_bfd_canonicalize_reloc)
5137     (bfd *, sec_ptr, arelent **, struct bfd_symbol **);
5138   /* See documentation on reloc types.  */
5139   reloc_howto_type *
5140               (*reloc_type_lookup) (bfd *, bfd_reloc_code_real_type);
5141
5142   /* Routines used when writing an object file.  */
5143 #define BFD_JUMP_TABLE_WRITE(NAME) \
5144   NAME##_set_arch_mach, \
5145   NAME##_set_section_contents
5146
5147   bfd_boolean (*_bfd_set_arch_mach)
5148     (bfd *, enum bfd_architecture, unsigned long);
5149   bfd_boolean (*_bfd_set_section_contents)
5150     (bfd *, sec_ptr, const void *, file_ptr, bfd_size_type);
5151
5152   /* Routines used by the linker.  */
5153 #define BFD_JUMP_TABLE_LINK(NAME) \
5154   NAME##_sizeof_headers, \
5155   NAME##_bfd_get_relocated_section_contents, \
5156   NAME##_bfd_relax_section, \
5157   NAME##_bfd_link_hash_table_create, \
5158   NAME##_bfd_link_hash_table_free, \
5159   NAME##_bfd_link_add_symbols, \
5160   NAME##_bfd_link_just_syms, \
5161   NAME##_bfd_final_link, \
5162   NAME##_bfd_link_split_section, \
5163   NAME##_bfd_gc_sections, \
5164   NAME##_bfd_merge_sections, \
5165   NAME##_bfd_is_group_section, \
5166   NAME##_bfd_discard_group, \
5167   NAME##_section_already_linked \
5168
5169   int         (*_bfd_sizeof_headers) (bfd *, struct bfd_link_info *);
5170   bfd_byte *  (*_bfd_get_relocated_section_contents)
5171     (bfd *, struct bfd_link_info *, struct bfd_link_order *,
5172      bfd_byte *, bfd_boolean, struct bfd_symbol **);
5173
5174   bfd_boolean (*_bfd_relax_section)
5175     (bfd *, struct bfd_section *, struct bfd_link_info *, bfd_boolean *);
5176
5177   /* Create a hash table for the linker.  Different backends store
5178      different information in this table.  */
5179   struct bfd_link_hash_table *
5180               (*_bfd_link_hash_table_create) (bfd *);
5181
5182   /* Release the memory associated with the linker hash table.  */
5183   void        (*_bfd_link_hash_table_free) (struct bfd_link_hash_table *);
5184
5185   /* Add symbols from this object file into the hash table.  */
5186   bfd_boolean (*_bfd_link_add_symbols) (bfd *, struct bfd_link_info *);
5187
5188   /* Indicate that we are only retrieving symbol values from this section.  */
5189   void        (*_bfd_link_just_syms) (asection *, struct bfd_link_info *);
5190
5191   /* Do a link based on the link_order structures attached to each
5192      section of the BFD.  */
5193   bfd_boolean (*_bfd_final_link) (bfd *, struct bfd_link_info *);
5194
5195   /* Should this section be split up into smaller pieces during linking.  */
5196   bfd_boolean (*_bfd_link_split_section) (bfd *, struct bfd_section *);
5197
5198   /* Remove sections that are not referenced from the output.  */
5199   bfd_boolean (*_bfd_gc_sections) (bfd *, struct bfd_link_info *);
5200
5201   /* Attempt to merge SEC_MERGE sections.  */
5202   bfd_boolean (*_bfd_merge_sections) (bfd *, struct bfd_link_info *);
5203
5204   /* Is this section a member of a group?  */
5205   bfd_boolean (*_bfd_is_group_section) (bfd *, const struct bfd_section *);
5206
5207   /* Discard members of a group.  */
5208   bfd_boolean (*_bfd_discard_group) (bfd *, struct bfd_section *);
5209
5210   /* Check if SEC has been already linked during a reloceatable or
5211      final link.  */
5212   void (*_section_already_linked) (bfd *, struct bfd_section *,
5213                                    struct bfd_link_info *);
5214
5215   /* Routines to handle dynamic symbols and relocs.  */
5216 #define BFD_JUMP_TABLE_DYNAMIC(NAME) \
5217   NAME##_get_dynamic_symtab_upper_bound, \
5218   NAME##_canonicalize_dynamic_symtab, \
5219   NAME##_get_synthetic_symtab, \
5220   NAME##_get_dynamic_reloc_upper_bound, \
5221   NAME##_canonicalize_dynamic_reloc
5222
5223   /* Get the amount of memory required to hold the dynamic symbols.  */
5224   long        (*_bfd_get_dynamic_symtab_upper_bound) (bfd *);
5225   /* Read in the dynamic symbols.  */
5226   long        (*_bfd_canonicalize_dynamic_symtab)
5227     (bfd *, struct bfd_symbol **);
5228   /* Create synthetized symbols.  */
5229   long        (*_bfd_get_synthetic_symtab)
5230     (bfd *, long, struct bfd_symbol **, long, struct bfd_symbol **,
5231      struct bfd_symbol **);
5232   /* Get the amount of memory required to hold the dynamic relocs.  */
5233   long        (*_bfd_get_dynamic_reloc_upper_bound) (bfd *);
5234   /* Read in the dynamic relocs.  */
5235   long        (*_bfd_canonicalize_dynamic_reloc)
5236     (bfd *, arelent **, struct bfd_symbol **);
5237
5238   /* Opposite endian version of this target.  */
5239   const struct bfd_target * alternative_target;
5240
5241   /* Data for use by back-end routines, which isn't
5242      generic enough to belong in this structure.  */
5243   const void *backend_data;
5244
5245 } bfd_target;
5246
5247 bfd_boolean bfd_set_default_target (const char *name);
5248
5249 const bfd_target *bfd_find_target (const char *target_name, bfd *abfd);
5250
5251 const char ** bfd_target_list (void);
5252
5253 const bfd_target *bfd_search_for_target
5254    (int (*search_func) (const bfd_target *, void *),
5255     void *);
5256
5257 /* Extracted from format.c.  */
5258 bfd_boolean bfd_check_format (bfd *abfd, bfd_format format);
5259
5260 bfd_boolean bfd_check_format_matches
5261    (bfd *abfd, bfd_format format, char ***matching);
5262
5263 bfd_boolean bfd_set_format (bfd *abfd, bfd_format format);
5264
5265 const char *bfd_format_string (bfd_format format);
5266
5267 /* Extracted from linker.c.  */
5268 bfd_boolean bfd_link_split_section (bfd *abfd, asection *sec);
5269
5270 #define bfd_link_split_section(abfd, sec) \
5271        BFD_SEND (abfd, _bfd_link_split_section, (abfd, sec))
5272
5273 void bfd_section_already_linked (bfd *abfd, asection *sec,
5274     struct bfd_link_info *info);
5275
5276 #define bfd_section_already_linked(abfd, sec, info) \
5277        BFD_SEND (abfd, _section_already_linked, (abfd, sec, info))
5278
5279 /* Extracted from simple.c.  */
5280 bfd_byte *bfd_simple_get_relocated_section_contents
5281    (bfd *abfd, asection *sec, bfd_byte *outbuf, asymbol **symbol_table);
5282
5283 #ifdef __cplusplus
5284 }
5285 #endif
5286 #endif