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