OSDN Git Service

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