tipo
[deliverable/binutils-gdb.git] / bfd / libbfd-in.h
CommitLineData
4e6f9223
SC
1/* libbfd.h -- Declarations used by bfd library *implementation*.
2 (This include file is not for users of the library.)
53d3ce37 3 Copyright 1990, 91, 92, 93, 94, 95, 96, 97, 1998 Free Software Foundation, Inc.
4e6f9223
SC
4 Written by Cygnus Support.
5
e914ed52
ILT
6** NOTE: libbfd.h is a GENERATED file. Don't change it; instead,
7** change libbfd-in.h or the other BFD source files processed to
8** generate this file.
9
4e6f9223
SC
10This file is part of BFD, the Binary File Descriptor library.
11
12This program is free software; you can redistribute it and/or modify
13it under the terms of the GNU General Public License as published by
14the Free Software Foundation; either version 2 of the License, or
15(at your option) any later version.
16
17This program is distributed in the hope that it will be useful,
18but WITHOUT ANY WARRANTY; without even the implied warranty of
19MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20GNU General Public License for more details.
21
22You should have received a copy of the GNU General Public License
23along with this program; if not, write to the Free Software
4e98461f 24Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
4e6f9223 25
53d3ce37
TT
26#ifdef ENABLE_NLS
27#include <libintl.h>
28#define _(String) dgettext (PACKAGE, String)
29#ifdef gettext_noop
30#define N_(String) gettext_noop (String)
31#else
32#define N_(String) (String)
33#endif
34#else
35/* Stubs that do something close enough. */
36#define textdomain(String) (String)
37#define gettext(String) (String)
38#define dgettext(Domain,Message) (Message)
39#define dcgettext(Domain,Message,Type) (Message)
40#define bindtextdomain(Domain,Directory) (Domain)
41#define _(String) (String)
42#define N_(String) (String)
43/* In this case we don't care about the value. */
44#ifndef LC_MESSAGES
45#define LC_MESSAGES 0
46#endif
47#endif
48
01dd1b2b 49/* Align an address upward to a boundary, expressed as a number of bytes.
53d3ce37
TT
50 E.g. align to an 8-byte boundary with argument of 8. Take care never
51 to wrap around if the address is within boundary-1 of the end of the
52 address space. */
53#define BFD_ALIGN(this, boundary) \
54 ((((bfd_vma) (this) + (boundary) - 1) >= (bfd_vma) (this)) \
55 ? (((bfd_vma) (this) + ((boundary) - 1)) & (~((boundary)-1))) \
56 : ~ (bfd_vma) 0)
01dd1b2b 57
4e6f9223
SC
58/* If you want to read and write large blocks, you might want to do it
59 in quanta of this amount */
60#define DEFAULT_BUFFERSIZE 8192
61
62/* Set a tdata field. Can't use the other macros for this, since they
63 do casts, and casting to the left of assignment isn't portable. */
14e3c2e4 64#define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
4e6f9223 65
64d5f5d0
ILT
66/* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points
67 to an instance of this structure. */
68
69struct bfd_in_memory
70{
71 /* Size of buffer. */
72 bfd_size_type size;
73 /* Buffer holding contents of BFD. */
74 bfd_byte *buffer;
75};
76
4e6f9223
SC
77/* tdata for an archive. For an input archive, cache
78 needs to be free()'d. For an output archive, symdefs do. */
79
80struct artdata {
81 file_ptr first_file_filepos;
82 /* Speed up searching the armap */
83 struct ar_cache *cache;
84 bfd *archive_head; /* Only interesting in output routines */
85 carsym *symdefs; /* the symdef entries */
86 symindex symdef_count; /* how many there are */
87 char *extended_names; /* clever intel extension */
4c3721d5
ILT
88 /* when more compilers are standard C, this can be a time_t */
89 long armap_timestamp; /* Timestamp value written into armap.
a6f5fcd8
SC
90 This is used for BSD archives to check
91 that the timestamp is recent enough
92 for the BSD linker to not complain,
93 just before we finish writing an
94 archive. */
95 file_ptr armap_datepos; /* Position within archive to seek to
96 rewrite the date field. */
b59f0276 97 PTR tdata; /* Backend specific information. */
4e6f9223
SC
98};
99
14e3c2e4 100#define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
4e6f9223
SC
101
102/* Goes in bfd's arelt_data slot */
103struct areltdata {
104 char * arch_header; /* it's actually a string */
105 unsigned int parsed_size; /* octets of filesize not including ar_hdr */
106 char *filename; /* null-terminated */
107};
108
109#define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
110
64d5f5d0
ILT
111extern PTR bfd_malloc PARAMS ((size_t));
112extern PTR bfd_realloc PARAMS ((PTR, size_t));
113extern PTR bfd_zmalloc PARAMS ((size_t));
4e6f9223 114
4e98461f
SC
115extern bfd_error_handler_type _bfd_error_handler;
116
3cd5cf3d 117/* These routines allocate and free things on the BFD's objalloc. */
4e6f9223 118
3cd5cf3d
ILT
119extern PTR bfd_alloc PARAMS ((bfd *, size_t));
120extern PTR bfd_zalloc PARAMS ((bfd *, size_t));
121extern void bfd_release PARAMS ((bfd *, PTR));
14e3c2e4 122
14e3c2e4 123bfd * _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
f4bd7a8f 124bfd * _bfd_look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
b59f0276 125boolean _bfd_add_bfd_to_archive_cache PARAMS ((bfd *, file_ptr, bfd *));
14e3c2e4 126boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
e914ed52 127const bfd_target *bfd_generic_archive_p PARAMS ((bfd *abfd));
14e3c2e4 128boolean bfd_slurp_armap PARAMS ((bfd *abfd));
6affd66a 129boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
14e3c2e4
JK
130#define bfd_slurp_bsd_armap bfd_slurp_armap
131#define bfd_slurp_coff_armap bfd_slurp_armap
132boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
4e98461f
SC
133extern boolean _bfd_construct_extended_name_table
134 PARAMS ((bfd *, boolean, char **, bfd_size_type *));
14e3c2e4 135boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
c53fac12 136boolean _bfd_compute_and_write_armap PARAMS ((bfd *, unsigned int elength));
f4bd7a8f 137bfd *_bfd_get_elt_at_filepos PARAMS ((bfd *archive, file_ptr filepos));
64d5f5d0 138extern bfd *_bfd_generic_get_elt_at_index PARAMS ((bfd *, symindex));
f4bd7a8f 139bfd * _bfd_new_bfd PARAMS ((void));
4e6f9223 140
14e3c2e4
JK
141boolean bfd_false PARAMS ((bfd *ignore));
142boolean bfd_true PARAMS ((bfd *ignore));
143PTR bfd_nullvoidptr PARAMS ((bfd *ignore));
144int bfd_0 PARAMS ((bfd *ignore));
145unsigned int bfd_0u PARAMS ((bfd *ignore));
326e32d7 146long bfd_0l PARAMS ((bfd *ignore));
6812b607 147long _bfd_n1 PARAMS ((bfd *ignore));
14e3c2e4
JK
148void bfd_void PARAMS ((bfd *ignore));
149
e914ed52
ILT
150bfd *_bfd_new_bfd_contained_in PARAMS ((bfd *));
151const bfd_target *_bfd_dummy_target PARAMS ((bfd *abfd));
4e6f9223 152
14e3c2e4 153void bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
4e6f9223 154 char *hdr));
14e3c2e4 155void bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
4e6f9223 156 char *hdr));
14e3c2e4 157void bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
4e6f9223
SC
158 char *hdr));
159
14e3c2e4 160boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 161 struct orl *map, unsigned int orl_count, int stridx));
4e6f9223 162
14e3c2e4 163boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 164 struct orl *map, unsigned int orl_count, int stridx));
4e6f9223 165
c53fac12
ILT
166extern PTR _bfd_generic_read_ar_hdr PARAMS ((bfd *));
167
64d5f5d0
ILT
168extern PTR _bfd_generic_read_ar_hdr_mag PARAMS ((bfd *, const char *));
169
14e3c2e4 170bfd * bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
4e6f9223
SC
171 bfd *last_file));
172
14e3c2e4 173int bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
4e6f9223 174
c53fac12 175#define _bfd_read_ar_hdr(abfd) \
64d5f5d0 176 BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd))
6812b607
ILT
177\f
178/* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use
179 BFD_JUMP_TABLE_GENERIC (_bfd_generic). */
180
181#define _bfd_generic_close_and_cleanup bfd_true
182#define _bfd_generic_bfd_free_cached_info bfd_true
183#define _bfd_generic_new_section_hook \
184 ((boolean (*) PARAMS ((bfd *, asection *))) bfd_true)
185extern boolean _bfd_generic_get_section_contents
186 PARAMS ((bfd *, asection *, PTR location, file_ptr offset,
187 bfd_size_type count));
64d5f5d0
ILT
188extern boolean _bfd_generic_get_section_contents_in_window
189 PARAMS ((bfd *, asection *, bfd_window *, file_ptr, bfd_size_type));
6812b607
ILT
190
191/* Generic routines to use for BFD_JUMP_TABLE_COPY. Use
192 BFD_JUMP_TABLE_COPY (_bfd_generic). */
193
194#define _bfd_generic_bfd_copy_private_bfd_data \
195 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
4e98461f
SC
196#define _bfd_generic_bfd_merge_private_bfd_data \
197 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
198#define _bfd_generic_bfd_set_private_flags \
199 ((boolean (*) PARAMS ((bfd *, flagword))) bfd_true)
6812b607
ILT
200#define _bfd_generic_bfd_copy_private_section_data \
201 ((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
4e98461f
SC
202#define _bfd_generic_bfd_copy_private_symbol_data \
203 ((boolean (*) PARAMS ((bfd *, asymbol *, bfd *, asymbol *))) bfd_true)
204#define _bfd_generic_bfd_print_private_bfd_data \
64d5f5d0 205 ((boolean (*) PARAMS ((bfd *, PTR))) bfd_true)
6812b607
ILT
206
207/* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
208 support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */
209
210extern char *_bfd_nocore_core_file_failing_command PARAMS ((bfd *));
211extern int _bfd_nocore_core_file_failing_signal PARAMS ((bfd *));
212extern boolean _bfd_nocore_core_file_matches_executable_p
213 PARAMS ((bfd *, bfd *));
214
215/* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
216 file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */
217
218#define _bfd_noarchive_slurp_armap bfd_false
219#define _bfd_noarchive_slurp_extended_name_table bfd_false
4e98461f
SC
220#define _bfd_noarchive_construct_extended_name_table \
221 ((boolean (*) PARAMS ((bfd *, char **, bfd_size_type *, const char **))) \
222 bfd_false)
6812b607
ILT
223#define _bfd_noarchive_truncate_arname \
224 ((void (*) PARAMS ((bfd *, const char *, char *))) bfd_void)
225#define _bfd_noarchive_write_armap \
226 ((boolean (*) \
227 PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int))) \
228 bfd_false)
c53fac12 229#define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr
6812b607
ILT
230#define _bfd_noarchive_openr_next_archived_file \
231 ((bfd *(*) PARAMS ((bfd *, bfd *))) bfd_nullvoidptr)
64d5f5d0
ILT
232#define _bfd_noarchive_get_elt_at_index \
233 ((bfd *(*) PARAMS ((bfd *, symindex))) bfd_nullvoidptr)
6812b607 234#define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
4e98461f 235#define _bfd_noarchive_update_armap_timestamp bfd_false
6812b607
ILT
236
237/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
238 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */
239
240#define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
241#define _bfd_archive_bsd_slurp_extended_name_table \
242 _bfd_slurp_extended_name_table
4e98461f
SC
243extern boolean _bfd_archive_bsd_construct_extended_name_table
244 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT
245#define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
246#define _bfd_archive_bsd_write_armap bsd_write_armap
c53fac12 247#define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT
248#define _bfd_archive_bsd_openr_next_archived_file \
249 bfd_generic_openr_next_archived_file
64d5f5d0 250#define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT
251#define _bfd_archive_bsd_generic_stat_arch_elt \
252 bfd_generic_stat_arch_elt
4e98461f 253extern boolean _bfd_archive_bsd_update_armap_timestamp PARAMS ((bfd *));
6812b607
ILT
254
255/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
256 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */
257
258#define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
259#define _bfd_archive_coff_slurp_extended_name_table \
260 _bfd_slurp_extended_name_table
4e98461f
SC
261extern boolean _bfd_archive_coff_construct_extended_name_table
262 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT
263#define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
264#define _bfd_archive_coff_write_armap coff_write_armap
c53fac12 265#define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT
266#define _bfd_archive_coff_openr_next_archived_file \
267 bfd_generic_openr_next_archived_file
64d5f5d0 268#define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT
269#define _bfd_archive_coff_generic_stat_arch_elt \
270 bfd_generic_stat_arch_elt
4e98461f 271#define _bfd_archive_coff_update_armap_timestamp bfd_true
6812b607
ILT
272
273/* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
274 support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */
275
276#define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1
277#define _bfd_nosymbols_get_symtab \
278 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
279#define _bfd_nosymbols_make_empty_symbol \
280 ((asymbol *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
281#define _bfd_nosymbols_print_symbol \
282 ((void (*) PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type))) bfd_void)
283#define _bfd_nosymbols_get_symbol_info \
284 ((void (*) PARAMS ((bfd *, asymbol *, symbol_info *))) bfd_void)
35a3e78e
ILT
285#define _bfd_nosymbols_bfd_is_local_label_name \
286 ((boolean (*) PARAMS ((bfd *, const char *))) bfd_false)
6812b607
ILT
287#define _bfd_nosymbols_get_lineno \
288 ((alent *(*) PARAMS ((bfd *, asymbol *))) bfd_nullvoidptr)
289#define _bfd_nosymbols_find_nearest_line \
290 ((boolean (*) \
291 PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, \
292 const char **, unsigned int *))) \
293 bfd_false)
294#define _bfd_nosymbols_bfd_make_debug_symbol \
295 ((asymbol *(*) PARAMS ((bfd *, PTR, unsigned long))) bfd_nullvoidptr)
4e98461f
SC
296#define _bfd_nosymbols_read_minisymbols \
297 ((long (*) PARAMS ((bfd *, boolean, PTR *, unsigned int *))) _bfd_n1)
298#define _bfd_nosymbols_minisymbol_to_symbol \
299 ((asymbol *(*) PARAMS ((bfd *, boolean, const PTR, asymbol *))) \
300 bfd_nullvoidptr)
6812b607
ILT
301
302/* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
303 support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */
304
305#define _bfd_norelocs_get_reloc_upper_bound \
306 ((long (*) PARAMS ((bfd *, asection *))) _bfd_n1)
307#define _bfd_norelocs_canonicalize_reloc \
308 ((long (*) PARAMS ((bfd *, asection *, arelent **, asymbol **))) _bfd_n1)
309#define _bfd_norelocs_bfd_reloc_type_lookup \
4e98461f 310 ((reloc_howto_type *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) \
6812b607
ILT
311 bfd_nullvoidptr)
312
313/* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
314 be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */
315
316#define _bfd_nowrite_set_arch_mach \
317 ((boolean (*) PARAMS ((bfd *, enum bfd_architecture, unsigned long))) \
318 bfd_false)
319#define _bfd_nowrite_set_section_contents \
320 ((boolean (*) PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type))) \
321 bfd_false)
322
323/* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use
324 BFD_JUMP_TABLE_WRITE (_bfd_generic). */
325
326#define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
327extern boolean _bfd_generic_set_section_contents
328 PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
329
330/* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
331 support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */
332
333#define _bfd_nolink_sizeof_headers ((int (*) PARAMS ((bfd *, boolean))) bfd_0)
334#define _bfd_nolink_bfd_get_relocated_section_contents \
335 ((bfd_byte *(*) \
336 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *, \
337 bfd_byte *, boolean, asymbol **))) \
338 bfd_nullvoidptr)
339#define _bfd_nolink_bfd_relax_section \
340 ((boolean (*) \
341 PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *))) \
342 bfd_false)
343#define _bfd_nolink_bfd_link_hash_table_create \
344 ((struct bfd_link_hash_table *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
345#define _bfd_nolink_bfd_link_add_symbols \
346 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
347#define _bfd_nolink_bfd_final_link \
348 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
4e98461f
SC
349#define _bfd_nolink_bfd_link_split_section \
350 ((boolean (*) PARAMS ((bfd *, struct sec *))) bfd_false)
2944131c
ILT
351
352/* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
353 have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC
354 (_bfd_nodynamic). */
355
356#define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1
357#define _bfd_nodynamic_canonicalize_dynamic_symtab \
358 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
359#define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1
360#define _bfd_nodynamic_canonicalize_dynamic_reloc \
361 ((long (*) PARAMS ((bfd *, arelent **, asymbol **))) _bfd_n1)
4c3721d5 362\f
f1cca647
ILT
363/* Generic routine to determine of the given symbol is a local
364 label. */
35a3e78e 365extern boolean bfd_generic_is_local_label_name PARAMS ((bfd *, const char *));
f1cca647 366
4e98461f
SC
367/* Generic minisymbol routines. */
368extern long _bfd_generic_read_minisymbols
369 PARAMS ((bfd *, boolean, PTR *, unsigned int *));
370extern asymbol *_bfd_generic_minisymbol_to_symbol
371 PARAMS ((bfd *, boolean, const PTR, asymbol *));
372
39f27966
JL
373/* Find the nearest line using .stab/.stabstr sections. */
374extern boolean _bfd_stab_section_find_nearest_line
375 PARAMS ((bfd *, asymbol **, asection *, bfd_vma, boolean *, const char **,
376 const char **, unsigned int *, PTR *));
377
53d3ce37
TT
378/* Find the nearest line using DWARF 2 debugging information. */
379extern boolean _bfd_dwarf2_find_nearest_line
380 PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **,
381 const char **, unsigned int *));
382
4c3721d5
ILT
383/* A routine to create entries for a bfd_link_hash_table. */
384extern struct bfd_hash_entry *_bfd_link_hash_newfunc
385 PARAMS ((struct bfd_hash_entry *entry,
386 struct bfd_hash_table *table,
387 const char *string));
388
389/* Initialize a bfd_link_hash_table. */
390extern boolean _bfd_link_hash_table_init
391 PARAMS ((struct bfd_link_hash_table *, bfd *,
392 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
393 struct bfd_hash_table *,
394 const char *)));
395
396/* Generic link hash table creation routine. */
397extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
398 PARAMS ((bfd *));
399
400/* Generic add symbol routine. */
401extern boolean _bfd_generic_link_add_symbols
402 PARAMS ((bfd *, struct bfd_link_info *));
403
326e32d7
ILT
404/* Generic add symbol routine. This version is used by targets for
405 which the linker must collect constructors and destructors by name,
406 as the collect2 program does. */
407extern boolean _bfd_generic_link_add_symbols_collect
408 PARAMS ((bfd *, struct bfd_link_info *));
409
4c3721d5
ILT
410/* Generic archive add symbol routine. */
411extern boolean _bfd_generic_link_add_archive_symbols
412 PARAMS ((bfd *, struct bfd_link_info *,
413 boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
414
39f27966
JL
415
416
4c3721d5
ILT
417/* Forward declaration to avoid prototype errors. */
418typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
419
420/* Generic routine to add a single symbol. */
421extern boolean _bfd_generic_link_add_one_symbol
422 PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
423 asection *, bfd_vma, const char *, boolean copy,
f1cca647 424 boolean constructor, struct bfd_link_hash_entry **));
4c3721d5
ILT
425
426/* Generic link routine. */
427extern boolean _bfd_generic_final_link
428 PARAMS ((bfd *, struct bfd_link_info *));
429
4e98461f
SC
430extern boolean _bfd_generic_link_split_section
431 PARAMS ((bfd *, struct sec *));
432
f1cca647
ILT
433/* Generic reloc_link_order processing routine. */
434extern boolean _bfd_generic_reloc_link_order
435 PARAMS ((bfd *, struct bfd_link_info *, asection *,
436 struct bfd_link_order *));
437
4c3721d5
ILT
438/* Default link order processing routine. */
439extern boolean _bfd_default_link_order
440 PARAMS ((bfd *, struct bfd_link_info *, asection *,
441 struct bfd_link_order *));
442
f1cca647
ILT
443/* Count the number of reloc entries in a link order list. */
444extern unsigned int _bfd_count_link_order_relocs
445 PARAMS ((struct bfd_link_order *));
446
4c3721d5
ILT
447/* Final link relocation routine. */
448extern bfd_reloc_status_type _bfd_final_link_relocate
4e98461f 449 PARAMS ((reloc_howto_type *, bfd *, asection *, bfd_byte *,
4c3721d5
ILT
450 bfd_vma address, bfd_vma value, bfd_vma addend));
451
452/* Relocate a particular location by a howto and a value. */
453extern bfd_reloc_status_type _bfd_relocate_contents
4e98461f 454 PARAMS ((reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
e914ed52 455
35a3e78e
ILT
456/* Link stabs in sections in the first pass. */
457
458extern boolean _bfd_link_section_stabs
459 PARAMS ((bfd *, PTR *, asection *, asection *, PTR *));
460
461/* Write out the .stab section when linking stabs in sections. */
462
463extern boolean _bfd_write_section_stabs
3cd5cf3d 464 PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_byte *));
35a3e78e
ILT
465
466/* Write out the .stabstr string table when linking stabs in sections. */
467
468extern boolean _bfd_write_stab_strings PARAMS ((bfd *, PTR *));
469
53d3ce37
TT
470/* Find an offset within a .stab section when linking stabs in
471 sections. */
472
473extern bfd_vma _bfd_stab_section_offset
474 PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_vma));
475
e914ed52
ILT
476/* Create a string table. */
477extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
478
64d5f5d0
ILT
479/* Create an XCOFF .debug section style string table. */
480extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init PARAMS ((void));
481
e914ed52
ILT
482/* Free a string table. */
483extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
484
485/* Get the size of a string table. */
486extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
487
488/* Add a string to a string table. */
489extern bfd_size_type _bfd_stringtab_add
490 PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
491 boolean copy));
492
493/* Write out a string table. */
494extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
4c3721d5 495\f
4e6f9223
SC
496/* Macros to tell if bfds are read or write enabled.
497
498 Note that bfds open for read may be scribbled into if the fd passed
499 to bfd_fdopenr is actually open both for read and write
500 simultaneously. However an output bfd will never be open for
501 read. Therefore sometimes you want to check bfd_read_p or
502 !bfd_read_p, and only sometimes bfd_write_p.
503*/
504
14e3c2e4
JK
505#define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
506#define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
507
c53fac12 508void bfd_assert PARAMS ((const char*,int));
4e6f9223 509
4e6f9223
SC
510#define BFD_ASSERT(x) \
511{ if (!(x)) bfd_assert(__FILE__,__LINE__); }
512
513#define BFD_FAIL() \
514{ bfd_assert(__FILE__,__LINE__); }
515
14e3c2e4 516FILE * bfd_cache_lookup_worker PARAMS ((bfd *));
4e6f9223
SC
517
518extern bfd *bfd_last_cache;
4e6f9223 519
4c3721d5 520/* List of supported target vectors, and the default vector (if
f4bd7a8f 521 bfd_default_vector[0] is NULL, there is no default). */
e914ed52 522extern const bfd_target * const bfd_target_vector[];
50ede03d 523extern const bfd_target *bfd_default_vector[];
4c3721d5 524
c53fac12 525/* Functions shared by the ECOFF and MIPS ELF backends, which have no
4e98461f
SC
526 other common header files. */
527
528#if defined(__STDC__) || defined(ALMOST_STDC)
529struct ecoff_find_line;
530#endif
531
c53fac12 532extern boolean _bfd_ecoff_locate_line
4e98461f
SC
533 PARAMS ((bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
534 const struct ecoff_debug_swap * const, struct ecoff_find_line *,
535 const char **, const char **, unsigned int *));
c53fac12
ILT
536extern boolean _bfd_ecoff_get_accumulated_pdr PARAMS ((PTR, bfd_byte *));
537extern boolean _bfd_ecoff_get_accumulated_sym PARAMS ((PTR, bfd_byte *));
538extern boolean _bfd_ecoff_get_accumulated_ss PARAMS ((PTR, bfd_byte *));
4e98461f 539
39f27966
JL
540extern bfd_vma _bfd_get_gp_value PARAMS ((bfd *));
541extern void _bfd_set_gp_value PARAMS ((bfd *, bfd_vma));
542
35a3e78e
ILT
543/* Function shared by the COFF and ELF SH backends, which have no
544 other common header files. */
545
546extern boolean _bfd_sh_align_load_span
547 PARAMS ((bfd *, asection *, bfd_byte *,
548 boolean (*) (bfd *, asection *, PTR, bfd_byte *, bfd_vma),
549 PTR, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, boolean *));
550
14e3c2e4 551/* And more follows */
4e6f9223 552
This page took 0.287999 seconds and 4 git commands to generate.