packaging: Enable testing infrastructure
[external/binutils.git] / bfd / libbfd-in.h
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-2019 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 \f
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 bfd_boolean _bfd_nolink_bfd_discard_group
527   (bfd *, asection *) ATTRIBUTE_HIDDEN;
528 extern struct bfd_link_hash_table *_bfd_nolink_bfd_link_hash_table_create
529   (bfd *) ATTRIBUTE_HIDDEN;
530 #define _bfd_nolink_bfd_link_add_symbols _bfd_bool_bfd_link_false_error
531 extern void _bfd_nolink_bfd_link_just_syms
532   (asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
533 extern void _bfd_nolink_bfd_copy_link_hash_symbol_type
534   (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *)
535   ATTRIBUTE_HIDDEN;
536 #define _bfd_nolink_bfd_final_link _bfd_bool_bfd_link_false_error
537 extern bfd_boolean _bfd_nolink_bfd_link_split_section
538   (bfd *, struct bfd_section *) ATTRIBUTE_HIDDEN;
539 extern bfd_boolean _bfd_nolink_section_already_linked
540   (bfd *, asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
541 extern bfd_boolean _bfd_nolink_bfd_define_common_symbol
542   (bfd *, struct bfd_link_info *, struct bfd_link_hash_entry *)
543   ATTRIBUTE_HIDDEN;
544 #define _bfd_nolink_bfd_link_hide_symbol \
545   _bfd_generic_link_hide_symbol
546 extern struct bfd_link_hash_entry *_bfd_nolink_bfd_define_start_stop
547   (struct bfd_link_info *, const char *, asection *) ATTRIBUTE_HIDDEN;
548 #define _bfd_nolink_bfd_link_check_relocs \
549   _bfd_generic_link_check_relocs
550
551 /* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
552    have dynamic symbols or relocs.  Use BFD_JUMP_TABLE_DYNAMIC
553    (_bfd_nodynamic).  */
554
555 #define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_long_bfd_n1_error
556 #define _bfd_nodynamic_canonicalize_dynamic_symtab \
557   _bfd_nosymbols_canonicalize_symtab
558 extern long _bfd_nodynamic_get_synthetic_symtab
559   (bfd *, long, asymbol **, long, asymbol **, asymbol **) ATTRIBUTE_HIDDEN;
560 #define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_long_bfd_n1_error
561 extern long _bfd_nodynamic_canonicalize_dynamic_reloc
562   (bfd *, arelent **, asymbol **) ATTRIBUTE_HIDDEN;
563 \f
564 /* Generic routine to determine of the given symbol is a local
565    label.  */
566 extern bfd_boolean bfd_generic_is_local_label_name
567   (bfd *, const char *) ATTRIBUTE_HIDDEN;
568
569 /* Generic minisymbol routines.  */
570 extern long _bfd_generic_read_minisymbols
571   (bfd *, bfd_boolean, void **, unsigned int *) ATTRIBUTE_HIDDEN;
572 extern asymbol *_bfd_generic_minisymbol_to_symbol
573   (bfd *, bfd_boolean, const void *, asymbol *) ATTRIBUTE_HIDDEN;
574
575 /* Find the nearest line using .stab/.stabstr sections.  */
576 extern bfd_boolean _bfd_stab_section_find_nearest_line
577   (bfd *, asymbol **, asection *, bfd_vma, bfd_boolean *,
578    const char **, const char **, unsigned int *, void **) ATTRIBUTE_HIDDEN;
579
580 /* Find the nearest line using DWARF 1 debugging information.  */
581 extern bfd_boolean _bfd_dwarf1_find_nearest_line
582   (bfd *, asymbol **, asection *, bfd_vma,
583    const char **, const char **, unsigned int *) ATTRIBUTE_HIDDEN;
584
585 struct dwarf_debug_section
586 {
587   const char * uncompressed_name;
588   const char * compressed_name;
589 };
590
591 /* Map of uncompressed DWARF debug section name to compressed one.  It
592    is terminated by NULL uncompressed_name.  */
593
594 extern const struct dwarf_debug_section dwarf_debug_sections[] ATTRIBUTE_HIDDEN;
595
596 /* Find the nearest line using DWARF 2 debugging information.  */
597 extern bfd_boolean _bfd_dwarf2_find_nearest_line
598   (bfd *, asymbol **, asymbol *, asection *, bfd_vma,
599    const char **, const char **, unsigned int *, unsigned int *,
600    const struct dwarf_debug_section *, void **) ATTRIBUTE_HIDDEN;
601
602 /* Find the bias between DWARF addresses and real addresses.  */
603 extern bfd_signed_vma _bfd_dwarf2_find_symbol_bias
604   (asymbol **, void **) ATTRIBUTE_HIDDEN;
605
606 /* Find inliner info after calling bfd_find_nearest_line. */
607 extern bfd_boolean _bfd_dwarf2_find_inliner_info
608   (bfd *, const char **, const char **, unsigned int *, void **)
609   ATTRIBUTE_HIDDEN;
610
611 /* Read DWARF 2 debugging information. */
612 extern bfd_boolean _bfd_dwarf2_slurp_debug_info
613   (bfd *, bfd *, const struct dwarf_debug_section *, asymbol **, void **,
614    bfd_boolean) ATTRIBUTE_HIDDEN;
615
616 /* Clean up the data used to handle DWARF 2 debugging information. */
617 extern void _bfd_dwarf2_cleanup_debug_info
618   (bfd *, void **) ATTRIBUTE_HIDDEN;
619
620 /* Create a new section entry.  */
621 extern struct bfd_hash_entry *bfd_section_hash_newfunc
622   (struct bfd_hash_entry *, struct bfd_hash_table *, const char *)
623   ATTRIBUTE_HIDDEN;
624
625 /* A routine to create entries for a bfd_link_hash_table.  */
626 extern struct bfd_hash_entry *_bfd_link_hash_newfunc
627   (struct bfd_hash_entry *entry, struct bfd_hash_table *table,
628    const char *string) ATTRIBUTE_HIDDEN;
629
630 /* Initialize a bfd_link_hash_table.  */
631 extern bfd_boolean _bfd_link_hash_table_init
632   (struct bfd_link_hash_table *, bfd *,
633    struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
634                                struct bfd_hash_table *,
635                                const char *),
636    unsigned int) ATTRIBUTE_HIDDEN;
637
638 /* Generic link hash table creation routine.  */
639 extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
640   (bfd *) ATTRIBUTE_HIDDEN;
641
642 /* Generic link hash table destruction routine.  */
643 extern void _bfd_generic_link_hash_table_free
644   (bfd *) ATTRIBUTE_HIDDEN;
645
646 /* Generic add symbol routine.  */
647 extern bfd_boolean _bfd_generic_link_add_symbols
648   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
649
650 /* Generic archive add symbol routine.  */
651 extern bfd_boolean _bfd_generic_link_add_archive_symbols
652   (bfd *, struct bfd_link_info *,
653    bfd_boolean (*) (bfd *, struct bfd_link_info *,
654                     struct bfd_link_hash_entry *, const char *,
655                     bfd_boolean *)) ATTRIBUTE_HIDDEN;
656
657 /* Forward declaration to avoid prototype errors.  */
658 typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
659
660 /* Generic routine to add a single symbol.  */
661 extern bfd_boolean _bfd_generic_link_add_one_symbol
662   (struct bfd_link_info *, bfd *, const char *name, flagword,
663    asection *, bfd_vma, const char *, bfd_boolean copy,
664    bfd_boolean constructor, struct bfd_link_hash_entry **) ATTRIBUTE_HIDDEN;
665
666 /* Generic routine to mark section as supplying symbols only.  */
667 extern void _bfd_generic_link_just_syms
668   (asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
669
670 /* Generic routine that does nothing.  */
671 extern void _bfd_generic_copy_link_hash_symbol_type
672   (bfd *, struct bfd_link_hash_entry *, struct bfd_link_hash_entry *)
673   ATTRIBUTE_HIDDEN;
674
675 /* Generic link routine.  */
676 extern bfd_boolean _bfd_generic_final_link
677   (bfd *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
678
679 extern bfd_boolean _bfd_generic_link_split_section
680   (bfd *, struct bfd_section *) ATTRIBUTE_HIDDEN;
681
682 extern bfd_boolean _bfd_generic_section_already_linked
683   (bfd *, asection *, struct bfd_link_info *) ATTRIBUTE_HIDDEN;
684
685 /* Generic reloc_link_order processing routine.  */
686 extern bfd_boolean _bfd_generic_reloc_link_order
687   (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *)
688   ATTRIBUTE_HIDDEN;
689
690 /* Default link order processing routine.  */
691 extern bfd_boolean _bfd_default_link_order
692   (bfd *, struct bfd_link_info *, asection *, struct bfd_link_order *)
693   ATTRIBUTE_HIDDEN;
694
695 /* Count the number of reloc entries in a link order list.  */
696 extern unsigned int _bfd_count_link_order_relocs
697   (struct bfd_link_order *) ATTRIBUTE_HIDDEN;
698
699 /* Final link relocation routine.  */
700 extern bfd_reloc_status_type _bfd_final_link_relocate
701   (reloc_howto_type *, bfd *, asection *, bfd_byte *,
702    bfd_vma, bfd_vma, bfd_vma) ATTRIBUTE_HIDDEN;
703
704 /* Relocate a particular location by a howto and a value.  */
705 extern bfd_reloc_status_type _bfd_relocate_contents
706   (reloc_howto_type *, bfd *, bfd_vma, bfd_byte *) ATTRIBUTE_HIDDEN;
707
708 /* Clear a given location using a given howto.  */
709 extern bfd_reloc_status_type _bfd_clear_contents
710   (reloc_howto_type *, bfd *, asection *, bfd_byte *, bfd_vma) ATTRIBUTE_HIDDEN;
711
712 /* Link stabs in sections in the first pass.  */
713
714 extern bfd_boolean _bfd_link_section_stabs
715   (bfd *, struct stab_info *, asection *, asection *, void **,
716    bfd_size_type *) ATTRIBUTE_HIDDEN;
717
718 /* Eliminate stabs for discarded functions and symbols.  */
719 extern bfd_boolean _bfd_discard_section_stabs
720   (bfd *, asection *, void *, bfd_boolean (*) (bfd_vma, void *), void *)
721   ATTRIBUTE_HIDDEN;
722
723 /* Write out the .stab section when linking stabs in sections.  */
724
725 extern bfd_boolean _bfd_write_section_stabs
726   (bfd *, struct stab_info *, asection *, void **, bfd_byte *)
727   ATTRIBUTE_HIDDEN;
728
729 /* Write out the .stabstr string table when linking stabs in sections.  */
730
731 extern bfd_boolean _bfd_write_stab_strings
732   (bfd *, struct stab_info *) ATTRIBUTE_HIDDEN;
733
734 /* Find an offset within a .stab section when linking stabs in
735    sections.  */
736
737 extern bfd_vma _bfd_stab_section_offset
738   (asection *, void *, bfd_vma) ATTRIBUTE_HIDDEN;
739
740 /* Register a SEC_MERGE section as a candidate for merging.  */
741
742 extern bfd_boolean _bfd_add_merge_section
743   (bfd *, void **, asection *, void **) ATTRIBUTE_HIDDEN;
744
745 /* Attempt to merge SEC_MERGE sections.  */
746
747 extern bfd_boolean _bfd_merge_sections
748   (bfd *, struct bfd_link_info *, void *, void (*) (bfd *, asection *))
749   ATTRIBUTE_HIDDEN;
750
751 /* Write out a merged section.  */
752
753 extern bfd_boolean _bfd_write_merged_section
754   (bfd *, asection *, void *) ATTRIBUTE_HIDDEN;
755
756 /* Find an offset within a modified SEC_MERGE section.  */
757
758 extern bfd_vma _bfd_merged_section_offset
759   (bfd *, asection **, void *, bfd_vma) ATTRIBUTE_HIDDEN;
760
761 /* Tidy up when done.  */
762
763 extern void _bfd_merge_sections_free (void *) ATTRIBUTE_HIDDEN;
764
765 /* Create a string table.  */
766 extern struct bfd_strtab_hash *_bfd_stringtab_init
767   (void) ATTRIBUTE_HIDDEN;
768
769 /* Create an XCOFF .debug section style string table.  */
770 extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init
771   (void) ATTRIBUTE_HIDDEN;
772
773 /* Free a string table.  */
774 extern void _bfd_stringtab_free
775   (struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
776
777 /* Get the size of a string table.  */
778 extern bfd_size_type _bfd_stringtab_size
779   (struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
780
781 /* Add a string to a string table.  */
782 extern bfd_size_type _bfd_stringtab_add
783   (struct bfd_strtab_hash *, const char *, bfd_boolean hash, bfd_boolean copy)
784   ATTRIBUTE_HIDDEN;
785
786 /* Write out a string table.  */
787 extern bfd_boolean _bfd_stringtab_emit
788   (bfd *, struct bfd_strtab_hash *) ATTRIBUTE_HIDDEN;
789 \f
790 /* Macros to tell if bfds are read or write enabled.
791
792    Note that bfds open for read may be scribbled into if the fd passed
793    to bfd_fdopenr is actually open both for read and write
794    simultaneously.  However an output bfd will never be open for
795    read.  Therefore sometimes you want to check bfd_read_p or
796    !bfd_read_p, and only sometimes bfd_write_p.
797 */
798
799 #define bfd_read_p(abfd) \
800   ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
801 #define bfd_write_p(abfd) \
802   ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
803
804 extern void bfd_assert
805   (const char*,int) ATTRIBUTE_HIDDEN;
806
807 #define BFD_ASSERT(x) \
808   do { if (!(x)) bfd_assert(__FILE__,__LINE__); } while (0)
809
810 #define BFD_FAIL() \
811   do { bfd_assert(__FILE__,__LINE__); } while (0)
812
813 extern void _bfd_abort
814   (const char *, int, const char *) ATTRIBUTE_NORETURN ATTRIBUTE_HIDDEN;
815
816 /* if gcc >= 2.6, we can give a function name, too */
817 #if __GNUC__ < 2 || (__GNUC__ == 2 && __GNUC_MINOR__ < 6)
818 #define __PRETTY_FUNCTION__  ((char *) NULL)
819 #endif
820
821 #undef abort
822 #define abort() _bfd_abort (__FILE__, __LINE__, __PRETTY_FUNCTION__)
823
824 /* Manipulate a system FILE but using BFD's "file_ptr", rather than
825    the system "off_t" or "off64_t", as the offset.  */
826 extern file_ptr _bfd_real_ftell
827   (FILE *) ATTRIBUTE_HIDDEN;
828 extern int _bfd_real_fseek
829   (FILE *, file_ptr, int) ATTRIBUTE_HIDDEN;
830 extern FILE *_bfd_real_fopen
831   (const char *, const char *) ATTRIBUTE_HIDDEN;
832
833 /* List of supported target vectors, and the default vector (if
834    bfd_default_vector[0] is NULL, there is no default).  */
835 extern const bfd_target * const *bfd_target_vector ATTRIBUTE_HIDDEN;
836 extern const bfd_target *bfd_default_vector[] ATTRIBUTE_HIDDEN;
837
838 /* List of associated target vectors.  */
839 extern const bfd_target * const *bfd_associated_vector ATTRIBUTE_HIDDEN;
840
841 /* Functions shared by the ECOFF and MIPS ELF backends, which have no
842    other common header files.  */
843
844 #if defined(__STDC__) || defined(ALMOST_STDC)
845 struct ecoff_find_line;
846 #endif
847
848 extern bfd_boolean _bfd_ecoff_locate_line
849   (bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
850    const struct ecoff_debug_swap * const, struct ecoff_find_line *,
851    const char **, const char **, unsigned int *) ATTRIBUTE_HIDDEN;
852 extern bfd_boolean _bfd_ecoff_get_accumulated_pdr
853   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
854 extern bfd_boolean _bfd_ecoff_get_accumulated_sym
855   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
856 extern bfd_boolean _bfd_ecoff_get_accumulated_ss
857   (void *, bfd_byte *) ATTRIBUTE_HIDDEN;
858
859 extern bfd_vma _bfd_get_gp_value
860   (bfd *) ATTRIBUTE_HIDDEN;
861 extern void _bfd_set_gp_value
862   (bfd *, bfd_vma) ATTRIBUTE_HIDDEN;
863
864 /* Function shared by the COFF and ELF SH backends, which have no
865    other common header files.  */
866
867 #ifndef _bfd_sh_align_load_span
868 extern bfd_boolean _bfd_sh_align_load_span
869   (bfd *, asection *, bfd_byte *,
870    bfd_boolean (*) (bfd *, asection *, void *, bfd_byte *, bfd_vma),
871    void *, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, bfd_boolean *) ATTRIBUTE_HIDDEN;
872 #endif
873
874 /* This is the shape of the elements inside the already_linked hash
875    table. It maps a name onto a list of already_linked elements with
876    the same name.  */
877
878 struct bfd_section_already_linked_hash_entry
879 {
880   struct bfd_hash_entry root;
881   struct bfd_section_already_linked *entry;
882 };
883
884 struct bfd_section_already_linked
885 {
886   struct bfd_section_already_linked *next;
887   asection *sec;
888 };
889
890 extern struct bfd_section_already_linked_hash_entry *
891   bfd_section_already_linked_table_lookup (const char *) ATTRIBUTE_HIDDEN;
892 extern bfd_boolean bfd_section_already_linked_table_insert
893   (struct bfd_section_already_linked_hash_entry *, asection *)
894   ATTRIBUTE_HIDDEN;
895 extern void bfd_section_already_linked_table_traverse
896   (bfd_boolean (*) (struct bfd_section_already_linked_hash_entry *,
897                     void *), void *) ATTRIBUTE_HIDDEN;
898
899 extern bfd_vma _bfd_read_unsigned_leb128
900   (bfd *, bfd_byte *, unsigned int *) ATTRIBUTE_HIDDEN;
901 extern bfd_signed_vma _bfd_read_signed_leb128
902   (bfd *, bfd_byte *, unsigned int *) ATTRIBUTE_HIDDEN;
903 extern bfd_vma _bfd_safe_read_leb128
904   (bfd *, bfd_byte *, unsigned int *, bfd_boolean, const bfd_byte * const)
905   ATTRIBUTE_HIDDEN;