bfd-in.h revision 33965
1/* Main header file for the bfd library -- portable access to object files.
2   Copyright 1990, 91, 92, 93, 94, 95, 96, 1997 Free Software Foundation, Inc.
3   Contributed by Cygnus Support.
4
5** NOTE: bfd.h and bfd-in2.h are GENERATED files.  Don't change them;
6** instead, change bfd-in.h or the other BFD source files processed to
7** generate these files.
8
9This file is part of BFD, the Binary File Descriptor library.
10
11This program is free software; you can redistribute it and/or modify
12it under the terms of the GNU General Public License as published by
13the Free Software Foundation; either version 2 of the License, or
14(at your option) any later version.
15
16This program is distributed in the hope that it will be useful,
17but WITHOUT ANY WARRANTY; without even the implied warranty of
18MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19GNU General Public License for more details.
20
21You should have received a copy of the GNU General Public License
22along with this program; if not, write to the Free Software
23Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
24
25/* bfd.h -- The only header file required by users of the bfd library
26
27The bfd.h file is generated from bfd-in.h and various .c files; if you
28change it, your changes will probably be lost.
29
30All the prototypes and definitions following the comment "THE FOLLOWING
31IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
32BFD.  If you change it, someone oneday will extract it from the source
33again, and your changes will be lost.  To save yourself from this bind,
34change the definitions in the source in the bfd directory.  Type "make
35docs" and then "make headers" in that directory, and magically this file
36will change to reflect your changes.
37
38If you don't have the tools to perform the extraction, then you are
39safe from someone on your system trampling over your header files.
40You should still maintain the equivalence between the source and this
41file though; every change you make to the .c file should be reflected
42here.  */
43
44#ifndef __BFD_H_SEEN__
45#define __BFD_H_SEEN__
46
47#ifdef __cplusplus
48extern "C" {
49#endif
50
51#include "ansidecl.h"
52
53/* These two lines get substitutions done by commands in Makefile.in.  */
54#define BFD_VERSION  "@VERSION@"
55#define BFD_ARCH_SIZE @wordsize@
56#define BFD_HOST_64BIT_LONG @BFD_HOST_64BIT_LONG@
57#if @BFD_HOST_64_BIT_DEFINED@
58#define BFD_HOST_64_BIT @BFD_HOST_64_BIT@
59#define BFD_HOST_U_64_BIT @BFD_HOST_U_64_BIT@
60#endif
61
62#if BFD_ARCH_SIZE >= 64
63#define BFD64
64#endif
65
66#ifndef INLINE
67#if __GNUC__ >= 2
68#define INLINE __inline__
69#else
70#define INLINE
71#endif
72#endif
73
74/* forward declaration */
75typedef struct _bfd bfd;
76
77/* To squelch erroneous compiler warnings ("illegal pointer
78   combination") from the SVR3 compiler, we would like to typedef
79   boolean to int (it doesn't like functions which return boolean.
80   Making sure they are never implicitly declared to return int
81   doesn't seem to help).  But this file is not configured based on
82   the host.  */
83/* General rules: functions which are boolean return true on success
84   and false on failure (unless they're a predicate).   -- bfd.doc */
85/* I'm sure this is going to break something and someone is going to
86   force me to change it. */
87/* typedef enum boolean {false, true} boolean; */
88/* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h>  -fnf */
89/* It gets worse if the host also defines a true/false enum... -sts */
90/* And even worse if your compiler has built-in boolean types... -law */
91#if defined (__GNUG__) && (__GNUC_MINOR__ > 5)
92#define TRUE_FALSE_ALREADY_DEFINED
93#endif
94#ifdef MPW
95/* Pre-emptive strike - get the file with the enum. */
96#include <Types.h>
97#define TRUE_FALSE_ALREADY_DEFINED
98#endif /* MPW */
99#ifndef TRUE_FALSE_ALREADY_DEFINED
100typedef enum bfd_boolean {false, true} boolean;
101#define BFD_TRUE_FALSE
102#else
103/* Use enum names that will appear nowhere else.  */
104typedef enum bfd_boolean {bfd_fffalse, bfd_tttrue} boolean;
105#endif
106
107/* A pointer to a position in a file.  */
108/* FIXME:  This should be using off_t from <sys/types.h>.
109   For now, try to avoid breaking stuff by not including <sys/types.h> here.
110   This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
111   Probably the best long-term answer is to avoid using file_ptr AND off_t
112   in this header file, and to handle this in the BFD implementation
113   rather than in its interface.  */
114/* typedef off_t	file_ptr; */
115typedef long int file_ptr;
116
117/* Support for different sizes of target format ints and addresses.
118   If the type `long' is at least 64 bits, BFD_HOST_64BIT_LONG will be
119   set to 1 above.  Otherwise, if gcc is being used, this code will
120   use gcc's "long long" type.  Otherwise, BFD_HOST_64_BIT must be
121   defined above.  */
122
123#ifdef BFD64
124
125#ifndef BFD_HOST_64_BIT
126#if BFD_HOST_64BIT_LONG
127#define BFD_HOST_64_BIT long
128#define BFD_HOST_U_64_BIT unsigned long
129#else
130#ifdef __GNUC__
131#define BFD_HOST_64_BIT long long
132#define BFD_HOST_U_64_BIT unsigned long long
133#else /* ! defined (__GNUC__) */
134 #error No 64 bit integer type available
135#endif /* ! defined (__GNUC__) */
136#endif /* ! BFD_HOST_64BIT_LONG */
137#endif /* ! defined (BFD_HOST_64_BIT) */
138
139typedef BFD_HOST_U_64_BIT bfd_vma;
140typedef BFD_HOST_64_BIT bfd_signed_vma;
141typedef BFD_HOST_U_64_BIT bfd_size_type;
142typedef BFD_HOST_U_64_BIT symvalue;
143
144#ifndef fprintf_vma
145#if BFD_HOST_64BIT_LONG
146#define sprintf_vma(s,x) sprintf (s, "%016lx", x)
147#define fprintf_vma(f,x) fprintf (f, "%016lx", x)
148#else
149#define _bfd_int64_low(x) ((unsigned long) (((x) & 0xffffffff)))
150#define _bfd_int64_high(x) ((unsigned long) (((x) >> 32) & 0xffffffff))
151#define fprintf_vma(s,x) \
152  fprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
153#define sprintf_vma(s,x) \
154  sprintf ((s), "%08lx%08lx", _bfd_int64_high (x), _bfd_int64_low (x))
155#endif
156#endif
157
158#else /* not BFD64  */
159
160/* Represent a target address.  Also used as a generic unsigned type
161   which is guaranteed to be big enough to hold any arithmetic types
162   we need to deal with.  */
163typedef unsigned long bfd_vma;
164
165/* A generic signed type which is guaranteed to be big enough to hold any
166   arithmetic types we need to deal with.  Can be assumed to be compatible
167   with bfd_vma in the same way that signed and unsigned ints are compatible
168   (as parameters, in assignment, etc).  */
169typedef long bfd_signed_vma;
170
171typedef unsigned long symvalue;
172typedef unsigned long bfd_size_type;
173
174/* Print a bfd_vma x on stream s.  */
175#define fprintf_vma(s,x) fprintf(s, "%08lx", x)
176#define sprintf_vma(s,x) sprintf(s, "%08lx", x)
177#endif /* not BFD64  */
178#define printf_vma(x) fprintf_vma(stdout,x)
179
180typedef unsigned int flagword;	/* 32 bits of flags */
181typedef unsigned char bfd_byte;
182
183/** File formats */
184
185typedef enum bfd_format {
186	      bfd_unknown = 0,	/* file format is unknown */
187	      bfd_object,	/* linker/assember/compiler output */
188	      bfd_archive,	/* object archive file */
189	      bfd_core,		/* core dump */
190	      bfd_type_end}	/* marks the end; don't use it! */
191         bfd_format;
192
193/* Values that may appear in the flags field of a BFD.  These also
194   appear in the object_flags field of the bfd_target structure, where
195   they indicate the set of flags used by that backend (not all flags
196   are meaningful for all object file formats) (FIXME: at the moment,
197   the object_flags values have mostly just been copied from backend
198   to another, and are not necessarily correct).  */
199
200/* No flags.  */
201#define BFD_NO_FLAGS   	0x00
202
203/* BFD contains relocation entries.  */
204#define HAS_RELOC   	0x01
205
206/* BFD is directly executable.  */
207#define EXEC_P      	0x02
208
209/* BFD has line number information (basically used for F_LNNO in a
210   COFF header).  */
211#define HAS_LINENO  	0x04
212
213/* BFD has debugging information.  */
214#define HAS_DEBUG   	0x08
215
216/* BFD has symbols.  */
217#define HAS_SYMS    	0x10
218
219/* BFD has local symbols (basically used for F_LSYMS in a COFF
220   header).  */
221#define HAS_LOCALS  	0x20
222
223/* BFD is a dynamic object.  */
224#define DYNAMIC     	0x40
225
226/* Text section is write protected (if D_PAGED is not set, this is
227   like an a.out NMAGIC file) (the linker sets this by default, but
228   clears it for -r or -N).  */
229#define WP_TEXT     	0x80
230
231/* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
232   linker sets this by default, but clears it for -r or -n or -N).  */
233#define D_PAGED     	0x100
234
235/* BFD is relaxable (this means that bfd_relax_section may be able to
236   do something) (sometimes bfd_relax_section can do something even if
237   this is not set).  */
238#define BFD_IS_RELAXABLE 0x200
239
240/* This may be set before writing out a BFD to request using a
241   traditional format.  For example, this is used to request that when
242   writing out an a.out object the symbols not be hashed to eliminate
243   duplicates.  */
244#define BFD_TRADITIONAL_FORMAT 0x400
245
246/* This flag indicates that the BFD contents are actually cached in
247   memory.  If this is set, iostream points to a bfd_in_memory struct.  */
248#define BFD_IN_MEMORY 0x800
249
250/* symbols and relocation */
251
252/* A count of carsyms (canonical archive symbols).  */
253typedef unsigned long symindex;
254
255/* How to perform a relocation.  */
256typedef const struct reloc_howto_struct reloc_howto_type;
257
258#define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
259
260/* General purpose part of a symbol X;
261   target specific parts are in libcoff.h, libaout.h, etc.  */
262
263#define bfd_get_section(x) ((x)->section)
264#define bfd_get_output_section(x) ((x)->section->output_section)
265#define bfd_set_section(x,y) ((x)->section) = (y)
266#define bfd_asymbol_base(x) ((x)->section->vma)
267#define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
268#define bfd_asymbol_name(x) ((x)->name)
269/*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
270#define bfd_asymbol_bfd(x) ((x)->the_bfd)
271#define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
272
273/* A canonical archive symbol.  */
274/* This is a type pun with struct ranlib on purpose! */
275typedef struct carsym {
276  char *name;
277  file_ptr file_offset;		/* look here to find the file */
278} carsym;			/* to make these you call a carsymogen */
279
280
281/* Used in generating armaps (archive tables of contents).
282   Perhaps just a forward definition would do? */
283struct orl {			/* output ranlib */
284  char **name;			/* symbol name */
285  file_ptr pos;			/* bfd* or file position */
286  int namidx;			/* index into string table */
287};
288
289
290/* Linenumber stuff */
291typedef struct lineno_cache_entry {
292  unsigned int line_number;	/* Linenumber from start of function*/
293  union {
294    struct symbol_cache_entry *sym; /* Function name */
295    unsigned long offset;	/* Offset into section */
296  } u;
297} alent;
298
299/* object and core file sections */
300
301#define	align_power(addr, align)	\
302	( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
303
304typedef struct sec *sec_ptr;
305
306#define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
307#define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
308#define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
309#define bfd_section_name(bfd, ptr) ((ptr)->name)
310#define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
311#define bfd_section_vma(bfd, ptr) ((ptr)->vma)
312#define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
313#define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
314#define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
315
316#define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
317
318#define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = (boolean)true), true)
319#define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
320#define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
321
322typedef struct stat stat_type;
323
324typedef enum bfd_print_symbol
325{
326  bfd_print_symbol_name,
327  bfd_print_symbol_more,
328  bfd_print_symbol_all
329} bfd_print_symbol_type;
330
331/* Information about a symbol that nm needs.  */
332
333typedef struct _symbol_info
334{
335  symvalue value;
336  char type;
337  CONST char *name;            /* Symbol name.  */
338  unsigned char stab_type;     /* Stab type.  */
339  char stab_other;             /* Stab other. */
340  short stab_desc;             /* Stab desc.  */
341  CONST char *stab_name;       /* String for stab type.  */
342} symbol_info;
343
344/* Get the name of a stabs type code.  */
345
346extern const char *bfd_get_stab_name PARAMS ((int));
347
348/* Hash table routines.  There is no way to free up a hash table.  */
349
350/* An element in the hash table.  Most uses will actually use a larger
351   structure, and an instance of this will be the first field.  */
352
353struct bfd_hash_entry
354{
355  /* Next entry for this hash code.  */
356  struct bfd_hash_entry *next;
357  /* String being hashed.  */
358  const char *string;
359  /* Hash code.  This is the full hash code, not the index into the
360     table.  */
361  unsigned long hash;
362};
363
364/* A hash table.  */
365
366struct bfd_hash_table
367{
368  /* The hash array.  */
369  struct bfd_hash_entry **table;
370  /* The number of slots in the hash table.  */
371  unsigned int size;
372  /* A function used to create new elements in the hash table.  The
373     first entry is itself a pointer to an element.  When this
374     function is first invoked, this pointer will be NULL.  However,
375     having the pointer permits a hierarchy of method functions to be
376     built each of which calls the function in the superclass.  Thus
377     each function should be written to allocate a new block of memory
378     only if the argument is NULL.  */
379  struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
380					     struct bfd_hash_table *,
381					     const char *));
382   /* An objalloc for this hash table.  This is a struct objalloc *,
383     but we use PTR to avoid requiring the inclusion of objalloc.h.  */
384  PTR memory;
385};
386
387/* Initialize a hash table.  */
388extern boolean bfd_hash_table_init
389  PARAMS ((struct bfd_hash_table *,
390	   struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
391				       struct bfd_hash_table *,
392				       const char *)));
393
394/* Initialize a hash table specifying a size.  */
395extern boolean bfd_hash_table_init_n
396  PARAMS ((struct bfd_hash_table *,
397	   struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
398				       struct bfd_hash_table *,
399				       const char *),
400	   unsigned int size));
401
402/* Free up a hash table.  */
403extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *));
404
405/* Look up a string in a hash table.  If CREATE is true, a new entry
406   will be created for this string if one does not already exist.  The
407   COPY argument must be true if this routine should copy the string
408   into newly allocated memory when adding an entry.  */
409extern struct bfd_hash_entry *bfd_hash_lookup
410  PARAMS ((struct bfd_hash_table *, const char *, boolean create,
411	   boolean copy));
412
413/* Replace an entry in a hash table.  */
414extern void bfd_hash_replace
415  PARAMS ((struct bfd_hash_table *, struct bfd_hash_entry *old,
416	   struct bfd_hash_entry *nw));
417
418/* Base method for creating a hash table entry.  */
419extern struct bfd_hash_entry *bfd_hash_newfunc
420  PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
421	   const char *));
422
423/* Grab some space for a hash table entry.  */
424extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *,
425				      unsigned int));
426
427/* Traverse a hash table in a random order, calling a function on each
428   element.  If the function returns false, the traversal stops.  The
429   INFO argument is passed to the function.  */
430extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *,
431				       boolean (*) (struct bfd_hash_entry *,
432						    PTR),
433				       PTR info));
434
435/* Semi-portable string concatenation in cpp.
436   The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors.
437   The problem is, "32_" is not a valid preprocessing token, and we don't
438   want extra underscores (e.g., "nlm_32_").  The XCAT2 macro will cause the
439   inner CAT macros to be evaluated first, producing still-valid pp-tokens.
440   Then the final concatenation can be done.  (Sigh.)  */
441#ifndef CAT
442#ifdef SABER
443#define CAT(a,b)	a##b
444#define CAT3(a,b,c)	a##b##c
445#define CAT4(a,b,c,d)	a##b##c##d
446#else
447#if defined(__STDC__) || defined(ALMOST_STDC)
448#define CAT(a,b) a##b
449#define CAT3(a,b,c) a##b##c
450#define XCAT2(a,b)	CAT(a,b)
451#define CAT4(a,b,c,d)	XCAT2(CAT(a,b),CAT(c,d))
452#else
453#define CAT(a,b) a/**/b
454#define CAT3(a,b,c) a/**/b/**/c
455#define CAT4(a,b,c,d)	a/**/b/**/c/**/d
456#endif
457#endif
458#endif
459
460#define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
461
462/* User program access to BFD facilities */
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
467extern bfd_size_type bfd_read
468  PARAMS ((PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd));
469extern bfd_size_type bfd_write
470  PARAMS ((const PTR, bfd_size_type size, bfd_size_type nitems, bfd *abfd));
471extern int bfd_seek PARAMS ((bfd *abfd, file_ptr fp, int direction));
472extern long bfd_tell PARAMS ((bfd *abfd));
473extern int bfd_flush PARAMS ((bfd *abfd));
474extern int bfd_stat PARAMS ((bfd *abfd, struct stat *));
475
476
477/* Cast from const char * to char * so that caller can assign to
478   a char * without a warning.  */
479#define bfd_get_filename(abfd) ((char *) (abfd)->filename)
480#define bfd_get_cacheable(abfd) ((abfd)->cacheable)
481#define bfd_get_format(abfd) ((abfd)->format)
482#define bfd_get_target(abfd) ((abfd)->xvec->name)
483#define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
484#define bfd_big_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_BIG)
485#define bfd_little_endian(abfd) ((abfd)->xvec->byteorder == BFD_ENDIAN_LITTLE)
486#define bfd_header_big_endian(abfd) \
487  ((abfd)->xvec->header_byteorder == BFD_ENDIAN_BIG)
488#define bfd_header_little_endian(abfd) \
489  ((abfd)->xvec->header_byteorder == BFD_ENDIAN_LITTLE)
490#define bfd_get_file_flags(abfd) ((abfd)->flags)
491#define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
492#define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
493#define bfd_my_archive(abfd) ((abfd)->my_archive)
494#define bfd_has_map(abfd) ((abfd)->has_armap)
495
496#define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
497#define bfd_usrdata(abfd) ((abfd)->usrdata)
498
499#define bfd_get_start_address(abfd) ((abfd)->start_address)
500#define bfd_get_symcount(abfd) ((abfd)->symcount)
501#define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
502#define bfd_count_sections(abfd) ((abfd)->section_count)
503
504#define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
505
506#define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (boolean)(bool)), true)
507
508extern boolean bfd_record_phdr
509  PARAMS ((bfd *, unsigned long, boolean, flagword, boolean, bfd_vma,
510	   boolean, boolean, unsigned int, struct sec **));
511
512/* Byte swapping routines.  */
513
514bfd_vma		bfd_getb64	   PARAMS ((const unsigned char *));
515bfd_vma 	bfd_getl64	   PARAMS ((const unsigned char *));
516bfd_signed_vma	bfd_getb_signed_64 PARAMS ((const unsigned char *));
517bfd_signed_vma	bfd_getl_signed_64 PARAMS ((const unsigned char *));
518bfd_vma		bfd_getb32	   PARAMS ((const unsigned char *));
519bfd_vma		bfd_getl32	   PARAMS ((const unsigned char *));
520bfd_signed_vma	bfd_getb_signed_32 PARAMS ((const unsigned char *));
521bfd_signed_vma	bfd_getl_signed_32 PARAMS ((const unsigned char *));
522bfd_vma		bfd_getb16	   PARAMS ((const unsigned char *));
523bfd_vma		bfd_getl16	   PARAMS ((const unsigned char *));
524bfd_signed_vma	bfd_getb_signed_16 PARAMS ((const unsigned char *));
525bfd_signed_vma	bfd_getl_signed_16 PARAMS ((const unsigned char *));
526void		bfd_putb64	   PARAMS ((bfd_vma, unsigned char *));
527void		bfd_putl64	   PARAMS ((bfd_vma, unsigned char *));
528void		bfd_putb32	   PARAMS ((bfd_vma, unsigned char *));
529void		bfd_putl32	   PARAMS ((bfd_vma, unsigned char *));
530void		bfd_putb16	   PARAMS ((bfd_vma, unsigned char *));
531void		bfd_putl16	   PARAMS ((bfd_vma, unsigned char *));
532
533/* Externally visible ECOFF routines.  */
534
535#if defined(__STDC__) || defined(ALMOST_STDC)
536struct ecoff_debug_info;
537struct ecoff_debug_swap;
538struct ecoff_extr;
539struct symbol_cache_entry;
540struct bfd_link_info;
541struct bfd_link_hash_entry;
542struct bfd_elf_version_tree;
543#endif
544extern bfd_vma bfd_ecoff_get_gp_value PARAMS ((bfd * abfd));
545extern boolean bfd_ecoff_set_gp_value PARAMS ((bfd *abfd, bfd_vma gp_value));
546extern boolean bfd_ecoff_set_regmasks
547  PARAMS ((bfd *abfd, unsigned long gprmask, unsigned long fprmask,
548	   unsigned long *cprmask));
549extern PTR bfd_ecoff_debug_init
550  PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
551	   const struct ecoff_debug_swap *output_swap,
552	   struct bfd_link_info *));
553extern void bfd_ecoff_debug_free
554  PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
555	   const struct ecoff_debug_swap *output_swap,
556	   struct bfd_link_info *));
557extern boolean bfd_ecoff_debug_accumulate
558  PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
559	   const struct ecoff_debug_swap *output_swap,
560	   bfd *input_bfd, struct ecoff_debug_info *input_debug,
561	   const struct ecoff_debug_swap *input_swap,
562	   struct bfd_link_info *));
563extern boolean bfd_ecoff_debug_accumulate_other
564  PARAMS ((PTR handle, bfd *output_bfd, struct ecoff_debug_info *output_debug,
565	   const struct ecoff_debug_swap *output_swap, bfd *input_bfd,
566	   struct bfd_link_info *));
567extern boolean bfd_ecoff_debug_externals
568  PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
569	   const struct ecoff_debug_swap *swap,
570	   boolean relocateable,
571	   boolean (*get_extr) (struct symbol_cache_entry *,
572				struct ecoff_extr *),
573	   void (*set_index) (struct symbol_cache_entry *,
574			      bfd_size_type)));
575extern boolean bfd_ecoff_debug_one_external
576  PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
577	   const struct ecoff_debug_swap *swap,
578	   const char *name, struct ecoff_extr *esym));
579extern bfd_size_type bfd_ecoff_debug_size
580  PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
581	   const struct ecoff_debug_swap *swap));
582extern boolean bfd_ecoff_write_debug
583  PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
584	   const struct ecoff_debug_swap *swap, file_ptr where));
585extern boolean bfd_ecoff_write_accumulated_debug
586  PARAMS ((PTR handle, bfd *abfd, struct ecoff_debug_info *debug,
587	   const struct ecoff_debug_swap *swap,
588	   struct bfd_link_info *info, file_ptr where));
589extern boolean bfd_mips_ecoff_create_embedded_relocs
590  PARAMS ((bfd *, struct bfd_link_info *, struct sec *, struct sec *,
591	   char **));
592
593/* Externally visible ELF routines.  */
594
595struct bfd_link_needed_list
596{
597  struct bfd_link_needed_list *next;
598  bfd *by;
599  const char *name;
600};
601
602extern boolean bfd_elf32_record_link_assignment
603  PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean));
604extern boolean bfd_elf64_record_link_assignment
605  PARAMS ((bfd *, struct bfd_link_info *, const char *, boolean));
606extern struct bfd_link_needed_list *bfd_elf_get_needed_list
607  PARAMS ((bfd *, struct bfd_link_info *));
608extern boolean bfd_elf32_size_dynamic_sections
609  PARAMS ((bfd *, const char *, const char *, boolean, const char *,
610	   const char * const *, struct bfd_link_info *, struct sec **,
611	   struct bfd_elf_version_tree *));
612extern boolean bfd_elf64_size_dynamic_sections
613  PARAMS ((bfd *, const char *, const char *, boolean, const char *,
614	   const char * const *, struct bfd_link_info *, struct sec **,
615	   struct bfd_elf_version_tree *));
616extern void bfd_elf_set_dt_needed_name PARAMS ((bfd *, const char *));
617extern const char *bfd_elf_get_dt_soname PARAMS ((bfd *));
618
619/* SunOS shared library support routines for the linker.  */
620
621extern struct bfd_link_needed_list *bfd_sunos_get_needed_list
622  PARAMS ((bfd *, struct bfd_link_info *));
623extern boolean bfd_sunos_record_link_assignment
624  PARAMS ((bfd *, struct bfd_link_info *, const char *));
625extern boolean bfd_sunos_size_dynamic_sections
626  PARAMS ((bfd *, struct bfd_link_info *, struct sec **, struct sec **,
627	   struct sec **));
628
629/* Linux shared library support routines for the linker.  */
630
631extern boolean bfd_i386linux_size_dynamic_sections
632  PARAMS ((bfd *, struct bfd_link_info *));
633extern boolean bfd_m68klinux_size_dynamic_sections
634  PARAMS ((bfd *, struct bfd_link_info *));
635extern boolean bfd_sparclinux_size_dynamic_sections
636  PARAMS ((bfd *, struct bfd_link_info *));
637
638/* mmap hacks */
639
640struct _bfd_window_internal;
641typedef struct _bfd_window_internal bfd_window_internal;
642
643typedef struct _bfd_window {
644  /* What the user asked for.  */
645  PTR data;
646  bfd_size_type size;
647  /* The actual window used by BFD.  Small user-requested read-only
648     regions sharing a page may share a single window into the object
649     file.  Read-write versions shouldn't until I've fixed things to
650     keep track of which portions have been claimed by the
651     application; don't want to give the same region back when the
652     application wants two writable copies!  */
653  struct _bfd_window_internal *i;
654} bfd_window;
655
656extern void bfd_init_window PARAMS ((bfd_window *));
657extern void bfd_free_window PARAMS ((bfd_window *));
658extern boolean bfd_get_file_window
659  PARAMS ((bfd *, file_ptr, bfd_size_type, bfd_window *, boolean));
660
661/* XCOFF support routines for the linker.  */
662
663extern boolean bfd_xcoff_link_record_set
664  PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
665	   bfd_size_type));
666extern boolean bfd_xcoff_import_symbol
667  PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
668	   bfd_vma, const char *, const char *, const char *));
669extern boolean bfd_xcoff_export_symbol
670  PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *,
671	   boolean));
672extern boolean bfd_xcoff_link_count_reloc
673  PARAMS ((bfd *, struct bfd_link_info *, const char *));
674extern boolean bfd_xcoff_record_link_assignment
675  PARAMS ((bfd *, struct bfd_link_info *, const char *));
676extern boolean bfd_xcoff_size_dynamic_sections
677  PARAMS ((bfd *, struct bfd_link_info *, const char *, const char *,
678	   unsigned long, unsigned long, unsigned long, boolean,
679	   int, boolean, boolean, struct sec **));
680
681/* Externally visible COFF routines.  */
682
683#if defined(__STDC__) || defined(ALMOST_STDC)
684struct internal_syment;
685union internal_auxent;
686#endif
687
688extern boolean bfd_coff_get_syment
689  PARAMS ((bfd *, struct symbol_cache_entry *, struct internal_syment *));
690extern boolean bfd_coff_get_auxent
691  PARAMS ((bfd *, struct symbol_cache_entry *, int, union internal_auxent *));
692
693/* And more from the source.  */
694