projects / deliverable / binutils-gdb.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Print WITH_STDIO if -t options
[deliverable/binutils-gdb.git] / bfd / libbfd.h
CommitLineData
c618de01
SC		 1/* libbfd.h -- Declarations used by bfd library *implementation*.
2 (This include file is not for users of the library.)
83f4323e 3 Copyright 1990, 91, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
c618de01 4 Written by Cygnus Support.
fc723380 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
c618de01 10This file is part of BFD, the Binary File Descriptor library.
4a81b561 11
c618de01 12This program is free software; you can redistribute it and/or modify
4a81b561 13it under the terms of the GNU General Public License as published by
c618de01
SC		 14the Free Software Foundation; either version 2 of the License, or
15(at your option) any later version.
4a81b561 16
c618de01 17This program is distributed in the hope that it will be useful,
4a81b561
DHW		 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
c618de01 23along with this program; if not, write to the Free Software
4e98461f 24Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
4a81b561 25
01dd1b2b
SC		 26/* Align an address upward to a boundary, expressed as a number of bytes.
27 E.g. align to an 8-byte boundary with argument of 8. */
de0da6ce 28#define BFD_ALIGN(this, boundary) \
01dd1b2b
SC		 29 ((( (this) + ((boundary) -1)) & (~((boundary)-1))))
30
4a81b561
DHW		 31/* If you want to read and write large blocks, you might want to do it
32 in quanta of this amount */
33#define DEFAULT_BUFFERSIZE 8192
34
fc723380
JG		 35/* Set a tdata field. Can't use the other macros for this, since they
36 do casts, and casting to the left of assignment isn't portable. */
d5cd3c0e 37#define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
fc723380 38
64d5f5d0
ILT		 39/* If BFD_IN_MEMORY is set for a BFD, then the iostream fields points
40 to an instance of this structure. */
41
42struct bfd_in_memory
43{
44 /* Size of buffer. */
45 bfd_size_type size;
46 /* Buffer holding contents of BFD. */
47 bfd_byte *buffer;
48};
49
fc723380
JG		 50/* tdata for an archive. For an input archive, cache
51 needs to be free()'d. For an output archive, symdefs do. */
4a81b561
DHW		 52
53struct artdata {
54 file_ptr first_file_filepos;
55 /* Speed up searching the armap */
56 struct ar_cache *cache;
57 bfd *archive_head; /* Only interesting in output routines */
58 carsym *symdefs; /* the symdef entries */
59 symindex symdef_count; /* how many there are */
60 char *extended_names; /* clever intel extension */
c188b0be
DM		 61 /* when more compilers are standard C, this can be a time_t */
62 long armap_timestamp; /* Timestamp value written into armap.
b5b4294e
JG		 63 This is used for BSD archives to check
64 that the timestamp is recent enough
65 for the BSD linker to not complain,
66 just before we finish writing an
67 archive. */
68 file_ptr armap_datepos; /* Position within archive to seek to
69 rewrite the date field. */
b59f0276 70 PTR tdata; /* Backend specific information. */
4a81b561
DHW		 71};
72
e98e6ec1 73#define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
4a81b561
DHW		 74
75/* Goes in bfd's arelt_data slot */
76struct areltdata {
77 char * arch_header; /* it's actually a string */
78 unsigned int parsed_size; /* octets of filesize not including ar_hdr */
79 char *filename; /* null-terminated */
80};
81
82#define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
83
64d5f5d0
ILT		 84extern PTR bfd_malloc PARAMS ((size_t));
85extern PTR bfd_realloc PARAMS ((PTR, size_t));
86extern PTR bfd_zmalloc PARAMS ((size_t));
9846338e 87
4e98461f
SC		 88extern bfd_error_handler_type _bfd_error_handler;
89
64d5f5d0 90/* These routines allocate and free things on the BFD's obstack. */
4a81b561 91
6affd66a
KR		 92PTR bfd_alloc PARAMS ((bfd *abfd, size_t size));
93PTR bfd_zalloc PARAMS ((bfd *abfd, size_t size));
6affd66a 94void bfd_alloc_grow PARAMS ((bfd *abfd, PTR thing, size_t size));
287c221d
PB		 95PTR bfd_alloc_finish PARAMS ((bfd *abfd));
96PTR bfd_alloc_by_size_t PARAMS ((bfd *abfd, size_t wanted));
97
98#define bfd_release(x,y) (void) obstack_free(&(x->memory),y)
99
287c221d 100bfd * _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
f4bd7a8f 101bfd * _bfd_look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
b59f0276 102boolean _bfd_add_bfd_to_archive_cache PARAMS ((bfd *, file_ptr, bfd *));
287c221d 103boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
e914ed52 104const bfd_target *bfd_generic_archive_p PARAMS ((bfd *abfd));
287c221d 105boolean bfd_slurp_armap PARAMS ((bfd *abfd));
898728d4 106boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
287c221d
PB		 107#define bfd_slurp_bsd_armap bfd_slurp_armap
108#define bfd_slurp_coff_armap bfd_slurp_armap
109boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
fca2b81b
KR		 110extern boolean _bfd_construct_extended_name_table
111 PARAMS ((bfd *, boolean, char **, bfd_size_type *));
287c221d 112boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
c53fac12 113boolean _bfd_compute_and_write_armap PARAMS ((bfd *, unsigned int elength));
f4bd7a8f 114bfd *_bfd_get_elt_at_filepos PARAMS ((bfd *archive, file_ptr filepos));
64d5f5d0 115extern bfd *_bfd_generic_get_elt_at_index PARAMS ((bfd *, symindex));
f4bd7a8f 116bfd * _bfd_new_bfd PARAMS ((void));
4a81b561 117
287c221d
PB		 118boolean bfd_false PARAMS ((bfd *ignore));
119boolean bfd_true PARAMS ((bfd *ignore));
120PTR bfd_nullvoidptr PARAMS ((bfd *ignore));
121int bfd_0 PARAMS ((bfd *ignore));
122unsigned int bfd_0u PARAMS ((bfd *ignore));
326e32d7 123long bfd_0l PARAMS ((bfd *ignore));
6812b607 124long _bfd_n1 PARAMS ((bfd *ignore));
287c221d
PB		 125void bfd_void PARAMS ((bfd *ignore));
126
e914ed52
ILT		 127bfd *_bfd_new_bfd_contained_in PARAMS ((bfd *));
128const bfd_target *_bfd_dummy_target PARAMS ((bfd *abfd));
4a81b561 129
287c221d 130void bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 131 char *hdr));
287c221d 132void bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 133 char *hdr));
287c221d 134void bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 135 char *hdr));
4a81b561 136
287c221d 137boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 138 struct orl *map, unsigned int orl_count, int stridx));
4a81b561 139
287c221d 140boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 141 struct orl *map, unsigned int orl_count, int stridx));
4a81b561 142
c53fac12
ILT		 143extern PTR _bfd_generic_read_ar_hdr PARAMS ((bfd *));
144
64d5f5d0
ILT		 145extern PTR _bfd_generic_read_ar_hdr_mag PARAMS ((bfd *, const char *));
146
287c221d 147bfd * bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
2203f786 148 bfd *last_file));
4a81b561 149
287c221d 150int bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
fc723380 151
c53fac12 152#define _bfd_read_ar_hdr(abfd) \
64d5f5d0 153 BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd))
6812b607
ILT		 154\f
155/* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use
156 BFD_JUMP_TABLE_GENERIC (_bfd_generic). */
157
158#define _bfd_generic_close_and_cleanup bfd_true
159#define _bfd_generic_bfd_free_cached_info bfd_true
160#define _bfd_generic_new_section_hook \
161 ((boolean (*) PARAMS ((bfd *, asection *))) bfd_true)
162extern boolean _bfd_generic_get_section_contents
163 PARAMS ((bfd *, asection *, PTR location, file_ptr offset,
164 bfd_size_type count));
64d5f5d0
ILT		 165extern boolean _bfd_generic_get_section_contents_in_window
166 PARAMS ((bfd *, asection *, bfd_window *, file_ptr, bfd_size_type));
6812b607
ILT		 167
168/* Generic routines to use for BFD_JUMP_TABLE_COPY. Use
169 BFD_JUMP_TABLE_COPY (_bfd_generic). */
170
171#define _bfd_generic_bfd_copy_private_bfd_data \
172 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
4e98461f
SC		 173#define _bfd_generic_bfd_merge_private_bfd_data \
174 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
175#define _bfd_generic_bfd_set_private_flags \
176 ((boolean (*) PARAMS ((bfd *, flagword))) bfd_true)
6812b607
ILT		 177#define _bfd_generic_bfd_copy_private_section_data \
178 ((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
4e98461f
SC		 179#define _bfd_generic_bfd_copy_private_symbol_data \
180 ((boolean (*) PARAMS ((bfd *, asymbol *, bfd *, asymbol *))) bfd_true)
181#define _bfd_generic_bfd_print_private_bfd_data \
64d5f5d0 182 ((boolean (*) PARAMS ((bfd *, PTR))) bfd_true)
6812b607
ILT		 183
184/* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
185 support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */
186
187extern char *_bfd_nocore_core_file_failing_command PARAMS ((bfd *));
188extern int _bfd_nocore_core_file_failing_signal PARAMS ((bfd *));
189extern boolean _bfd_nocore_core_file_matches_executable_p
190 PARAMS ((bfd *, bfd *));
191
192/* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
193 file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */
194
195#define _bfd_noarchive_slurp_armap bfd_false
196#define _bfd_noarchive_slurp_extended_name_table bfd_false
fca2b81b
KR		 197#define _bfd_noarchive_construct_extended_name_table \
198 ((boolean (*) PARAMS ((bfd *, char **, bfd_size_type *, const char **))) \
199 bfd_false)
6812b607
ILT		 200#define _bfd_noarchive_truncate_arname \
201 ((void (*) PARAMS ((bfd *, const char *, char *))) bfd_void)
202#define _bfd_noarchive_write_armap \
203 ((boolean (*) \
204 PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int))) \
205 bfd_false)
c53fac12 206#define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr
6812b607
ILT		 207#define _bfd_noarchive_openr_next_archived_file \
208 ((bfd *(*) PARAMS ((bfd *, bfd *))) bfd_nullvoidptr)
64d5f5d0
ILT		 209#define _bfd_noarchive_get_elt_at_index \
210 ((bfd *(*) PARAMS ((bfd *, symindex))) bfd_nullvoidptr)
6812b607 211#define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
0443af31 212#define _bfd_noarchive_update_armap_timestamp bfd_false
6812b607
ILT		 213
214/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
215 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */
216
217#define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
218#define _bfd_archive_bsd_slurp_extended_name_table \
219 _bfd_slurp_extended_name_table
fca2b81b
KR		 220extern boolean _bfd_archive_bsd_construct_extended_name_table
221 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT		 222#define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
223#define _bfd_archive_bsd_write_armap bsd_write_armap
c53fac12 224#define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT		 225#define _bfd_archive_bsd_openr_next_archived_file \
226 bfd_generic_openr_next_archived_file
64d5f5d0 227#define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT		 228#define _bfd_archive_bsd_generic_stat_arch_elt \
229 bfd_generic_stat_arch_elt
0443af31 230extern boolean _bfd_archive_bsd_update_armap_timestamp PARAMS ((bfd *));
6812b607
ILT		 231
232/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
233 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */
234
235#define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
236#define _bfd_archive_coff_slurp_extended_name_table \
237 _bfd_slurp_extended_name_table
fca2b81b
KR		 238extern boolean _bfd_archive_coff_construct_extended_name_table
239 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT		 240#define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
241#define _bfd_archive_coff_write_armap coff_write_armap
c53fac12 242#define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT		 243#define _bfd_archive_coff_openr_next_archived_file \
244 bfd_generic_openr_next_archived_file
64d5f5d0 245#define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT		 246#define _bfd_archive_coff_generic_stat_arch_elt \
247 bfd_generic_stat_arch_elt
0443af31 248#define _bfd_archive_coff_update_armap_timestamp bfd_true
6812b607
ILT		 249
250/* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
251 support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */
252
253#define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1
254#define _bfd_nosymbols_get_symtab \
255 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
256#define _bfd_nosymbols_make_empty_symbol \
257 ((asymbol *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
258#define _bfd_nosymbols_print_symbol \
259 ((void (*) PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type))) bfd_void)
260#define _bfd_nosymbols_get_symbol_info \
261 ((void (*) PARAMS ((bfd *, asymbol *, symbol_info *))) bfd_void)
262#define _bfd_nosymbols_bfd_is_local_label \
263 ((boolean (*) PARAMS ((bfd *, asymbol *))) bfd_false)
264#define _bfd_nosymbols_get_lineno \
265 ((alent *(*) PARAMS ((bfd *, asymbol *))) bfd_nullvoidptr)
266#define _bfd_nosymbols_find_nearest_line \
267 ((boolean (*) \
268 PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, \
269 const char **, unsigned int *))) \
270 bfd_false)
271#define _bfd_nosymbols_bfd_make_debug_symbol \
272 ((asymbol *(*) PARAMS ((bfd *, PTR, unsigned long))) bfd_nullvoidptr)
4e98461f
SC		 273#define _bfd_nosymbols_read_minisymbols \
274 ((long (*) PARAMS ((bfd *, boolean, PTR *, unsigned int *))) _bfd_n1)
275#define _bfd_nosymbols_minisymbol_to_symbol \
276 ((asymbol *(*) PARAMS ((bfd *, boolean, const PTR, asymbol *))) \
277 bfd_nullvoidptr)
6812b607
ILT		 278
279/* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
280 support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */
281
282#define _bfd_norelocs_get_reloc_upper_bound \
283 ((long (*) PARAMS ((bfd *, asection *))) _bfd_n1)
284#define _bfd_norelocs_canonicalize_reloc \
285 ((long (*) PARAMS ((bfd *, asection *, arelent **, asymbol **))) _bfd_n1)
286#define _bfd_norelocs_bfd_reloc_type_lookup \
82b1edf7 287 ((reloc_howto_type *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) \
6812b607
ILT		 288 bfd_nullvoidptr)
289
290/* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
291 be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */
292
293#define _bfd_nowrite_set_arch_mach \
294 ((boolean (*) PARAMS ((bfd *, enum bfd_architecture, unsigned long))) \
295 bfd_false)
296#define _bfd_nowrite_set_section_contents \
297 ((boolean (*) PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type))) \
298 bfd_false)
299
300/* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use
301 BFD_JUMP_TABLE_WRITE (_bfd_generic). */
302
303#define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
304extern boolean _bfd_generic_set_section_contents
305 PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
306
307/* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
308 support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */
309
310#define _bfd_nolink_sizeof_headers ((int (*) PARAMS ((bfd *, boolean))) bfd_0)
311#define _bfd_nolink_bfd_get_relocated_section_contents \
312 ((bfd_byte *(*) \
313 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *, \
314 bfd_byte *, boolean, asymbol **))) \
315 bfd_nullvoidptr)
316#define _bfd_nolink_bfd_relax_section \
317 ((boolean (*) \
318 PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *))) \
319 bfd_false)
320#define _bfd_nolink_bfd_link_hash_table_create \
321 ((struct bfd_link_hash_table *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
322#define _bfd_nolink_bfd_link_add_symbols \
323 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
324#define _bfd_nolink_bfd_final_link \
325 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
4e98461f
SC		 326#define _bfd_nolink_bfd_link_split_section \
327 ((boolean (*) PARAMS ((bfd *, struct sec *))) bfd_false)
4ee3b9be
JL		 328
329/* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
330 have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC
331 (_bfd_nodynamic). */
332
333#define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1
334#define _bfd_nodynamic_canonicalize_dynamic_symtab \
335 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
336#define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1
337#define _bfd_nodynamic_canonicalize_dynamic_reloc \
338 ((long (*) PARAMS ((bfd *, arelent **, asymbol **))) _bfd_n1)
4c3721d5 339\f
f1cca647
ILT		 340/* Generic routine to determine of the given symbol is a local
341 label. */
342extern boolean bfd_generic_is_local_label PARAMS ((bfd *, asymbol *));
343
4e98461f
SC		 344/* Generic minisymbol routines. */
345extern long _bfd_generic_read_minisymbols
346 PARAMS ((bfd *, boolean, PTR *, unsigned int *));
347extern asymbol *_bfd_generic_minisymbol_to_symbol
348 PARAMS ((bfd *, boolean, const PTR, asymbol *));
349
e9f03cd4
ILT		 350/* Find the nearest line using .stab/.stabstr sections. */
351extern boolean _bfd_stab_section_find_nearest_line
352 PARAMS ((bfd *, asymbol **, asection *, bfd_vma, boolean *, const char **,
353 const char **, unsigned int *, PTR *));
354
4c3721d5
ILT		 355/* A routine to create entries for a bfd_link_hash_table. */
356extern struct bfd_hash_entry *_bfd_link_hash_newfunc
357 PARAMS ((struct bfd_hash_entry *entry,
358 struct bfd_hash_table *table,
359 const char *string));
360
361/* Initialize a bfd_link_hash_table. */
362extern boolean _bfd_link_hash_table_init
363 PARAMS ((struct bfd_link_hash_table *, bfd *,
364 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
365 struct bfd_hash_table *,
366 const char *)));
367
368/* Generic link hash table creation routine. */
369extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
370 PARAMS ((bfd *));
371
39f27966
JL		 372/* Generic link hash table entry creation routine. */
373struct bfd_hash_entry *generic_link_hash_newfunc
374 PARAMS ((struct bfd_hash_entry *, struct bfd_hash_table *,
375 const char *));
376
4c3721d5
ILT		 377/* Generic add symbol routine. */
378extern boolean _bfd_generic_link_add_symbols
379 PARAMS ((bfd *, struct bfd_link_info *));
380
4335ce64
ILT		 381/* Generic add symbol routine. This version is used by targets for
382 which the linker must collect constructors and destructors by name,
383 as the collect2 program does. */
384extern boolean _bfd_generic_link_add_symbols_collect
385 PARAMS ((bfd *, struct bfd_link_info *));
386
4c3721d5
ILT		 387/* Generic archive add symbol routine. */
388extern boolean _bfd_generic_link_add_archive_symbols
389 PARAMS ((bfd *, struct bfd_link_info *,
390 boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
391
39f27966
JL		 392
393
4c3721d5
ILT		 394/* Forward declaration to avoid prototype errors. */
395typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
396
397/* Generic routine to add a single symbol. */
398extern boolean _bfd_generic_link_add_one_symbol
399 PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
400 asection *, bfd_vma, const char *, boolean copy,
f1cca647 401 boolean constructor, struct bfd_link_hash_entry **));
4c3721d5
ILT		 402
403/* Generic link routine. */
404extern boolean _bfd_generic_final_link
405 PARAMS ((bfd *, struct bfd_link_info *));
406
4e98461f
SC		 407extern boolean _bfd_generic_link_split_section
408 PARAMS ((bfd *, struct sec *));
409
f1cca647
ILT		 410/* Generic reloc_link_order processing routine. */
411extern boolean _bfd_generic_reloc_link_order
412 PARAMS ((bfd *, struct bfd_link_info *, asection *,
413 struct bfd_link_order *));
414
4c3721d5
ILT		 415/* Default link order processing routine. */
416extern boolean _bfd_default_link_order
417 PARAMS ((bfd *, struct bfd_link_info *, asection *,
418 struct bfd_link_order *));
419
f1cca647
ILT		 420/* Count the number of reloc entries in a link order list. */
421extern unsigned int _bfd_count_link_order_relocs
422 PARAMS ((struct bfd_link_order *));
423
4c3721d5
ILT		 424/* Final link relocation routine. */
425extern bfd_reloc_status_type _bfd_final_link_relocate
82b1edf7 426 PARAMS ((reloc_howto_type *, bfd *, asection *, bfd_byte *,
4c3721d5
ILT		 427 bfd_vma address, bfd_vma value, bfd_vma addend));
428
429/* Relocate a particular location by a howto and a value. */
430extern bfd_reloc_status_type _bfd_relocate_contents
82b1edf7 431 PARAMS ((reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
e914ed52
ILT		 432
433/* Create a string table. */
434extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
435
64d5f5d0
ILT		 436/* Create an XCOFF .debug section style string table. */
437extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init PARAMS ((void));
438
e914ed52
ILT		 439/* Free a string table. */
440extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
441
442/* Get the size of a string table. */
443extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
444
445/* Add a string to a string table. */
446extern bfd_size_type _bfd_stringtab_add
447 PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
448 boolean copy));
449
450/* Write out a string table. */
451extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
4c3721d5 452\f
4a81b561
DHW		 453/* Macros to tell if bfds are read or write enabled.
454
455 Note that bfds open for read may be scribbled into if the fd passed
456 to bfd_fdopenr is actually open both for read and write
457 simultaneously. However an output bfd will never be open for
458 read. Therefore sometimes you want to check bfd_read_p or
459 !bfd_read_p, and only sometimes bfd_write_p.
460*/
461
287c221d
PB		 462#define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
463#define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
464
c53fac12 465void bfd_assert PARAMS ((const char*,int));
4a81b561 466
4a81b561
DHW		 467#define BFD_ASSERT(x) \
468{ if (!(x)) bfd_assert(__FILE__,__LINE__); }
469
470#define BFD_FAIL() \
471{ bfd_assert(__FILE__,__LINE__); }
472
287c221d 473FILE * bfd_cache_lookup_worker PARAMS ((bfd *));
4a81b561
DHW		 474
475extern bfd *bfd_last_cache;
4a81b561
DHW		 476
477/* Now Steve, what's the story here? */
478#ifdef lint
479#define itos(x) "l"
480#define stoi(x) 1
481#else
482#define itos(x) ((char*)(x))
483#define stoi(x) ((int)(x))
484#endif
69ebee86 485
4c3721d5 486/* List of supported target vectors, and the default vector (if
f4bd7a8f 487 bfd_default_vector[0] is NULL, there is no default). */
e914ed52
ILT		 488extern const bfd_target * const bfd_target_vector[];
489extern const bfd_target * const bfd_default_vector[];
4c3721d5 490
02f85cda 491/* Functions shared by the ECOFF and MIPS ELF backends, which have no
4e98461f
SC		 492 other common header files. */
493
494#if defined(__STDC__) || defined(ALMOST_STDC)
495struct ecoff_find_line;
496#endif
497
02f85cda 498extern boolean _bfd_ecoff_locate_line
4e98461f
SC		 499 PARAMS ((bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
500 const struct ecoff_debug_swap * const, struct ecoff_find_line *,
501 const char **, const char **, unsigned int *));
02f85cda
MM		 502extern boolean _bfd_ecoff_get_accumulated_pdr PARAMS ((PTR, bfd_byte *));
503extern boolean _bfd_ecoff_get_accumulated_sym PARAMS ((PTR, bfd_byte *));
504extern boolean _bfd_ecoff_get_accumulated_ss PARAMS ((PTR, bfd_byte *));
4e98461f 505
39f27966
JL		 506extern bfd_vma _bfd_get_gp_value PARAMS ((bfd *));
507extern void _bfd_set_gp_value PARAMS ((bfd *, bfd_vma));
508
b8d69097 509/* And more follows */
6f715d66 510
fefb4b30
JG		 511void
512bfd_write_bigendian_4byte_int PARAMS ((bfd *abfd, int i));
513
3ceaa255 514unsigned int
fefb4b30
JG		 515bfd_log2 PARAMS ((bfd_vma x));
516
6f715d66 517#define BFD_CACHE_MAX_OPEN 10
6f715d66 518extern bfd *bfd_last_cache;
e98e6ec1 519
6f715d66 520#define bfd_cache_lookup(x) \
0cda46cf
SC		 521 ((x)==bfd_last_cache? \
522 (FILE*)(bfd_last_cache->iostream): \
523 bfd_cache_lookup_worker(x))
4ee3b9be
JL		 524boolean
525bfd_cache_init PARAMS ((bfd *abfd));
526
fefb4b30 527boolean
c188b0be 528bfd_cache_close PARAMS ((bfd *abfd));
fefb4b30
JG		 529
530FILE*
c188b0be 531bfd_open_file PARAMS ((bfd *abfd));
fefb4b30
JG		 532
533FILE *
c188b0be 534bfd_cache_lookup_worker PARAMS ((bfd *abfd));
fefb4b30 535
0443af31
KR		 536#ifdef _BFD_MAKE_TABLE_bfd_reloc_code_real
537
538static const char *const bfd_reloc_code_real_names[] = { "@@uninitialized@@",
539
540 "BFD_RELOC_64",
541 "BFD_RELOC_32",
542 "BFD_RELOC_26",
543 "BFD_RELOC_16",
544 "BFD_RELOC_14",
545 "BFD_RELOC_8",
546 "BFD_RELOC_64_PCREL",
547 "BFD_RELOC_32_PCREL",
548 "BFD_RELOC_24_PCREL",
549 "BFD_RELOC_16_PCREL",
fca2b81b 550 "BFD_RELOC_12_PCREL",
0443af31 551 "BFD_RELOC_8_PCREL",
4e98461f
SC		 552 "BFD_RELOC_32_GOT_PCREL",
553 "BFD_RELOC_16_GOT_PCREL",
554 "BFD_RELOC_8_GOT_PCREL",
555 "BFD_RELOC_32_GOTOFF",
556 "BFD_RELOC_16_GOTOFF",
02f85cda
MM		 557 "BFD_RELOC_LO16_GOTOFF",
558 "BFD_RELOC_HI16_GOTOFF",
559 "BFD_RELOC_HI16_S_GOTOFF",
4e98461f
SC		 560 "BFD_RELOC_8_GOTOFF",
561 "BFD_RELOC_32_PLT_PCREL",
02f85cda 562 "BFD_RELOC_24_PLT_PCREL",
4e98461f
SC		 563 "BFD_RELOC_16_PLT_PCREL",
564 "BFD_RELOC_8_PLT_PCREL",
565 "BFD_RELOC_32_PLTOFF",
566 "BFD_RELOC_16_PLTOFF",
02f85cda
MM		 567 "BFD_RELOC_LO16_PLTOFF",
568 "BFD_RELOC_HI16_PLTOFF",
569 "BFD_RELOC_HI16_S_PLTOFF",
4e98461f
SC		 570 "BFD_RELOC_8_PLTOFF",
571 "BFD_RELOC_68K_GLOB_DAT",
572 "BFD_RELOC_68K_JMP_SLOT",
573 "BFD_RELOC_68K_RELATIVE",
0443af31
KR		 574 "BFD_RELOC_32_BASEREL",
575 "BFD_RELOC_16_BASEREL",
02f85cda
MM		 576 "BFD_RELOC_LO16_BASEREL",
577 "BFD_RELOC_HI16_BASEREL",
578 "BFD_RELOC_HI16_S_BASEREL",
0443af31 579 "BFD_RELOC_8_BASEREL",
4e98461f 580 "BFD_RELOC_RVA",
0443af31
KR		 581 "BFD_RELOC_8_FFnn",
582 "BFD_RELOC_32_PCREL_S2",
583 "BFD_RELOC_16_PCREL_S2",
584 "BFD_RELOC_23_PCREL_S2",
585 "BFD_RELOC_HI22",
586 "BFD_RELOC_LO10",
587 "BFD_RELOC_GPREL16",
588 "BFD_RELOC_GPREL32",
589 "BFD_RELOC_I960_CALLJ",
590 "BFD_RELOC_NONE",
591 "BFD_RELOC_SPARC_WDISP22",
592 "BFD_RELOC_SPARC22",
593 "BFD_RELOC_SPARC13",
594 "BFD_RELOC_SPARC_GOT10",
595 "BFD_RELOC_SPARC_GOT13",
596 "BFD_RELOC_SPARC_GOT22",
597 "BFD_RELOC_SPARC_PC10",
598 "BFD_RELOC_SPARC_PC22",
599 "BFD_RELOC_SPARC_WPLT30",
600 "BFD_RELOC_SPARC_COPY",
601 "BFD_RELOC_SPARC_GLOB_DAT",
602 "BFD_RELOC_SPARC_JMP_SLOT",
603 "BFD_RELOC_SPARC_RELATIVE",
604 "BFD_RELOC_SPARC_UA32",
605 "BFD_RELOC_SPARC_BASE13",
606 "BFD_RELOC_SPARC_BASE22",
607 "BFD_RELOC_SPARC_10",
608 "BFD_RELOC_SPARC_11",
609 "BFD_RELOC_SPARC_OLO10",
610 "BFD_RELOC_SPARC_HH22",
611 "BFD_RELOC_SPARC_HM10",
612 "BFD_RELOC_SPARC_LM22",
613 "BFD_RELOC_SPARC_PC_HH22",
614 "BFD_RELOC_SPARC_PC_HM10",
615 "BFD_RELOC_SPARC_PC_LM22",
616 "BFD_RELOC_SPARC_WDISP16",
617 "BFD_RELOC_SPARC_WDISP19",
618 "BFD_RELOC_SPARC_GLOB_JMP",
e9f03cd4
ILT		 619 "BFD_RELOC_SPARC_7",
620 "BFD_RELOC_SPARC_6",
621 "BFD_RELOC_SPARC_5",
0443af31
KR		 622 "BFD_RELOC_ALPHA_GPDISP_HI16",
623 "BFD_RELOC_ALPHA_GPDISP_LO16",
624 "BFD_RELOC_ALPHA_LITERAL",
625 "BFD_RELOC_ALPHA_LITUSE",
626 "BFD_RELOC_ALPHA_HINT",
627 "BFD_RELOC_MIPS_JMP",
628 "BFD_RELOC_HI16",
629 "BFD_RELOC_HI16_S",
630 "BFD_RELOC_LO16",
631 "BFD_RELOC_PCREL_HI16_S",
632 "BFD_RELOC_PCREL_LO16",
633 "BFD_RELOC_MIPS_LITERAL",
634 "BFD_RELOC_MIPS_GOT16",
635 "BFD_RELOC_MIPS_CALL16",
e9f03cd4
ILT		 636 "BFD_RELOC_MIPS_GOT_HI16",
637 "BFD_RELOC_MIPS_GOT_LO16",
b7384d22
ILT		 638 "BFD_RELOC_MIPS_CALL_HI16",
639 "BFD_RELOC_MIPS_CALL_LO16",
0443af31
KR		 640 "BFD_RELOC_386_GOT32",
641 "BFD_RELOC_386_PLT32",
642 "BFD_RELOC_386_COPY",
643 "BFD_RELOC_386_GLOB_DAT",
644 "BFD_RELOC_386_JUMP_SLOT",
645 "BFD_RELOC_386_RELATIVE",
646 "BFD_RELOC_386_GOTOFF",
647 "BFD_RELOC_386_GOTPC",
648 "BFD_RELOC_NS32K_IMM_8",
649 "BFD_RELOC_NS32K_IMM_16",
650 "BFD_RELOC_NS32K_IMM_32",
651 "BFD_RELOC_NS32K_IMM_8_PCREL",
652 "BFD_RELOC_NS32K_IMM_16_PCREL",
653 "BFD_RELOC_NS32K_IMM_32_PCREL",
654 "BFD_RELOC_NS32K_DISP_8",
655 "BFD_RELOC_NS32K_DISP_16",
656 "BFD_RELOC_NS32K_DISP_32",
657 "BFD_RELOC_NS32K_DISP_8_PCREL",
658 "BFD_RELOC_NS32K_DISP_16_PCREL",
659 "BFD_RELOC_NS32K_DISP_32_PCREL",
660 "BFD_RELOC_PPC_B26",
661 "BFD_RELOC_PPC_BA26",
662 "BFD_RELOC_PPC_TOC16",
02f85cda
MM		 663 "BFD_RELOC_PPC_B16",
664 "BFD_RELOC_PPC_B16_BRTAKEN",
665 "BFD_RELOC_PPC_B16_BRNTAKEN",
666 "BFD_RELOC_PPC_BA16",
667 "BFD_RELOC_PPC_BA16_BRTAKEN",
668 "BFD_RELOC_PPC_BA16_BRNTAKEN",
669 "BFD_RELOC_PPC_COPY",
670 "BFD_RELOC_PPC_GLOB_DAT",
671 "BFD_RELOC_PPC_JMP_SLOT",
672 "BFD_RELOC_PPC_RELATIVE",
673 "BFD_RELOC_PPC_LOCAL24PC",
e9f03cd4
ILT		 674 "BFD_RELOC_PPC_EMB_NADDR32",
675 "BFD_RELOC_PPC_EMB_NADDR16",
676 "BFD_RELOC_PPC_EMB_NADDR16_LO",
677 "BFD_RELOC_PPC_EMB_NADDR16_HI",
678 "BFD_RELOC_PPC_EMB_NADDR16_HA",
679 "BFD_RELOC_PPC_EMB_SDAI16",
680 "BFD_RELOC_PPC_EMB_SDA2I16",
681 "BFD_RELOC_PPC_EMB_SDA2REL",
682 "BFD_RELOC_PPC_EMB_SDA21",
683 "BFD_RELOC_PPC_EMB_MRKREF",
684 "BFD_RELOC_PPC_EMB_RELSEC16",
685 "BFD_RELOC_PPC_EMB_RELST_LO",
686 "BFD_RELOC_PPC_EMB_RELST_HI",
687 "BFD_RELOC_PPC_EMB_RELST_HA",
688 "BFD_RELOC_PPC_EMB_BIT_FLD",
689 "BFD_RELOC_PPC_EMB_RELSDA",
0443af31 690 "BFD_RELOC_CTOR",
fca2b81b
KR		 691 "BFD_RELOC_ARM_PCREL_BRANCH",
692 "BFD_RELOC_ARM_IMMEDIATE",
693 "BFD_RELOC_ARM_OFFSET_IMM",
694 "BFD_RELOC_ARM_SHIFT_IMM",
695 "BFD_RELOC_ARM_SWI",
696 "BFD_RELOC_ARM_MULTI",
697 "BFD_RELOC_ARM_CP_OFF_IMM",
4e98461f
SC		 698 "BFD_RELOC_ARM_ADR_IMM",
699 "BFD_RELOC_ARM_LDR_IMM",
700 "BFD_RELOC_ARM_LITERAL",
701 "BFD_RELOC_ARM_IN_POOL",
82b1edf7
KR		 702/* start-sanitize-arc */
703 "BFD_RELOC_ARC_B22_PCREL",
4e98461f 704 "BFD_RELOC_ARC_B26",
82b1edf7 705/* end-sanitize-arc */
0443af31
KR		 706 "@@overflow: BFD_RELOC_UNUSED@@",
707};
708#endif
709
4e98461f 710reloc_howto_type *
fefb4b30 711bfd_default_reloc_type_lookup
57a1867e 712 PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
fefb4b30
JG		 713
714boolean
715bfd_generic_relax_section
716 PARAMS ((bfd *abfd,
d58b7049 717 asection *section,
4c3721d5 718 struct bfd_link_info *,
326e32d7 719 boolean *));
fefb4b30 720
e98e6ec1 721bfd_byte *
fefb4b30 722
287c221d 723bfd_generic_get_relocated_section_contents PARAMS ((bfd *abfd,
4c3721d5
ILT		 724 struct bfd_link_info *link_info,
725 struct bfd_link_order *link_order,
14e3c2e4 726 bfd_byte *data,
4c3721d5
ILT		 727 boolean relocateable,
728 asymbol **symbols));
14e3c2e4 729
2ffbb79a 730extern const bfd_arch_info_type bfd_default_arch_struct;
fefb4b30
JG		 731boolean
732bfd_default_set_arch_mach PARAMS ((bfd *abfd,
e98e6ec1
SC		 733 enum bfd_architecture arch,
734 unsigned long mach));
fefb4b30 735
2ffbb79a 736const bfd_arch_info_type *
fefb4b30 737bfd_default_compatible
2ffbb79a
ILT		 738 PARAMS ((const bfd_arch_info_type *a,
739 const bfd_arch_info_type *b));
fefb4b30
JG		 740
741boolean
2ffbb79a 742bfd_default_scan PARAMS ((const struct bfd_arch_info *info, const char *string));
fefb4b30 743
3ceaa255 744struct elf_internal_shdr *
6affd66a 745bfd_elf_find_section PARAMS ((bfd *abfd, char *name));
fefb4b30 746
GDB Binutils - Deliverables
This page took 0.219854 seconds and 4 git commands to generate.