Fri Jan 7 10:29:27 1994 Stan Shebs (shebs@andros.cygnus.com)
[external/binutils.git] / bfd / bfd-in.h
1 /* Main header file for the bfd library -- portable access to object files.
2    Copyright 1990, 1991, 1992, 1993 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
9 This file is part of BFD, the Binary File Descriptor library.
10
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
15
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19 GNU General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
24
25 /* bfd.h -- The only header file required by users of the bfd library 
26
27 The bfd.h file is generated from bfd-in.h and various .c files; if you
28 change it, your changes will probably be lost.
29
30 All the prototypes and definitions following the comment "THE FOLLOWING
31 IS EXTRACTED FROM THE SOURCE" are extracted from the source files for
32 BFD.  If you change it, someone oneday will extract it from the source
33 again, and your changes will be lost.  To save yourself from this bind,
34 change the definitions in the source in the bfd directory.  Type "make
35 docs" and then "make headers" in that directory, and magically this file
36 will change to reflect your changes.
37
38 If you don't have the tools to perform the extraction, then you are
39 safe from someone on your system trampling over your header files.
40 You should still maintain the equivalence between the source and this
41 file though; every change you make to the .c file should be reflected
42 here.  */
43
44 #ifndef __BFD_H_SEEN__
45 #define __BFD_H_SEEN__
46
47 #include "ansidecl.h"
48 #include "obstack.h"
49
50 #define BFD_VERSION "2.2"
51
52 #define BFD_ARCH_SIZE @WORDSIZE@
53
54 #if BFD_ARCH_SIZE >= 64
55 #define BFD64
56 #endif
57
58 #ifndef INLINE
59 #if __GNUC__ >= 2
60 #define INLINE __inline__
61 #else
62 #define INLINE
63 #endif
64 #endif
65
66 /* 64-bit type definition (if any) from bfd's sysdep.h goes here */
67
68
69 /* forward declaration */
70 typedef struct _bfd bfd;
71
72 /* To squelch erroneous compiler warnings ("illegal pointer
73    combination") from the SVR3 compiler, we would like to typedef
74    boolean to int (it doesn't like functions which return boolean.
75    Making sure they are never implicitly declared to return int
76    doesn't seem to help).  But this file is not configured based on
77    the host.  */
78 /* General rules: functions which are boolean return true on success
79    and false on failure (unless they're a predicate).   -- bfd.doc */
80 /* I'm sure this is going to break something and someone is going to
81    force me to change it. */
82 /* typedef enum boolean {false, true} boolean; */
83 /* Yup, SVR4 has a "typedef enum boolean" in <sys/types.h>  -fnf */
84 /* It gets worse if the host also defines a true/false enum... -sts */
85 #ifndef TRUE_FALSE_ALREADY_DEFINED
86 typedef enum bfd_boolean {false, true} boolean;
87 #define BFD_TRUE_FALSE
88 #else
89 typedef enum bfd_boolean {bfd_false, bfd_true} boolean;
90 #endif
91
92 /* A pointer to a position in a file.  */
93 /* FIXME:  This should be using off_t from <sys/types.h>.
94    For now, try to avoid breaking stuff by not including <sys/types.h> here.
95    This will break on systems with 64-bit file offsets (e.g. 4.4BSD).
96    Probably the best long-term answer is to avoid using file_ptr AND off_t 
97    in this header file, and to handle this in the BFD implementation
98    rather than in its interface.  */
99 /* typedef off_t        file_ptr; */
100 typedef long int file_ptr;
101
102 /* Support for different sizes of target format ints and addresses.  If the
103    host implements 64-bit values, it defines HOST_64_BIT to be the appropriate
104    type.  Otherwise, this code will fall back on gcc's "long long" type if gcc
105    is being used.  HOST_64_BIT must be defined in such a way as to be a valid
106    type name by itself or with "unsigned" prefixed.  It should be a signed
107    type by itself.
108
109    If neither is the case, then compilation will fail if 64-bit targets are
110    requested.  If you don't request any 64-bit targets, you should be safe. */
111
112 #ifdef  BFD64
113
114 #if defined (__GNUC__) && !defined (HOST_64_BIT)
115 #define HOST_64_BIT long long
116 typedef HOST_64_BIT int64_type;
117 typedef unsigned HOST_64_BIT uint64_type;
118 #endif
119
120 #if !defined (uint64_type) && defined (__GNUC__)
121 #define uint64_type unsigned long long
122 #define int64_type long long
123 #define uint64_typeLOW(x) ((unsigned long)(((x) & 0xffffffff)))
124 #define uint64_typeHIGH(x) ((unsigned long)(((x) >> 32) & 0xffffffff))
125 #endif
126
127 typedef unsigned HOST_64_BIT bfd_vma;
128 typedef HOST_64_BIT bfd_signed_vma;
129 typedef unsigned HOST_64_BIT bfd_size_type;
130 typedef unsigned HOST_64_BIT symvalue;
131 #define fprintf_vma(s,x) \
132                 fprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
133 #define sprintf_vma(s,x) \
134                 sprintf(s,"%08lx%08lx", uint64_typeHIGH(x), uint64_typeLOW(x))
135 #else /* not BFD64  */
136
137 /* Represent a target address.  Also used as a generic unsigned type
138    which is guaranteed to be big enough to hold any arithmetic types
139    we need to deal with.  */
140 typedef unsigned long bfd_vma;
141
142 /* A generic signed type which is guaranteed to be big enough to hold any
143    arithmetic types we need to deal with.  Can be assumed to be compatible
144    with bfd_vma in the same way that signed and unsigned ints are compatible
145    (as parameters, in assignment, etc).  */
146 typedef long bfd_signed_vma;
147
148 typedef unsigned long symvalue;
149 typedef unsigned long bfd_size_type;
150
151 /* Print a bfd_vma x on stream s.  */
152 #define fprintf_vma(s,x) fprintf(s, "%08lx", x)
153 #define sprintf_vma(s,x) sprintf(s, "%08lx", x)
154 #endif /* not BFD64  */
155 #define printf_vma(x) fprintf_vma(stdout,x)
156
157 typedef unsigned int flagword;  /* 32 bits of flags */
158 \f
159 /** File formats */
160
161 typedef enum bfd_format {
162               bfd_unknown = 0,  /* file format is unknown */
163               bfd_object,       /* linker/assember/compiler output */
164               bfd_archive,      /* object archive file */
165               bfd_core,         /* core dump */
166               bfd_type_end}     /* marks the end; don't use it! */
167          bfd_format;
168
169 /* Values that may appear in the flags field of a BFD.  These also
170    appear in the object_flags field of the bfd_target structure, where
171    they indicate the set of flags used by that backend (not all flags
172    are meaningful for all object file formats) (FIXME: at the moment,
173    the object_flags values have mostly just been copied from backend
174    to another, and are not necessarily correct).  */
175
176 /* No flags.  */
177 #define NO_FLAGS        0x00
178
179 /* BFD contains relocation entries.  */
180 #define HAS_RELOC       0x01
181
182 /* BFD is directly executable.  */
183 #define EXEC_P          0x02
184
185 /* BFD has line number information (basically used for F_LNNO in a
186    COFF header).  */
187 #define HAS_LINENO      0x04
188
189 /* BFD has debugging information.  */
190 #define HAS_DEBUG       0x08
191
192 /* BFD has symbols.  */
193 #define HAS_SYMS        0x10
194
195 /* BFD has local symbols (basically used for F_LSYMS in a COFF
196    header).  */
197 #define HAS_LOCALS      0x20
198
199 /* BFD is a dynamic object.  */
200 #define DYNAMIC         0x40
201
202 /* Text section is write protected (if D_PAGED is not set, this is
203    like an a.out NMAGIC file) (the linker sets this by default, but
204    clears it for -r or -N).  */
205 #define WP_TEXT         0x80
206
207 /* BFD is dynamically paged (this is like an a.out ZMAGIC file) (the
208    linker sets this by default, but clears it for -r or -n or -N).  */
209 #define D_PAGED         0x100
210
211 /* BFD is relaxable (this means that bfd_relax_section may be able to
212    do something).  */
213 #define BFD_IS_RELAXABLE 0x200
214 \f
215 /* symbols and relocation */
216
217 typedef unsigned long symindex;
218
219 #define BFD_NO_MORE_SYMBOLS ((symindex) ~0)
220
221 typedef enum bfd_symclass {
222               bfd_symclass_unknown = 0,
223               bfd_symclass_fcommon, /* fortran common symbols */
224               bfd_symclass_global, /* global symbol, what a surprise */
225               bfd_symclass_debugger, /* some debugger symbol */
226               bfd_symclass_undefined /* none known */
227             } symclass;
228
229
230 /* general purpose part of a symbol;
231    target specific parts will be found in libcoff.h, liba.out.h etc */
232
233
234 #define bfd_get_section(x) ((x)->section)
235 #define bfd_get_output_section(x) ((x)->section->output_section)
236 #define bfd_set_section(x,y) ((x)->section) = (y)
237 #define bfd_asymbol_base(x) ((x)->section->vma)
238 #define bfd_asymbol_value(x) (bfd_asymbol_base(x) + (x)->value)
239 #define bfd_asymbol_name(x) ((x)->name)
240 /*Perhaps future: #define bfd_asymbol_bfd(x) ((x)->section->owner)*/
241 #define bfd_asymbol_bfd(x) ((x)->the_bfd)
242 #define bfd_asymbol_flavour(x) (bfd_asymbol_bfd(x)->xvec->flavour)
243
244 /* This is a type pun with struct ranlib on purpose! */
245 typedef struct carsym {
246   char *name;
247   file_ptr file_offset;         /* look here to find the file */
248 } carsym;                       /* to make these you call a carsymogen */
249
250   
251 /* Used in generating armaps.  Perhaps just a forward definition would do? */
252 struct orl {                    /* output ranlib */
253   char **name;                  /* symbol name */ 
254   file_ptr pos;                 /* bfd* or file position */
255   int namidx;                   /* index into string table */
256 };
257
258 \f
259
260 /* Linenumber stuff */
261 typedef struct lineno_cache_entry {
262   unsigned int line_number;     /* Linenumber from start of function*/  
263   union {
264  struct symbol_cache_entry *sym;                /* Function name */
265     unsigned long offset;       /* Offset into section */
266   } u;
267 } alent;
268 \f
269 /* object and core file sections */
270
271
272 #define align_power(addr, align)        \
273         ( ((addr) + ((1<<(align))-1)) & (-1 << (align)))
274
275 typedef struct sec *sec_ptr;
276
277 #define bfd_get_section_name(bfd, ptr) ((ptr)->name + 0)
278 #define bfd_get_section_vma(bfd, ptr) ((ptr)->vma + 0)
279 #define bfd_get_section_alignment(bfd, ptr) ((ptr)->alignment_power + 0)
280 #define bfd_section_name(bfd, ptr) ((ptr)->name)
281 #define bfd_section_size(bfd, ptr) (bfd_get_section_size_before_reloc(ptr))
282 #define bfd_section_vma(bfd, ptr) ((ptr)->vma)
283 #define bfd_section_alignment(bfd, ptr) ((ptr)->alignment_power)
284 #define bfd_get_section_flags(bfd, ptr) ((ptr)->flags + 0)
285 #define bfd_get_section_userdata(bfd, ptr) ((ptr)->userdata)
286
287 #define bfd_is_com_section(ptr) (((ptr)->flags & SEC_IS_COMMON) != 0)
288
289 #define bfd_set_section_vma(bfd, ptr, val) (((ptr)->vma = (ptr)->lma= (val)), ((ptr)->user_set_vma = true), true)
290 #define bfd_set_section_alignment(bfd, ptr, val) (((ptr)->alignment_power = (val)),true)
291 #define bfd_set_section_userdata(bfd, ptr, val) (((ptr)->userdata = (val)),true)
292
293 typedef struct stat stat_type; 
294 \f
295 /* Error handling */
296
297 typedef enum bfd_error
298 {
299   no_error = 0,
300   system_call_error,
301   invalid_target,
302   wrong_format,
303   invalid_operation,
304   no_memory,
305   no_symbols,
306   no_relocation_info,
307   no_more_archived_files,
308   malformed_archive,
309   symbol_not_found,
310   file_not_recognized,
311   file_ambiguously_recognized,
312   no_contents,
313   bfd_error_nonrepresentable_section,
314   no_debug_section,
315   bad_value,
316   file_truncated,
317   invalid_error_code
318 } bfd_ec;
319
320 extern bfd_ec bfd_error;
321
322 CONST char *bfd_errmsg PARAMS ((bfd_ec error_tag));
323 void bfd_perror PARAMS ((CONST char *message));
324 \f
325
326 typedef enum bfd_print_symbol
327
328   bfd_print_symbol_name,
329   bfd_print_symbol_more,
330   bfd_print_symbol_all
331 } bfd_print_symbol_type;
332     
333 \f
334 /* Information about a symbol that nm needs.  */
335
336 typedef struct _symbol_info
337 {
338   symvalue value;
339   char type;                   /*  */
340   CONST char *name;            /* Symbol name.  */
341   char stab_other;             /* Unused. */
342   short stab_desc;             /* Info for N_TYPE.  */
343   CONST char *stab_name;
344 } symbol_info;
345 \f
346 /* Hash table routines.  There is no way to free up a hash table.  */
347
348 /* An element in the hash table.  Most uses will actually use a larger
349    structure, and an instance of this will be the first field.  */
350
351 struct bfd_hash_entry
352 {
353   /* Next entry for this hash code.  */
354   struct bfd_hash_entry *next;
355   /* String being hashed.  */
356   const char *string;
357   /* Hash code.  This is the full hash code, not the index into the
358      table.  */
359   unsigned long hash;
360 };
361
362 /* A hash table.  */
363
364 struct bfd_hash_table
365 {
366   /* The hash array.  */
367   struct bfd_hash_entry **table;
368   /* The number of slots in the hash table.  */
369   unsigned int size;
370   /* A function used to create new elements in the hash table.  The
371      first entry is itself a pointer to an element.  When this
372      function is first invoked, this pointer will be NULL.  However,
373      having the pointer permits a hierarchy of method functions to be
374      built each of which calls the function in the superclass.  Thus
375      each function should be written to allocate a new block of memory
376      only if the argument is NULL.  */
377   struct bfd_hash_entry *(*newfunc) PARAMS ((struct bfd_hash_entry *,
378                                              struct bfd_hash_table *,
379                                              const char *));
380   /* An obstack for this hash table.  */
381   struct obstack memory;
382 };
383
384 /* Initialize a hash table.  */
385 extern boolean bfd_hash_table_init
386   PARAMS ((struct bfd_hash_table *,
387            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
388                                        struct bfd_hash_table *,
389                                        const char *)));
390
391 /* Initialize a hash table specifying a size.  */
392 extern boolean bfd_hash_table_init_n
393   PARAMS ((struct bfd_hash_table *,
394            struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
395                                        struct bfd_hash_table *,
396                                        const char *),
397            unsigned int size));
398
399 /* Free up a hash table.  */
400 extern void bfd_hash_table_free PARAMS ((struct bfd_hash_table *));
401
402 /* Look up a string in a hash table.  If CREATE is true, a new entry
403    will be created for this string if one does not already exist.  The
404    COPY argument must be true if this routine should copy the string
405    into newly allocated memory when adding an entry.  */
406 extern struct bfd_hash_entry *bfd_hash_lookup
407   PARAMS ((struct bfd_hash_table *, const char *, boolean create,
408            boolean copy));
409
410 /* Base method for creating a hash table entry.  */
411 extern struct bfd_hash_entry *bfd_hash_newfunc
412   PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
413            const char *));
414
415 /* Grab some space for a hash table entry.  */
416 extern PTR bfd_hash_allocate PARAMS ((struct bfd_hash_table *,
417                                       unsigned int));
418
419 /* Traverse a hash table in a random order, calling a function on each
420    element.  If the function returns false, the traversal stops.  The
421    INFO argument is passed to the function.  */
422 extern void bfd_hash_traverse PARAMS ((struct bfd_hash_table *,
423                                        boolean (*) (struct bfd_hash_entry *,
424                                                     PTR),
425                                        PTR info));
426 \f
427 /* The code that implements targets can initialize a jump table with this
428    macro.  It must name all its routines the same way (a prefix plus
429    the standard routine suffix), or it must #define the routines that
430    are not so named, before calling JUMP_TABLE in the initializer.  */
431
432 /* Semi-portable string concatenation in cpp.
433    The CAT4 hack is to avoid a problem with some strict ANSI C preprocessors.
434    The problem is, "32_" is not a valid preprocessing token, and we don't
435    want extra underscores (e.g., "nlm_32_").  The XCAT2 macro will cause the
436    inner CAT macros to be evaluated first, producing still-valid pp-tokens.
437    Then the final concatenation can be done.  (Sigh.)  */
438 #ifndef CAT
439 #ifdef SABER
440 #define CAT(a,b)        a##b
441 #define CAT3(a,b,c)     a##b##c
442 #define CAT4(a,b,c,d)   a##b##c##d
443 #else
444 #if defined(__STDC__) || defined(ALMOST_STDC)
445 #define CAT(a,b) a##b
446 #define CAT3(a,b,c) a##b##c
447 #define XCAT2(a,b)      CAT(a,b)
448 #define CAT4(a,b,c,d)   XCAT2(CAT(a,b),CAT(c,d))
449 #else
450 #define CAT(a,b) a/**/b
451 #define CAT3(a,b,c) a/**/b/**/c
452 #define CAT4(a,b,c,d)   a/**/b/**/c/**/d
453 #endif
454 #endif
455 #endif
456
457 #define JUMP_TABLE(NAME)\
458 CAT(NAME,_core_file_failing_command),\
459 CAT(NAME,_core_file_failing_signal),\
460 CAT(NAME,_core_file_matches_executable_p),\
461 CAT(NAME,_slurp_armap),\
462 CAT(NAME,_slurp_extended_name_table),\
463 CAT(NAME,_truncate_arname),\
464 CAT(NAME,_write_armap),\
465 CAT(NAME,_close_and_cleanup),\
466 CAT(NAME,_set_section_contents),\
467 CAT(NAME,_get_section_contents),\
468 CAT(NAME,_new_section_hook),\
469 CAT(NAME,_get_symtab_upper_bound),\
470 CAT(NAME,_get_symtab),\
471 CAT(NAME,_get_reloc_upper_bound),\
472 CAT(NAME,_canonicalize_reloc),\
473 CAT(NAME,_make_empty_symbol),\
474 CAT(NAME,_print_symbol),\
475 CAT(NAME,_get_symbol_info),\
476 CAT(NAME,_get_lineno),\
477 CAT(NAME,_set_arch_mach),\
478 CAT(NAME,_openr_next_archived_file),\
479 CAT(NAME,_find_nearest_line),\
480 CAT(NAME,_generic_stat_arch_elt),\
481 CAT(NAME,_sizeof_headers),\
482 CAT(NAME,_bfd_debug_info_start),\
483 CAT(NAME,_bfd_debug_info_end),\
484 CAT(NAME,_bfd_debug_info_accumulate),\
485 CAT(NAME,_bfd_get_relocated_section_contents),\
486 CAT(NAME,_bfd_relax_section),\
487 CAT(NAME,_bfd_reloc_type_lookup),\
488 CAT(NAME,_bfd_make_debug_symbol),\
489 CAT(NAME,_bfd_link_hash_table_create),\
490 CAT(NAME,_bfd_link_add_symbols),\
491 CAT(NAME,_bfd_final_link)
492
493 #define COFF_SWAP_TABLE (PTR) &bfd_coff_std_swap_table
494
495 \f
496 /* User program access to BFD facilities */
497
498 /* Cast from const char * to char * so that caller can assign to
499    a char * without a warning.  */
500 #define bfd_get_filename(abfd) ((char *) (abfd)->filename)
501 #define bfd_get_cacheable(abfd) ((abfd)->cacheable)
502 #define bfd_get_format(abfd) ((abfd)->format)
503 #define bfd_get_target(abfd) ((abfd)->xvec->name)
504 #define bfd_get_flavour(abfd) ((abfd)->xvec->flavour)
505 #define bfd_get_file_flags(abfd) ((abfd)->flags)
506 #define bfd_applicable_file_flags(abfd) ((abfd)->xvec->object_flags)
507 #define bfd_applicable_section_flags(abfd) ((abfd)->xvec->section_flags)
508 #define bfd_my_archive(abfd) ((abfd)->my_archive)
509 #define bfd_has_map(abfd) ((abfd)->has_armap)
510
511 #define bfd_valid_reloc_types(abfd) ((abfd)->xvec->valid_reloc_types)
512 #define bfd_usrdata(abfd) ((abfd)->usrdata)
513
514 #define bfd_get_start_address(abfd) ((abfd)->start_address)
515 #define bfd_get_symcount(abfd) ((abfd)->symcount)
516 #define bfd_get_outsymbols(abfd) ((abfd)->outsymbols)
517 #define bfd_count_sections(abfd) ((abfd)->section_count)
518
519 #define bfd_get_symbol_leading_char(abfd) ((abfd)->xvec->symbol_leading_char)
520
521 #define bfd_set_cacheable(abfd,bool) (((abfd)->cacheable = (bool)), true)
522
523 /* Byte swapping routines.  */
524
525 bfd_vma         bfd_getb64         PARAMS ((const unsigned char *));
526 bfd_vma         bfd_getl64         PARAMS ((const unsigned char *));
527 bfd_signed_vma  bfd_getb_signed_64 PARAMS ((const unsigned char *));
528 bfd_signed_vma  bfd_getl_signed_64 PARAMS ((const unsigned char *));
529 bfd_vma         bfd_getb32         PARAMS ((const unsigned char *));
530 bfd_vma         bfd_getl32         PARAMS ((const unsigned char *));
531 bfd_signed_vma  bfd_getb_signed_32 PARAMS ((const unsigned char *));
532 bfd_signed_vma  bfd_getl_signed_32 PARAMS ((const unsigned char *));
533 bfd_vma         bfd_getb16         PARAMS ((const unsigned char *));
534 bfd_vma         bfd_getl16         PARAMS ((const unsigned char *));
535 bfd_signed_vma  bfd_getb_signed_16 PARAMS ((const unsigned char *));
536 bfd_signed_vma  bfd_getl_signed_16 PARAMS ((const unsigned char *));
537 void            bfd_putb64         PARAMS ((bfd_vma, unsigned char *));
538 void            bfd_putl64         PARAMS ((bfd_vma, unsigned char *));
539 void            bfd_putb32         PARAMS ((bfd_vma, unsigned char *));
540 void            bfd_putl32         PARAMS ((bfd_vma, unsigned char *));
541 void            bfd_putb16         PARAMS ((bfd_vma, unsigned char *));
542 void            bfd_putl16         PARAMS ((bfd_vma, unsigned char *));
543
544 /* ECOFF linking routines.  */
545 #if defined(__STDC__) || defined(ALMOST_STDC)
546 struct ecoff_debug_info;
547 struct ecoff_debug_swap;
548 struct ecoff_extr;
549 struct symbol_cache_entry;
550 #endif
551 extern boolean bfd_ecoff_debug_accumulate
552   PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
553            const struct ecoff_debug_swap *output_swap,
554            bfd *input_bfd, struct ecoff_debug_info *input_debug,
555            const struct ecoff_debug_swap *input_swap,
556            boolean relocateable));
557 extern boolean bfd_ecoff_debug_link_other
558   PARAMS ((bfd *output_bfd, struct ecoff_debug_info *output_debug,
559            const struct ecoff_debug_swap *output_swap, bfd *input_bfd));
560 extern boolean bfd_ecoff_debug_externals
561   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
562            const struct ecoff_debug_swap *swap,
563            boolean relocateable,
564            boolean (*get_extr) (struct symbol_cache_entry *,
565                                 struct ecoff_extr *),
566            void (*set_index) (struct symbol_cache_entry *,
567                               bfd_size_type)));
568 extern boolean bfd_ecoff_debug_one_external
569   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
570            const struct ecoff_debug_swap *swap,
571            const char *name, struct ecoff_extr *esym));
572 extern bfd_size_type bfd_ecoff_debug_size
573   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
574            const struct ecoff_debug_swap *swap));
575 extern boolean bfd_ecoff_write_debug
576   PARAMS ((bfd *abfd, struct ecoff_debug_info *debug,
577            const struct ecoff_debug_swap *swap, file_ptr where));
578
579 /* And more from the source.  */