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