xref: /netbsd-src/external/gpl3/binutils.old/dist/bfd/libbfd-in.h (revision 3f351f34c6d827cf017cdcff3543f6ec0c88b420)
1 /* libbfd.h -- Declarations used by bfd library *implementation*.
2    (This include file is not for users of the library.)
3 
4    Copyright (C) 1990-2020 Free Software Foundation, Inc.
5 
6    Written by Cygnus Support.
7 
8    This file is part of BFD, the Binary File Descriptor library.
9 
10    This program is free software; you can redistribute it and/or modify
11    it under the terms of the GNU General Public License as published by
12    the Free Software Foundation; either version 3 of the License, or
13    (at your option) any later version.
14 
15    This program is distributed in the hope that it will be useful,
16    but WITHOUT ANY WARRANTY; without even the implied warranty of
17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18    GNU General Public License for more details.
19 
20    You should have received a copy of the GNU General Public License
21    along with this program; if not, write to the Free Software
22    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
23    MA 02110-1301, USA.  */
24 
25 #ifndef _LIBBFD_H
26 #define _LIBBFD_H 1
27 
28 #ifndef ATTRIBUTE_HIDDEN
29 #if HAVE_HIDDEN
30 #define ATTRIBUTE_HIDDEN __attribute__ ((__visibility__ ("hidden")))
31 #else
32 #define ATTRIBUTE_HIDDEN
33 #endif
34 #endif
35 
36 #include "hashtab.h"
37 
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41 
42 /* If you want to read and write large blocks, you might want to do it
43    in quanta of this amount */
44 #define DEFAULT_BUFFERSIZE 8192
45 
46 /* Set a tdata field.  Can't use the other macros for this, since they
47    do casts, and casting to the left of assignment isn't portable.  */
48 #define set_tdata(bfd, v) ((bfd)->tdata.any = (v))
49 
50 /* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points
51    to an instance of this structure.  */
52 
53 struct bfd_in_memory
54 {
55   /* Size of buffer.  */
56   bfd_size_type size;
57   /* Buffer holding contents of BFD.  */
58   bfd_byte *buffer;
59 };
60 
61 struct section_hash_entry
62 {
63   struct bfd_hash_entry root;
64   asection section;
65 };
66 
67 /* Unique section id.  */
68 extern unsigned int _bfd_section_id ATTRIBUTE_HIDDEN;
69 
70 /* tdata for an archive.  For an input archive, cache
71    needs to be free()'d.  For an output archive, symdefs do.  */
72 
73 struct artdata
74 {
75   file_ptr first_file_filepos;
76   /* Speed up searching the armap */
77   htab_t cache;
78   bfd *archive_head;		/* Only interesting in output routines.  */
79   carsym *symdefs;		/* The symdef entries.  */
80   symindex symdef_count;	/* How many there are.  */
81   char *extended_names;		/* Clever intel extension.  */
82   bfd_size_type extended_names_size; /* Size of extended names.  */
83   /* When more compilers are standard C, this can be a time_t.  */
84   long  armap_timestamp;	/* Timestamp value written into armap.
85 				   This is used for BSD archives to check
86 				   that the timestamp is recent enough
87 				   for the BSD linker to not complain,
88 				   just before we finish writing an
89 				   archive.  */
90   file_ptr armap_datepos;	/* Position within archive to seek to
91 				   rewrite the date field.  */
92   void *tdata;			/* Backend specific information.  */
93 };
94 
95 #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
96 
97 /* Goes in bfd's arelt_data slot */
98 struct areltdata
99 {
100   char * arch_header;		/* It's actually a string.  */
101   bfd_size_type parsed_size;	/* Octets of filesize not including ar_hdr.  */
102   bfd_size_type extra_size;	/* BSD4.4: extra bytes after the header.  */
103   char *filename;		/* Null-terminated.  */
104   file_ptr origin;		/* For element of a thin archive.  */
105   void *parent_cache;		/* Where and how to find this member.  */
106   file_ptr key;
107 };
108 
109 #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
110 
111 extern void *bfd_malloc
112   (bfd_size_type) ATTRIBUTE_HIDDEN;
113 extern void *bfd_realloc
114   (void *, bfd_size_type) ATTRIBUTE_HIDDEN;
115 extern void *bfd_realloc_or_free
116   (void *, bfd_size_type) ATTRIBUTE_HIDDEN;
117 extern void *bfd_zmalloc
118   (bfd_size_type) ATTRIBUTE_HIDDEN;
119 extern void *bfd_malloc2
120   (bfd_size_type, bfd_size_type) ATTRIBUTE_HIDDEN;
121 extern void *bfd_realloc2
122   (void *, bfd_size_type, bfd_size_type) ATTRIBUTE_HIDDEN;
123 extern void *bfd_zmalloc2
124   (bfd_size_type, bfd_size_type) ATTRIBUTE_HIDDEN;
125 
126 static inline char *
127 bfd_strdup (const char *str)
128 {
129   size_t len = strlen (str) + 1;
130   char *buf = bfd_malloc (len);
131   if (buf != NULL)
132     memcpy (buf, str, len);
133   return buf;
134 }
135 /* These routines allocate and free things on the BFD's objalloc.  */
136 
137 extern void *bfd_alloc2
138   (bfd *, bfd_size_type, bfd_size_type) ATTRIBUTE_HIDDEN;
139 extern void *bfd_zalloc2
140   (bfd *, bfd_size_type, bfd_size_type) ATTRIBUTE_HIDDEN;
141 extern void bfd_release
142   (bfd *, void *) ATTRIBUTE_HIDDEN;
143 
144 extern bfd * _bfd_create_empty_archive_element_shell
145   (bfd *) ATTRIBUTE_HIDDEN;
146 extern bfd * _bfd_look_for_bfd_in_cache
147   (bfd *, file_ptr) ATTRIBUTE_HIDDEN;
148 extern bfd_boolean _bfd_add_bfd_to_archive_cache
149   (bfd *, file_ptr, bfd *) ATTRIBUTE_HIDDEN;
150 extern bfd_boolean _bfd_generic_mkarchive
151   (bfd *) ATTRIBUTE_HIDDEN;
152 extern char *_bfd_append_relative_path
153   (bfd *, char *) ATTRIBUTE_HIDDEN;
154 extern const bfd_target *bfd_generic_archive_p
155   (bfd *) ATTRIBUTE_HIDDEN;
156 extern bfd_boolean bfd_slurp_armap
157   (bfd *) ATTRIBUTE_HIDDEN;
158 #define bfd_slurp_bsd_armap bfd_slurp_armap
159 #define bfd_slurp_coff_armap bfd_slurp_armap
160 extern bfd_boolean _bfd_archive_64_bit_slurp_armap
161   (bfd *) ATTRIBUTE_HIDDEN;
162 extern bfd_boolean _bfd_archive_64_bit_write_armap
163   (bfd *, unsigned int, struct orl *, unsigned int, int) ATTRIBUTE_HIDDEN;
164 #define _bfd_archive_64_bit_slurp_extended_name_table \
165   _bfd_slurp_extended_name_table
166 #define _bfd_archive_64_bit_construct_extended_name_table \
167   _bfd_archive_coff_construct_extended_name_table
168 #define _bfd_archive_64_bit_truncate_arname \
169   bfd_dont_truncate_arname
170 #define _bfd_archive_64_bit_read_ar_hdr \
171   _bfd_generic_read_ar_hdr
172 #define _bfd_archive_64_bit_write_ar_hdr \
173   _bfd_generic_write_ar_hdr
174 #define _bfd_archive_64_bit_openr_next_archived_file \
175   bfd_generic_openr_next_archived_file
176 #define _bfd_archive_64_bit_get_elt_at_index \
177   _bfd_generic_get_elt_at_index
178 #define _bfd_archive_64_bit_generic_stat_arch_elt \
179   bfd_generic_stat_arch_elt
180 #define _bfd_archive_64_bit_update_armap_timestamp _bfd_bool_bfd_true
181 
182 extern bfd_boolean _bfd_slurp_extended_name_table
183   (bfd *) ATTRIBUTE_HIDDEN;
184 extern bfd_boolean _bfd_construct_extended_name_table
185   (bfd *, bfd_boolean, char **, bfd_size_type *) ATTRIBUTE_HIDDEN;
186 extern bfd_boolean _bfd_write_archive_contents
187   (bfd *) ATTRIBUTE_HIDDEN;
188 extern bfd_boolean _bfd_compute_and_write_armap
189   (bfd *, unsigned int) ATTRIBUTE_HIDDEN;
190 extern bfd *_bfd_get_elt_at_filepos
191   (bfd *, file_ptr) ATTRIBUTE_HIDDEN;
192 extern bfd *_bfd_generic_get_elt_at_index
193   (bfd *, symindex) ATTRIBUTE_HIDDEN;
194 extern bfd * _bfd_new_bfd
195   (void) ATTRIBUTE_HIDDEN;
196 extern bfd_boolean _bfd_free_cached_info
197   (bfd *) ATTRIBUTE_HIDDEN;
198 
199 extern bfd_boolean _bfd_bool_bfd_false
200   (bfd *) ATTRIBUTE_HIDDEN;
201 extern bfd_boolean _bfd_bool_bfd_asymbol_false
202   (bfd *, asymbol *) ATTRIBUTE_HIDDEN;
203 extern bfd_boolean _bfd_bool_bfd_false_error
204   (bfd *) ATTRIBUTE_HIDDEN;
205 extern bfd_boolean _bfd_bool_bfd_link_false_error
206   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
207 extern bfd_boolean _bfd_bool_bfd_true
208   (bfd *) ATTRIBUTE_HIDDEN;
209 extern bfd_boolean _bfd_bool_bfd_link_true
210   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
211 extern bfd_boolean _bfd_bool_bfd_bfd_true
212   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
213 extern bfd_boolean _bfd_bool_bfd_uint_true
214   (bfd *, unsigned int) ATTRIBUTE_HIDDEN;
215 extern bfd_boolean _bfd_bool_bfd_asection_bfd_asection_true
216   (bfd *, asection *, bfd *, asection *) ATTRIBUTE_HIDDEN;
217 extern bfd_boolean _bfd_bool_bfd_asymbol_bfd_asymbol_true
218   (bfd *, asymbol *, bfd *, asymbol *) ATTRIBUTE_HIDDEN;
219 extern bfd_boolean _bfd_bool_bfd_ptr_true
220   (bfd *, void *) ATTRIBUTE_HIDDEN;
221 extern void *_bfd_ptr_bfd_null_error
222   (bfd *) ATTRIBUTE_HIDDEN;
223 extern int _bfd_int_bfd_0
224   (bfd *) ATTRIBUTE_HIDDEN;
225 extern unsigned int _bfd_uint_bfd_0
226   (bfd *) ATTRIBUTE_HIDDEN;
227 extern long _bfd_long_bfd_0
228   (bfd *) ATTRIBUTE_HIDDEN;
229 extern long _bfd_long_bfd_n1_error
230   (bfd *) ATTRIBUTE_HIDDEN;
231 extern void _bfd_void_bfd
232   (bfd *) ATTRIBUTE_HIDDEN;
233 extern void _bfd_void_bfd_link
234   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
235 extern void _bfd_void_bfd_asection
236   (bfd *, asection *) ATTRIBUTE_HIDDEN;
237 
238 extern bfd *_bfd_new_bfd_contained_in
239   (bfd *) ATTRIBUTE_HIDDEN;
240 extern const bfd_target *_bfd_dummy_target
241   (bfd *) ATTRIBUTE_HIDDEN;
242 
243 extern void bfd_dont_truncate_arname
244   (bfd *, const char *, char *) ATTRIBUTE_HIDDEN;
245 extern void bfd_bsd_truncate_arname
246   (bfd *, const char *, char *) ATTRIBUTE_HIDDEN;
247 extern void bfd_gnu_truncate_arname
248   (bfd *, const char *, char *) ATTRIBUTE_HIDDEN;
249 
250 extern bfd_boolean _bfd_bsd_write_armap
251   (bfd *, unsigned int, struct orl *, unsigned int, int) ATTRIBUTE_HIDDEN;
252 
253 extern bfd_boolean _bfd_coff_write_armap
254   (bfd *, unsigned int, struct orl *, unsigned int, int) ATTRIBUTE_HIDDEN;
255 
256 extern void *_bfd_generic_read_ar_hdr
257   (bfd *) ATTRIBUTE_HIDDEN;
258 extern void _bfd_ar_spacepad
259   (char *, size_t, const char *, long) ATTRIBUTE_HIDDEN;
260 extern bfd_boolean _bfd_ar_sizepad
261   (char *, size_t, bfd_size_type) ATTRIBUTE_HIDDEN;
262 
263 extern void *_bfd_generic_read_ar_hdr_mag
264   (bfd *, const char *) ATTRIBUTE_HIDDEN;
265 
266 extern bfd_boolean _bfd_generic_write_ar_hdr
267   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
268 
269 extern bfd_boolean _bfd_bsd44_write_ar_hdr
270   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
271 
272 extern bfd * bfd_generic_openr_next_archived_file
273   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
274 
275 extern int bfd_generic_stat_arch_elt
276   (bfd *, struct stat *) ATTRIBUTE_HIDDEN;
277 
278 #define _bfd_read_ar_hdr(abfd) \
279 	BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd))
280 #define _bfd_write_ar_hdr(archive, abfd)	 \
281 	BFD_SEND (abfd, _bfd_write_ar_hdr_fn, (archive, abfd))
282 
283 /* Generic routines to use for BFD_JUMP_TABLE_GENERIC.  Use
284    BFD_JUMP_TABLE_GENERIC (_bfd_generic).  */
285 
286 #define _bfd_generic_close_and_cleanup _bfd_archive_close_and_cleanup
287 extern bfd_boolean _bfd_archive_close_and_cleanup
288   (bfd *) ATTRIBUTE_HIDDEN;
289 extern void _bfd_unlink_from_archive_parent (bfd *) ATTRIBUTE_HIDDEN;
290 #define _bfd_generic_bfd_free_cached_info _bfd_bool_bfd_true
291 extern bfd_boolean _bfd_generic_new_section_hook
292   (bfd *, asection *) ATTRIBUTE_HIDDEN;
293 extern bfd_boolean _bfd_generic_get_section_contents
294   (bfd *, asection *, void *, file_ptr, bfd_size_type) ATTRIBUTE_HIDDEN;
295 extern bfd_boolean _bfd_generic_get_section_contents_in_window
296   (bfd *, asection *, bfd_window *, file_ptr, bfd_size_type) ATTRIBUTE_HIDDEN;
297 
298 /* Generic routines to use for BFD_JUMP_TABLE_COPY.  Use
299    BFD_JUMP_TABLE_COPY (_bfd_generic).  */
300 
301 #define _bfd_generic_bfd_copy_private_bfd_data _bfd_bool_bfd_bfd_true
302 #define _bfd_generic_bfd_merge_private_bfd_data \
303   _bfd_bool_bfd_link_true
304 #define _bfd_generic_bfd_set_private_flags _bfd_bool_bfd_uint_true
305 #define _bfd_generic_bfd_copy_private_section_data \
306   _bfd_bool_bfd_asection_bfd_asection_true
307 #define _bfd_generic_bfd_copy_private_symbol_data \
308   _bfd_bool_bfd_asymbol_bfd_asymbol_true
309 #define _bfd_generic_bfd_copy_private_header_data _bfd_bool_bfd_bfd_true
310 #define _bfd_generic_bfd_print_private_bfd_data _bfd_bool_bfd_ptr_true
311 
312 extern bfd_boolean _bfd_generic_init_private_section_data
313   (bfd *, asection *, bfd *, asection *, struct bfd_link_info *)
314   ATTRIBUTE_HIDDEN;
315 
316 /* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
317    support.  Use BFD_JUMP_TABLE_CORE (_bfd_nocore).  */
318 
319 extern char *_bfd_nocore_core_file_failing_command
320   (bfd *) ATTRIBUTE_HIDDEN;
321 extern int _bfd_nocore_core_file_failing_signal
322   (bfd *) ATTRIBUTE_HIDDEN;
323 extern bfd_boolean _bfd_nocore_core_file_matches_executable_p
324   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
325 extern int _bfd_nocore_core_file_pid
326   (bfd *) ATTRIBUTE_HIDDEN;
327 
328 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
329    file support.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive).  */
330 
331 #define _bfd_noarchive_slurp_armap _bfd_bool_bfd_false_error
332 #define _bfd_noarchive_slurp_extended_name_table _bfd_bool_bfd_false_error
333 extern bfd_boolean _bfd_noarchive_construct_extended_name_table
334   (bfd *, char **, bfd_size_type *, const char **) ATTRIBUTE_HIDDEN;
335 extern void _bfd_noarchive_truncate_arname
336   (bfd *, const char *, char *) ATTRIBUTE_HIDDEN;
337 extern bfd_boolean _bfd_noarchive_write_armap
338   (bfd *, unsigned int, struct orl *, unsigned int, int) ATTRIBUTE_HIDDEN;
339 #define _bfd_noarchive_read_ar_hdr _bfd_ptr_bfd_null_error
340 extern bfd_boolean _bfd_noarchive_write_ar_hdr
341   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
342 extern bfd *
343 _bfd_noarchive_openr_next_archived_file
344   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
345 extern bfd * _bfd_noarchive_get_elt_at_index
346   (bfd *, symindex) ATTRIBUTE_HIDDEN;
347 #define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
348 #define _bfd_noarchive_update_armap_timestamp _bfd_bool_bfd_false_error
349 
350 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
351    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd).  */
352 
353 #define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
354 #define _bfd_archive_bsd_slurp_extended_name_table \
355   _bfd_slurp_extended_name_table
356 extern bfd_boolean _bfd_archive_bsd_construct_extended_name_table
357   (bfd *, char **, bfd_size_type *, const char **) ATTRIBUTE_HIDDEN;
358 #define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
359 #define _bfd_archive_bsd_write_armap _bfd_bsd_write_armap
360 #define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr
361 #define _bfd_archive_bsd_write_ar_hdr _bfd_generic_write_ar_hdr
362 #define _bfd_archive_bsd_openr_next_archived_file \
363   bfd_generic_openr_next_archived_file
364 #define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index
365 #define _bfd_archive_bsd_generic_stat_arch_elt \
366   bfd_generic_stat_arch_elt
367 extern bfd_boolean _bfd_archive_bsd_update_armap_timestamp
368   (bfd *) ATTRIBUTE_HIDDEN;
369 
370 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
371    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff).  */
372 
373 #define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
374 #define _bfd_archive_coff_slurp_extended_name_table \
375   _bfd_slurp_extended_name_table
376 extern bfd_boolean _bfd_archive_coff_construct_extended_name_table
377   (bfd *, char **, bfd_size_type *, const char **) ATTRIBUTE_HIDDEN;
378 #define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
379 #define _bfd_archive_coff_write_armap _bfd_coff_write_armap
380 #define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr
381 #define _bfd_archive_coff_write_ar_hdr _bfd_generic_write_ar_hdr
382 #define _bfd_archive_coff_openr_next_archived_file \
383   bfd_generic_openr_next_archived_file
384 #define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index
385 #define _bfd_archive_coff_generic_stat_arch_elt \
386   bfd_generic_stat_arch_elt
387 #define _bfd_archive_coff_update_armap_timestamp _bfd_bool_bfd_true
388 
389 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD4.4 style
390    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd44).  */
391 
392 #define _bfd_archive_bsd44_slurp_armap bfd_slurp_bsd_armap
393 #define _bfd_archive_bsd44_slurp_extended_name_table \
394   _bfd_slurp_extended_name_table
395 extern bfd_boolean _bfd_archive_bsd44_construct_extended_name_table
396   (bfd *, char **, bfd_size_type *, const char **) ATTRIBUTE_HIDDEN;
397 #define _bfd_archive_bsd44_truncate_arname bfd_bsd_truncate_arname
398 #define _bfd_archive_bsd44_write_armap _bfd_bsd_write_armap
399 #define _bfd_archive_bsd44_read_ar_hdr _bfd_generic_read_ar_hdr
400 #define _bfd_archive_bsd44_write_ar_hdr _bfd_bsd44_write_ar_hdr
401 #define _bfd_archive_bsd44_openr_next_archived_file \
402   bfd_generic_openr_next_archived_file
403 #define _bfd_archive_bsd44_get_elt_at_index _bfd_generic_get_elt_at_index
404 #define _bfd_archive_bsd44_generic_stat_arch_elt \
405   bfd_generic_stat_arch_elt
406 #define _bfd_archive_bsd44_update_armap_timestamp \
407   _bfd_archive_bsd_update_armap_timestamp
408 
409 /* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get VMS style
410    archives.  Use BFD_JUMP_TABLE_ARCHIVE (_bfd_vms_lib).  Some of them
411    are irrelevant.  */
412 
413 extern bfd_boolean _bfd_vms_lib_write_archive_contents
414   (bfd *) ATTRIBUTE_HIDDEN;
415 #define _bfd_vms_lib_slurp_armap _bfd_noarchive_slurp_armap
416 #define _bfd_vms_lib_slurp_extended_name_table \
417   _bfd_noarchive_slurp_extended_name_table
418 #define _bfd_vms_lib_construct_extended_name_table \
419   _bfd_noarchive_construct_extended_name_table
420 #define _bfd_vms_lib_truncate_arname _bfd_noarchive_truncate_arname
421 #define _bfd_vms_lib_write_armap _bfd_noarchive_write_armap
422 #define _bfd_vms_lib_read_ar_hdr _bfd_noarchive_read_ar_hdr
423 #define _bfd_vms_lib_write_ar_hdr _bfd_noarchive_write_ar_hdr
424 extern bfd *_bfd_vms_lib_openr_next_archived_file
425   (bfd *, bfd *) ATTRIBUTE_HIDDEN;
426 extern bfd *_bfd_vms_lib_get_elt_at_index
427   (bfd *, symindex) ATTRIBUTE_HIDDEN;
428 extern int _bfd_vms_lib_generic_stat_arch_elt
429   (bfd *, struct stat *) ATTRIBUTE_HIDDEN;
430 #define _bfd_vms_lib_update_armap_timestamp _bfd_bool_bfd_true
431 
432 /* Extra routines for VMS style archives.  */
433 
434 extern symindex _bfd_vms_lib_find_symbol
435   (bfd *, const char *) ATTRIBUTE_HIDDEN;
436 extern bfd *_bfd_vms_lib_get_imagelib_file
437   (bfd *) ATTRIBUTE_HIDDEN;
438 extern const bfd_target *_bfd_vms_lib_alpha_archive_p
439   (bfd *) ATTRIBUTE_HIDDEN;
440 extern const bfd_target *_bfd_vms_lib_ia64_archive_p
441   (bfd *) ATTRIBUTE_HIDDEN;
442 extern bfd_boolean _bfd_vms_lib_alpha_mkarchive
443   (bfd *) ATTRIBUTE_HIDDEN;
444 extern bfd_boolean _bfd_vms_lib_ia64_mkarchive
445   (bfd *) ATTRIBUTE_HIDDEN;
446 
447 /* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
448    support.  Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols).  */
449 
450 #define _bfd_nosymbols_get_symtab_upper_bound _bfd_long_bfd_n1_error
451 extern long _bfd_nosymbols_canonicalize_symtab
452   (bfd *, asymbol **) ATTRIBUTE_HIDDEN;
453 #define _bfd_nosymbols_make_empty_symbol _bfd_generic_make_empty_symbol
454 extern void _bfd_nosymbols_print_symbol
455   (bfd *, void *, asymbol *, bfd_print_symbol_type) ATTRIBUTE_HIDDEN;
456 extern void _bfd_nosymbols_get_symbol_info
457   (bfd *, asymbol *, symbol_info *) ATTRIBUTE_HIDDEN;
458 extern const char * _bfd_nosymbols_get_symbol_version_string
459   (bfd *, asymbol *, bfd_boolean *) ATTRIBUTE_HIDDEN;
460 extern bfd_boolean _bfd_nosymbols_bfd_is_local_label_name
461   (bfd *, const char *) ATTRIBUTE_HIDDEN;
462 #define _bfd_nosymbols_bfd_is_target_special_symbol _bfd_bool_bfd_asymbol_false
463 extern alent *_bfd_nosymbols_get_lineno
464   (bfd *, asymbol *) ATTRIBUTE_HIDDEN;
465 extern bfd_boolean _bfd_nosymbols_find_nearest_line
466   (bfd *, asymbol **, asection *, bfd_vma,
467    const char **, const char **, unsigned int *, unsigned int *)
468   ATTRIBUTE_HIDDEN;
469 extern bfd_boolean _bfd_nosymbols_find_line
470   (bfd *, asymbol **, asymbol *, const char **, unsigned int *)
471   ATTRIBUTE_HIDDEN;
472 extern bfd_boolean _bfd_nosymbols_find_inliner_info
473   (bfd *, const char **, const char **, unsigned int *) ATTRIBUTE_HIDDEN;
474 extern asymbol *_bfd_nosymbols_bfd_make_debug_symbol
475   (bfd *, void *, unsigned long) ATTRIBUTE_HIDDEN;
476 extern long _bfd_nosymbols_read_minisymbols
477   (bfd *, bfd_boolean, void **, unsigned int *) ATTRIBUTE_HIDDEN;
478 extern asymbol *_bfd_nosymbols_minisymbol_to_symbol
479   (bfd *, bfd_boolean, const void *, asymbol *) ATTRIBUTE_HIDDEN;
480 
481 /* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
482    support.  Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs).  */
483 
484 extern long _bfd_norelocs_get_reloc_upper_bound
485   (bfd *, asection *) ATTRIBUTE_HIDDEN;
486 extern long _bfd_norelocs_canonicalize_reloc
487   (bfd *, asection *, arelent **, asymbol **) ATTRIBUTE_HIDDEN;
488 extern void _bfd_norelocs_set_reloc
489   (bfd *, asection *, arelent **, unsigned int) ATTRIBUTE_HIDDEN;
490 extern reloc_howto_type *_bfd_norelocs_bfd_reloc_type_lookup
491   (bfd *, bfd_reloc_code_real_type) ATTRIBUTE_HIDDEN;
492 extern reloc_howto_type *_bfd_norelocs_bfd_reloc_name_lookup
493   (bfd *, const char *) ATTRIBUTE_HIDDEN;
494 
495 /* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
496    be written.  Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite).  */
497 
498 extern bfd_boolean _bfd_nowrite_set_arch_mach
499   (bfd *, enum bfd_architecture, unsigned long) ATTRIBUTE_HIDDEN;
500 extern bfd_boolean _bfd_nowrite_set_section_contents
501   (bfd *, asection *, const void *, file_ptr, bfd_size_type) ATTRIBUTE_HIDDEN;
502 
503 /* Generic routines to use for BFD_JUMP_TABLE_WRITE.  Use
504    BFD_JUMP_TABLE_WRITE (_bfd_generic).  */
505 
506 #define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
507 extern bfd_boolean _bfd_generic_set_section_contents
508   (bfd *, asection *, const void *, file_ptr, bfd_size_type) ATTRIBUTE_HIDDEN;
509 
510 /* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
511    support linking.  Use BFD_JUMP_TABLE_LINK (_bfd_nolink).  */
512 
513 extern int _bfd_nolink_sizeof_headers
514   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
515 extern bfd_byte *_bfd_nolink_bfd_get_relocated_section_contents
516   (bfd *, struct bfd_link_info *, struct bfd_link_order *,
517    bfd_byte *, bfd_boolean, asymbol **) ATTRIBUTE_HIDDEN;
518 extern bfd_boolean _bfd_nolink_bfd_relax_section
519   (bfd *, asection *, struct bfd_link_info *, bfd_boolean *) ATTRIBUTE_HIDDEN;
520 #define _bfd_nolink_bfd_gc_sections _bfd_bool_bfd_link_false_error
521 extern bfd_boolean _bfd_nolink_bfd_lookup_section_flags
522   (struct bfd_link_info *, struct flag_info *, asection *) ATTRIBUTE_HIDDEN;
523 #define _bfd_nolink_bfd_merge_sections _bfd_bool_bfd_link_false_error
524 extern bfd_boolean _bfd_nolink_bfd_is_group_section
525   (bfd *, const asection *) ATTRIBUTE_HIDDEN;
526 extern const char *_bfd_nolink_bfd_group_name
527   (bfd *, const asection *) ATTRIBUTE_HIDDEN;
528 extern bfd_boolean _bfd_nolink_bfd_discard_group
529   (bfd *, asection *) ATTRIBUTE_HIDDEN;
530 extern struct bfd_link_hash_table *_bfd_nolink_bfd_link_hash_table_create
531   (bfd *) ATTRIBUTE_HIDDEN;
532 #define _bfd_nolink_bfd_link_add_symbols _bfd_bool_bfd_link_false_error
533 extern void _bfd_nolink_bfd_link_just_syms
534   (asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
535 extern void _bfd_nolink_bfd_copy_link_hash_symbol_type
536   (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *)
537   ATTRIBUTE_HIDDEN;
538 #define _bfd_nolink_bfd_final_link _bfd_bool_bfd_link_false_error
539 extern bfd_boolean _bfd_nolink_bfd_link_split_section
540   (bfd *, struct bfd_section *) ATTRIBUTE_HIDDEN;
541 extern bfd_boolean _bfd_nolink_section_already_linked
542   (bfd *, asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
543 extern bfd_boolean _bfd_nolink_bfd_define_common_symbol
544   (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *)
545   ATTRIBUTE_HIDDEN;
546 #define _bfd_nolink_bfd_link_hide_symbol \
547   _bfd_generic_link_hide_symbol
548 extern struct bfd_link_hash_entry *_bfd_nolink_bfd_define_start_stop
549   (struct bfd_link_info *, const char *, asection *) ATTRIBUTE_HIDDEN;
550 #define _bfd_nolink_bfd_link_check_relocs \
551   _bfd_generic_link_check_relocs
552 
553 /* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
554    have dynamic symbols or relocs.  Use BFD_JUMP_TABLE_DYNAMIC
555    (_bfd_nodynamic).  */
556 
557 #define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_long_bfd_n1_error
558 #define _bfd_nodynamic_canonicalize_dynamic_symtab \
559   _bfd_nosymbols_canonicalize_symtab
560 extern long _bfd_nodynamic_get_synthetic_symtab
561   (bfd *, long, asymbol **, long, asymbol **, asymbol **) ATTRIBUTE_HIDDEN;
562 #define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_long_bfd_n1_error
563 extern long _bfd_nodynamic_canonicalize_dynamic_reloc
564   (bfd *, arelent **, asymbol **) ATTRIBUTE_HIDDEN;
565 
566 /* Generic routine to determine of the given symbol is a local
567    label.  */
568 extern bfd_boolean bfd_generic_is_local_label_name
569   (bfd *, const char *) ATTRIBUTE_HIDDEN;
570 
571 /* Generic minisymbol routines.  */
572 extern long _bfd_generic_read_minisymbols
573   (bfd *, bfd_boolean, void **, unsigned int *) ATTRIBUTE_HIDDEN;
574 extern asymbol *_bfd_generic_minisymbol_to_symbol
575   (bfd *, bfd_boolean, const void *, asymbol *) ATTRIBUTE_HIDDEN;
576 
577 /* Find the nearest line using .stab/.stabstr sections.  */
578 extern bfd_boolean _bfd_stab_section_find_nearest_line
579   (bfd *, asymbol **, asection *, bfd_vma, bfd_boolean *,
580    const char **, const char **, unsigned int *, void **) ATTRIBUTE_HIDDEN;
581 
582 /* Find the nearest line using DWARF 1 debugging information.  */
583 extern bfd_boolean _bfd_dwarf1_find_nearest_line
584   (bfd *, asymbol **, asection *, bfd_vma,
585    const char **, const char **, unsigned int *) ATTRIBUTE_HIDDEN;
586 
587 struct dwarf_debug_section
588 {
589   const char * uncompressed_name;
590   const char * compressed_name;
591 };
592 
593 /* Map of uncompressed DWARF debug section name to compressed one.  It
594    is terminated by NULL uncompressed_name.  */
595 
596 extern const struct dwarf_debug_section dwarf_debug_sections[] ATTRIBUTE_HIDDEN;
597 
598 /* Find the nearest line using DWARF 2 debugging information.  */
599 extern int _bfd_dwarf2_find_nearest_line
600   (bfd *, asymbol **, asymbol *, asection *, bfd_vma,
601    const char **, const char **, unsigned int *, unsigned int *,
602    const struct dwarf_debug_section *, void **) ATTRIBUTE_HIDDEN;
603 
604 /* Find the bias between DWARF addresses and real addresses.  */
605 extern bfd_signed_vma _bfd_dwarf2_find_symbol_bias
606   (asymbol **, void **) ATTRIBUTE_HIDDEN;
607 
608 /* Find inliner info after calling bfd_find_nearest_line. */
609 extern bfd_boolean _bfd_dwarf2_find_inliner_info
610   (bfd *, const char **, const char **, unsigned int *, void **)
611   ATTRIBUTE_HIDDEN;
612 
613 /* Read DWARF 2 debugging information. */
614 extern bfd_boolean _bfd_dwarf2_slurp_debug_info
615   (bfd *, bfd *, const struct dwarf_debug_section *, asymbol **, void **,
616    bfd_boolean) ATTRIBUTE_HIDDEN;
617 
618 /* Clean up the data used to handle DWARF 2 debugging information. */
619 extern void _bfd_dwarf2_cleanup_debug_info
620   (bfd *, void **) ATTRIBUTE_HIDDEN;
621 
622 /* Create a new section entry.  */
623 extern struct bfd_hash_entry *bfd_section_hash_newfunc
624   (struct bfd_hash_entry *, struct bfd_hash_table *, const char *)
625   ATTRIBUTE_HIDDEN;
626 
627 /* A routine to create entries for a bfd_link_hash_table.  */
628 extern struct bfd_hash_entry *_bfd_link_hash_newfunc
629   (struct bfd_hash_entry *entry, struct bfd_hash_table *table,
630    const char *string) ATTRIBUTE_HIDDEN;
631 
632 /* Initialize a bfd_link_hash_table.  */
633 extern bfd_boolean _bfd_link_hash_table_init
634   (struct bfd_link_hash_table *, bfd *,
635    struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
636 			       struct bfd_hash_table *,
637 			       const char *),
638    unsigned int) ATTRIBUTE_HIDDEN;
639 
640 /* Generic link hash table creation routine.  */
641 extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
642   (bfd *) ATTRIBUTE_HIDDEN;
643 
644 /* Generic link hash table destruction routine.  */
645 extern void _bfd_generic_link_hash_table_free
646   (bfd *) ATTRIBUTE_HIDDEN;
647 
648 /* Generic add symbol routine.  */
649 extern bfd_boolean _bfd_generic_link_add_symbols
650   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
651 
652 /* Generic archive add symbol routine.  */
653 extern bfd_boolean _bfd_generic_link_add_archive_symbols
654   (bfd *, struct bfd_link_info *,
655    bfd_boolean (*) (bfd *, struct bfd_link_info *,
656 		    struct bfd_link_hash_entry *, const char *,
657 		    bfd_boolean *)) ATTRIBUTE_HIDDEN;
658 
659 /* Forward declaration to avoid prototype errors.  */
660 typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
661 
662 /* Generic routine to add a single symbol.  */
663 extern bfd_boolean _bfd_generic_link_add_one_symbol
664   (struct bfd_link_info *, bfd *, const char *name, flagword,
665    asection *, bfd_vma, const char *, bfd_boolean copy,
666    bfd_boolean constructor, struct bfd_link_hash_entry **) ATTRIBUTE_HIDDEN;
667 
668 /* Generic routine to mark section as supplying symbols only.  */
669 extern void _bfd_generic_link_just_syms
670   (asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
671 
672 /* Generic routine that does nothing.  */
673 extern void _bfd_generic_copy_link_hash_symbol_type
674   (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *)
675   ATTRIBUTE_HIDDEN;
676 
677 /* Generic link routine.  */
678 extern bfd_boolean _bfd_generic_final_link
679   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
680 
681 extern bfd_boolean _bfd_generic_link_split_section
682   (bfd *, struct bfd_section *) ATTRIBUTE_HIDDEN;
683 
684 extern bfd_boolean _bfd_generic_section_already_linked
685   (bfd *, asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
686 
687 /* Generic reloc_link_order processing routine.  */
688 extern bfd_boolean _bfd_generic_reloc_link_order
689   (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *)
690   ATTRIBUTE_HIDDEN;
691 
692 /* Default link order processing routine.  */
693 extern bfd_boolean _bfd_default_link_order
694   (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *)
695   ATTRIBUTE_HIDDEN;
696 
697 /* Count the number of reloc entries in a link order list.  */
698 extern unsigned int _bfd_count_link_order_relocs
699   (struct bfd_link_order *) ATTRIBUTE_HIDDEN;
700 
701 /* Final link relocation routine.  */
702 extern bfd_reloc_status_type _bfd_final_link_relocate
703   (reloc_howto_type *, bfd *, asection *, bfd_byte *,
704    bfd_vma, bfd_vma, bfd_vma) ATTRIBUTE_HIDDEN;
705 
706 /* Relocate a particular location by a howto and a value.  */
707 extern bfd_reloc_status_type _bfd_relocate_contents
708   (reloc_howto_type *, bfd *, bfd_vma, bfd_byte *) ATTRIBUTE_HIDDEN;
709 
710 /* Clear a given location using a given howto.  */
711 extern bfd_reloc_status_type _bfd_clear_contents
712   (reloc_howto_type *, bfd *, asection *, bfd_byte *, bfd_vma) ATTRIBUTE_HIDDEN;
713 
714 /* Link stabs in sections in the first pass.  */
715 
716 extern bfd_boolean _bfd_link_section_stabs
717   (bfd *, struct stab_info *, asection *, asection *, void **,
718    bfd_size_type *) ATTRIBUTE_HIDDEN;
719 
720 /* Eliminate stabs for discarded functions and symbols.  */
721 extern bfd_boolean _bfd_discard_section_stabs
722   (bfd *, asection *, void *, bfd_boolean (*) (bfd_vma, void *), void *)
723   ATTRIBUTE_HIDDEN;
724 
725 /* Write out the .stab section when linking stabs in sections.  */
726 
727 extern bfd_boolean _bfd_write_section_stabs
728   (bfd *, struct stab_info *, asection *, void **, bfd_byte *)
729   ATTRIBUTE_HIDDEN;
730 
731 /* Write out the .stabstr string table when linking stabs in sections.  */
732 
733 extern bfd_boolean _bfd_write_stab_strings
734   (bfd *, struct stab_info *) ATTRIBUTE_HIDDEN;
735 
736 /* Find an offset within a .stab section when linking stabs in
737    sections.  */
738 
739 extern bfd_vma _bfd_stab_section_offset
740   (asection *, void *, bfd_vma) ATTRIBUTE_HIDDEN;
741 
742 /* Register a SEC_MERGE section as a candidate for merging.  */
743 
744 extern bfd_boolean _bfd_add_merge_section
745   (bfd *, void **, asection *, void **) ATTRIBUTE_HIDDEN;
746 
747 /* Attempt to merge SEC_MERGE sections.  */
748 
749 extern bfd_boolean _bfd_merge_sections
750   (bfd *, struct bfd_link_info *, void *, void (*) (bfd *, asection *))
751   ATTRIBUTE_HIDDEN;
752 
753 /* Write out a merged section.  */
754 
755 extern bfd_boolean _bfd_write_merged_section
756   (bfd *, asection *, void *) ATTRIBUTE_HIDDEN;
757 
758 /* Find an offset within a modified SEC_MERGE section.  */
759 
760 extern bfd_vma _bfd_merged_section_offset
761   (bfd *, asection **, void *, bfd_vma) ATTRIBUTE_HIDDEN;
762 
763 /* Tidy up when done.  */
764 
765 extern void _bfd_merge_sections_free (void *) ATTRIBUTE_HIDDEN;
766 
767 /* Create a string table.  */
768 extern struct bfd_strtab_hash *_bfd_stringtab_init
769   (void) ATTRIBUTE_HIDDEN;
770 
771 /* Create an XCOFF .debug section style string table.  */
772 extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init
773   (void) ATTRIBUTE_HIDDEN;
774 
775 /* Free a string table.  */
776 extern void _bfd_stringtab_free
777   (struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
778 
779 /* Get the size of a string table.  */
780 extern bfd_size_type _bfd_stringtab_size
781   (struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
782 
783 /* Add a string to a string table.  */
784 extern bfd_size_type _bfd_stringtab_add
785   (struct bfd_strtab_hash *, const char *, bfd_boolean hash, bfd_boolean copy)
786   ATTRIBUTE_HIDDEN;
787 
788 /* Write out a string table.  */
789 extern bfd_boolean _bfd_stringtab_emit
790   (bfd *, struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
791 
792 /* Macros to tell if bfds are read or write enabled.
793 
794    Note that bfds open for read may be scribbled into if the fd passed
795    to bfd_fdopenr is actually open both for read and write
796    simultaneously.  However an output bfd will never be open for
797    read.  Therefore sometimes you want to check bfd_read_p or
798    !bfd_read_p, and only sometimes bfd_write_p.
799 */
800 
801 #define	bfd_read_p(abfd) \
802   ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
803 #define	bfd_write_p(abfd) \
804   ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
805 
806 extern void bfd_assert
807   (const char*,int) ATTRIBUTE_HIDDEN;
808 
809 #define BFD_ASSERT(x) \
810   do { if (!(x)) bfd_assert(__FILE__,__LINE__); } while (0)
811 
812 #define BFD_FAIL() \
813   do { bfd_assert(__FILE__,__LINE__); } while (0)
814 
815 extern void _bfd_abort
816   (const char *, int, const char *) ATTRIBUTE_NORETURN ATTRIBUTE_HIDDEN;
817 
818 /* if gcc >= 2.6, we can give a function name, too */
819 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
820 #define __PRETTY_FUNCTION__  ((char *) NULL)
821 #endif
822 
823 #undef abort
824 #define abort() _bfd_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
825 
826 /* Manipulate a system FILE but using BFD's "file_ptr", rather than
827    the system "off_t" or "off64_t", as the offset.  */
828 extern file_ptr _bfd_real_ftell
829   (FILE *) ATTRIBUTE_HIDDEN;
830 extern int _bfd_real_fseek
831   (FILE *, file_ptr, int) ATTRIBUTE_HIDDEN;
832 extern FILE *_bfd_real_fopen
833   (const char *, const char *) ATTRIBUTE_HIDDEN;
834 
835 /* List of supported target vectors, and the default vector (if
836    bfd_default_vector[0] is NULL, there is no default).  */
837 extern const bfd_target * const *bfd_target_vector ATTRIBUTE_HIDDEN;
838 extern const bfd_target *bfd_default_vector[] ATTRIBUTE_HIDDEN;
839 
840 /* List of associated target vectors.  */
841 extern const bfd_target * const *bfd_associated_vector ATTRIBUTE_HIDDEN;
842 
843 /* Functions shared by the ECOFF and MIPS ELF backends, which have no
844    other common header files.  */
845 
846 #if defined(__STDC__) || defined(ALMOST_STDC)
847 struct ecoff_find_line;
848 #endif
849 
850 extern bfd_boolean _bfd_ecoff_locate_line
851   (bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
852    const struct ecoff_debug_swap * const, struct ecoff_find_line *,
853    const char **, const char **, unsigned int *) ATTRIBUTE_HIDDEN;
854 extern bfd_boolean _bfd_ecoff_get_accumulated_pdr
855   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
856 extern bfd_boolean _bfd_ecoff_get_accumulated_sym
857   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
858 extern bfd_boolean _bfd_ecoff_get_accumulated_ss
859   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
860 
861 extern bfd_vma _bfd_get_gp_value
862   (bfd *) ATTRIBUTE_HIDDEN;
863 extern void _bfd_set_gp_value
864   (bfd *, bfd_vma) ATTRIBUTE_HIDDEN;
865 
866 /* Function shared by the COFF and ELF SH backends, which have no
867    other common header files.  */
868 
869 #ifndef _bfd_sh_align_load_span
870 extern bfd_boolean _bfd_sh_align_load_span
871   (bfd *, asection *, bfd_byte *,
872    bfd_boolean (*) (bfd *, asection *, void *, bfd_byte *, bfd_vma),
873    void *, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, bfd_boolean *) ATTRIBUTE_HIDDEN;
874 #endif
875 
876 /* This is the shape of the elements inside the already_linked hash
877    table. It maps a name onto a list of already_linked elements with
878    the same name.  */
879 
880 struct bfd_section_already_linked_hash_entry
881 {
882   struct bfd_hash_entry root;
883   struct bfd_section_already_linked *entry;
884 };
885 
886 struct bfd_section_already_linked
887 {
888   struct bfd_section_already_linked *next;
889   asection *sec;
890 };
891 
892 extern struct bfd_section_already_linked_hash_entry *
893   bfd_section_already_linked_table_lookup (const char *) ATTRIBUTE_HIDDEN;
894 extern bfd_boolean bfd_section_already_linked_table_insert
895   (struct bfd_section_already_linked_hash_entry *, asection *)
896   ATTRIBUTE_HIDDEN;
897 extern void bfd_section_already_linked_table_traverse
898   (bfd_boolean (*) (struct bfd_section_already_linked_hash_entry *,
899 		    void *), void *) ATTRIBUTE_HIDDEN;
900 
901 extern bfd_vma _bfd_read_unsigned_leb128
902   (bfd *, bfd_byte *, unsigned int *) ATTRIBUTE_HIDDEN;
903 extern bfd_signed_vma _bfd_read_signed_leb128
904   (bfd *, bfd_byte *, unsigned int *) ATTRIBUTE_HIDDEN;
905 extern bfd_vma _bfd_safe_read_leb128
906   (bfd *, bfd_byte *, unsigned int *, bfd_boolean, const bfd_byte * const)
907   ATTRIBUTE_HIDDEN;
908