projects / deliverable / binutils-gdb.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
* as.h (bfd_alloc_by_size_t): Don't declare.
[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.)
c7f8d0a5 3 Copyright 1990, 91, 92, 93, 94, 95, 96, 1997 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)
35a3e78e
ILT		 262#define _bfd_nosymbols_bfd_is_local_label_name \
263 ((boolean (*) PARAMS ((bfd *, const char *))) bfd_false)
6812b607
ILT		 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. */
35a3e78e 342extern boolean bfd_generic_is_local_label_name PARAMS ((bfd *, const char *));
f1cca647 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
372/* Generic add symbol routine. */
373extern boolean _bfd_generic_link_add_symbols
374 PARAMS ((bfd *, struct bfd_link_info *));
375
4335ce64
ILT		 376/* Generic add symbol routine. This version is used by targets for
377 which the linker must collect constructors and destructors by name,
378 as the collect2 program does. */
379extern boolean _bfd_generic_link_add_symbols_collect
380 PARAMS ((bfd *, struct bfd_link_info *));
381
4c3721d5
ILT		 382/* Generic archive add symbol routine. */
383extern boolean _bfd_generic_link_add_archive_symbols
384 PARAMS ((bfd *, struct bfd_link_info *,
385 boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
386
39f27966
JL		 387
388
4c3721d5
ILT		 389/* Forward declaration to avoid prototype errors. */
390typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
391
392/* Generic routine to add a single symbol. */
393extern boolean _bfd_generic_link_add_one_symbol
394 PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
395 asection *, bfd_vma, const char *, boolean copy,
f1cca647 396 boolean constructor, struct bfd_link_hash_entry **));
4c3721d5
ILT		 397
398/* Generic link routine. */
399extern boolean _bfd_generic_final_link
400 PARAMS ((bfd *, struct bfd_link_info *));
401
4e98461f
SC		 402extern boolean _bfd_generic_link_split_section
403 PARAMS ((bfd *, struct sec *));
404
f1cca647
ILT		 405/* Generic reloc_link_order processing routine. */
406extern boolean _bfd_generic_reloc_link_order
407 PARAMS ((bfd *, struct bfd_link_info *, asection *,
408 struct bfd_link_order *));
409
4c3721d5
ILT		 410/* Default link order processing routine. */
411extern boolean _bfd_default_link_order
412 PARAMS ((bfd *, struct bfd_link_info *, asection *,
413 struct bfd_link_order *));
414
f1cca647
ILT		 415/* Count the number of reloc entries in a link order list. */
416extern unsigned int _bfd_count_link_order_relocs
417 PARAMS ((struct bfd_link_order *));
418
4c3721d5
ILT		 419/* Final link relocation routine. */
420extern bfd_reloc_status_type _bfd_final_link_relocate
82b1edf7 421 PARAMS ((reloc_howto_type *, bfd *, asection *, bfd_byte *,
4c3721d5
ILT		 422 bfd_vma address, bfd_vma value, bfd_vma addend));
423
424/* Relocate a particular location by a howto and a value. */
425extern bfd_reloc_status_type _bfd_relocate_contents
82b1edf7 426 PARAMS ((reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
e914ed52 427
50bd50d4
MH		 428/* Link stabs in sections in the first pass. */
429
430extern boolean _bfd_link_section_stabs
431 PARAMS ((bfd *, PTR *, asection *, asection *, PTR *));
432
433/* Write out the .stab section when linking stabs in sections. */
434
435extern boolean _bfd_write_section_stabs
436 PARAMS ((bfd *, asection *, PTR *, bfd_byte *));
437
438/* Write out the .stabstr string table when linking stabs in sections. */
439
440extern boolean _bfd_write_stab_strings PARAMS ((bfd *, PTR *));
441
e914ed52
ILT		 442/* Create a string table. */
443extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
444
64d5f5d0
ILT		 445/* Create an XCOFF .debug section style string table. */
446extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init PARAMS ((void));
447
e914ed52
ILT		 448/* Free a string table. */
449extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
450
451/* Get the size of a string table. */
452extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
453
454/* Add a string to a string table. */
455extern bfd_size_type _bfd_stringtab_add
456 PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
457 boolean copy));
458
459/* Write out a string table. */
460extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
4c3721d5 461\f
4a81b561
DHW		 462/* Macros to tell if bfds are read or write enabled.
463
464 Note that bfds open for read may be scribbled into if the fd passed
465 to bfd_fdopenr is actually open both for read and write
466 simultaneously. However an output bfd will never be open for
467 read. Therefore sometimes you want to check bfd_read_p or
468 !bfd_read_p, and only sometimes bfd_write_p.
469*/
470
287c221d
PB		 471#define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
472#define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
473
c53fac12 474void bfd_assert PARAMS ((const char*,int));
4a81b561 475
4a81b561
DHW		 476#define BFD_ASSERT(x) \
477{ if (!(x)) bfd_assert(__FILE__,__LINE__); }
478
479#define BFD_FAIL() \
480{ bfd_assert(__FILE__,__LINE__); }
481
287c221d 482FILE * bfd_cache_lookup_worker PARAMS ((bfd *));
4a81b561
DHW		 483
484extern bfd *bfd_last_cache;
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
c86158e5
ILT		 509/* Function shared by the COFF and ELF SH backends, which have no
510 other common header files. */
511
512extern boolean _bfd_sh_align_load_span
513 PARAMS ((bfd *, asection *, bfd_byte *,
514 boolean (*) (bfd *, asection *, PTR, bfd_byte *, bfd_vma),
515 PTR, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, boolean *));
516
b8d69097 517/* And more follows */
6f715d66 518
fefb4b30
JG		 519void
520bfd_write_bigendian_4byte_int PARAMS ((bfd *abfd, int i));
521
3ceaa255 522unsigned int
fefb4b30
JG		 523bfd_log2 PARAMS ((bfd_vma x));
524
6f715d66 525#define BFD_CACHE_MAX_OPEN 10
6f715d66 526extern bfd *bfd_last_cache;
e98e6ec1 527
6f715d66 528#define bfd_cache_lookup(x) \
0cda46cf
SC		 529 ((x)==bfd_last_cache? \
530 (FILE*)(bfd_last_cache->iostream): \
531 bfd_cache_lookup_worker(x))
4ee3b9be
JL		 532boolean
533bfd_cache_init PARAMS ((bfd *abfd));
534
fefb4b30 535boolean
c188b0be 536bfd_cache_close PARAMS ((bfd *abfd));
fefb4b30
JG		 537
538FILE*
c188b0be 539bfd_open_file PARAMS ((bfd *abfd));
fefb4b30
JG		 540
541FILE *
c188b0be 542bfd_cache_lookup_worker PARAMS ((bfd *abfd));
fefb4b30 543
0443af31
KR		 544#ifdef _BFD_MAKE_TABLE_bfd_reloc_code_real
545
546static const char *const bfd_reloc_code_real_names[] = { "@@uninitialized@@",
547
548 "BFD_RELOC_64",
549 "BFD_RELOC_32",
550 "BFD_RELOC_26",
c7f8d0a5 551 "BFD_RELOC_24",
0443af31
KR		 552 "BFD_RELOC_16",
553 "BFD_RELOC_14",
554 "BFD_RELOC_8",
555 "BFD_RELOC_64_PCREL",
556 "BFD_RELOC_32_PCREL",
557 "BFD_RELOC_24_PCREL",
558 "BFD_RELOC_16_PCREL",
fca2b81b 559 "BFD_RELOC_12_PCREL",
0443af31 560 "BFD_RELOC_8_PCREL",
4e98461f
SC		 561 "BFD_RELOC_32_GOT_PCREL",
562 "BFD_RELOC_16_GOT_PCREL",
563 "BFD_RELOC_8_GOT_PCREL",
564 "BFD_RELOC_32_GOTOFF",
565 "BFD_RELOC_16_GOTOFF",
02f85cda
MM		 566 "BFD_RELOC_LO16_GOTOFF",
567 "BFD_RELOC_HI16_GOTOFF",
568 "BFD_RELOC_HI16_S_GOTOFF",
4e98461f
SC		 569 "BFD_RELOC_8_GOTOFF",
570 "BFD_RELOC_32_PLT_PCREL",
02f85cda 571 "BFD_RELOC_24_PLT_PCREL",
4e98461f
SC		 572 "BFD_RELOC_16_PLT_PCREL",
573 "BFD_RELOC_8_PLT_PCREL",
574 "BFD_RELOC_32_PLTOFF",
575 "BFD_RELOC_16_PLTOFF",
02f85cda
MM		 576 "BFD_RELOC_LO16_PLTOFF",
577 "BFD_RELOC_HI16_PLTOFF",
578 "BFD_RELOC_HI16_S_PLTOFF",
4e98461f
SC		 579 "BFD_RELOC_8_PLTOFF",
580 "BFD_RELOC_68K_GLOB_DAT",
581 "BFD_RELOC_68K_JMP_SLOT",
582 "BFD_RELOC_68K_RELATIVE",
0443af31
KR		 583 "BFD_RELOC_32_BASEREL",
584 "BFD_RELOC_16_BASEREL",
02f85cda
MM		 585 "BFD_RELOC_LO16_BASEREL",
586 "BFD_RELOC_HI16_BASEREL",
587 "BFD_RELOC_HI16_S_BASEREL",
0443af31 588 "BFD_RELOC_8_BASEREL",
4e98461f 589 "BFD_RELOC_RVA",
0443af31
KR		 590 "BFD_RELOC_8_FFnn",
591 "BFD_RELOC_32_PCREL_S2",
592 "BFD_RELOC_16_PCREL_S2",
593 "BFD_RELOC_23_PCREL_S2",
594 "BFD_RELOC_HI22",
595 "BFD_RELOC_LO10",
596 "BFD_RELOC_GPREL16",
597 "BFD_RELOC_GPREL32",
598 "BFD_RELOC_I960_CALLJ",
599 "BFD_RELOC_NONE",
600 "BFD_RELOC_SPARC_WDISP22",
601 "BFD_RELOC_SPARC22",
602 "BFD_RELOC_SPARC13",
603 "BFD_RELOC_SPARC_GOT10",
604 "BFD_RELOC_SPARC_GOT13",
605 "BFD_RELOC_SPARC_GOT22",
606 "BFD_RELOC_SPARC_PC10",
607 "BFD_RELOC_SPARC_PC22",
608 "BFD_RELOC_SPARC_WPLT30",
609 "BFD_RELOC_SPARC_COPY",
610 "BFD_RELOC_SPARC_GLOB_DAT",
611 "BFD_RELOC_SPARC_JMP_SLOT",
612 "BFD_RELOC_SPARC_RELATIVE",
613 "BFD_RELOC_SPARC_UA32",
614 "BFD_RELOC_SPARC_BASE13",
615 "BFD_RELOC_SPARC_BASE22",
616 "BFD_RELOC_SPARC_10",
617 "BFD_RELOC_SPARC_11",
618 "BFD_RELOC_SPARC_OLO10",
619 "BFD_RELOC_SPARC_HH22",
620 "BFD_RELOC_SPARC_HM10",
621 "BFD_RELOC_SPARC_LM22",
622 "BFD_RELOC_SPARC_PC_HH22",
623 "BFD_RELOC_SPARC_PC_HM10",
624 "BFD_RELOC_SPARC_PC_LM22",
625 "BFD_RELOC_SPARC_WDISP16",
626 "BFD_RELOC_SPARC_WDISP19",
627 "BFD_RELOC_SPARC_GLOB_JMP",
e9f03cd4
ILT		 628 "BFD_RELOC_SPARC_7",
629 "BFD_RELOC_SPARC_6",
630 "BFD_RELOC_SPARC_5",
0443af31
KR		 631 "BFD_RELOC_ALPHA_GPDISP_HI16",
632 "BFD_RELOC_ALPHA_GPDISP_LO16",
50bd50d4 633 "BFD_RELOC_ALPHA_GPDISP",
0443af31 634 "BFD_RELOC_ALPHA_LITERAL",
6b31fd3a 635 "BFD_RELOC_ALPHA_ELF_LITERAL",
0443af31
KR		 636 "BFD_RELOC_ALPHA_LITUSE",
637 "BFD_RELOC_ALPHA_HINT",
50bd50d4 638 "BFD_RELOC_ALPHA_LINKAGE",
fd8d7c31 639 "BFD_RELOC_ALPHA_CODEADDR",
0443af31 640 "BFD_RELOC_MIPS_JMP",
c7f8d0a5 641 "BFD_RELOC_MIPS16_JMP",
a4183ba5 642 "BFD_RELOC_MIPS16_GPREL",
0443af31
KR		 643 "BFD_RELOC_HI16",
644 "BFD_RELOC_HI16_S",
645 "BFD_RELOC_LO16",
646 "BFD_RELOC_PCREL_HI16_S",
647 "BFD_RELOC_PCREL_LO16",
648 "BFD_RELOC_MIPS_LITERAL",
649 "BFD_RELOC_MIPS_GOT16",
650 "BFD_RELOC_MIPS_CALL16",
e9f03cd4
ILT		 651 "BFD_RELOC_MIPS_GOT_HI16",
652 "BFD_RELOC_MIPS_GOT_LO16",
b7384d22
ILT		 653 "BFD_RELOC_MIPS_CALL_HI16",
654 "BFD_RELOC_MIPS_CALL_LO16",
0443af31
KR		 655 "BFD_RELOC_386_GOT32",
656 "BFD_RELOC_386_PLT32",
657 "BFD_RELOC_386_COPY",
658 "BFD_RELOC_386_GLOB_DAT",
659 "BFD_RELOC_386_JUMP_SLOT",
660 "BFD_RELOC_386_RELATIVE",
661 "BFD_RELOC_386_GOTOFF",
662 "BFD_RELOC_386_GOTPC",
663 "BFD_RELOC_NS32K_IMM_8",
664 "BFD_RELOC_NS32K_IMM_16",
665 "BFD_RELOC_NS32K_IMM_32",
666 "BFD_RELOC_NS32K_IMM_8_PCREL",
667 "BFD_RELOC_NS32K_IMM_16_PCREL",
668 "BFD_RELOC_NS32K_IMM_32_PCREL",
669 "BFD_RELOC_NS32K_DISP_8",
670 "BFD_RELOC_NS32K_DISP_16",
671 "BFD_RELOC_NS32K_DISP_32",
672 "BFD_RELOC_NS32K_DISP_8_PCREL",
673 "BFD_RELOC_NS32K_DISP_16_PCREL",
674 "BFD_RELOC_NS32K_DISP_32_PCREL",
675 "BFD_RELOC_PPC_B26",
676 "BFD_RELOC_PPC_BA26",
677 "BFD_RELOC_PPC_TOC16",
02f85cda
MM		 678 "BFD_RELOC_PPC_B16",
679 "BFD_RELOC_PPC_B16_BRTAKEN",
680 "BFD_RELOC_PPC_B16_BRNTAKEN",
681 "BFD_RELOC_PPC_BA16",
682 "BFD_RELOC_PPC_BA16_BRTAKEN",
683 "BFD_RELOC_PPC_BA16_BRNTAKEN",
684 "BFD_RELOC_PPC_COPY",
685 "BFD_RELOC_PPC_GLOB_DAT",
686 "BFD_RELOC_PPC_JMP_SLOT",
687 "BFD_RELOC_PPC_RELATIVE",
688 "BFD_RELOC_PPC_LOCAL24PC",
e9f03cd4
ILT		 689 "BFD_RELOC_PPC_EMB_NADDR32",
690 "BFD_RELOC_PPC_EMB_NADDR16",
691 "BFD_RELOC_PPC_EMB_NADDR16_LO",
692 "BFD_RELOC_PPC_EMB_NADDR16_HI",
693 "BFD_RELOC_PPC_EMB_NADDR16_HA",
694 "BFD_RELOC_PPC_EMB_SDAI16",
695 "BFD_RELOC_PPC_EMB_SDA2I16",
696 "BFD_RELOC_PPC_EMB_SDA2REL",
697 "BFD_RELOC_PPC_EMB_SDA21",
698 "BFD_RELOC_PPC_EMB_MRKREF",
699 "BFD_RELOC_PPC_EMB_RELSEC16",
700 "BFD_RELOC_PPC_EMB_RELST_LO",
701 "BFD_RELOC_PPC_EMB_RELST_HI",
702 "BFD_RELOC_PPC_EMB_RELST_HA",
703 "BFD_RELOC_PPC_EMB_BIT_FLD",
704 "BFD_RELOC_PPC_EMB_RELSDA",
0443af31 705 "BFD_RELOC_CTOR",
fca2b81b
KR		 706 "BFD_RELOC_ARM_PCREL_BRANCH",
707 "BFD_RELOC_ARM_IMMEDIATE",
708 "BFD_RELOC_ARM_OFFSET_IMM",
709 "BFD_RELOC_ARM_SHIFT_IMM",
710 "BFD_RELOC_ARM_SWI",
711 "BFD_RELOC_ARM_MULTI",
712 "BFD_RELOC_ARM_CP_OFF_IMM",
4e98461f
SC		 713 "BFD_RELOC_ARM_ADR_IMM",
714 "BFD_RELOC_ARM_LDR_IMM",
715 "BFD_RELOC_ARM_LITERAL",
716 "BFD_RELOC_ARM_IN_POOL",
d1b40d8e
JSC		 717 "BFD_RELOC_ARM_OFFSET_IMM8",
718 "BFD_RELOC_ARM_HWLITERAL",
c86158e5
ILT		 719 "BFD_RELOC_ARM_THUMB_ADD",
720 "BFD_RELOC_ARM_THUMB_IMM",
721 "BFD_RELOC_ARM_THUMB_SHIFT",
722 "BFD_RELOC_ARM_THUMB_OFFSET",
723 "BFD_RELOC_SH_PCDISP8BY2",
724 "BFD_RELOC_SH_PCDISP12BY2",
725 "BFD_RELOC_SH_IMM4",
726 "BFD_RELOC_SH_IMM4BY2",
727 "BFD_RELOC_SH_IMM4BY4",
728 "BFD_RELOC_SH_IMM8",
729 "BFD_RELOC_SH_IMM8BY2",
730 "BFD_RELOC_SH_IMM8BY4",
731 "BFD_RELOC_SH_PCRELIMM8BY2",
732 "BFD_RELOC_SH_PCRELIMM8BY4",
733 "BFD_RELOC_SH_SWITCH16",
734 "BFD_RELOC_SH_SWITCH32",
735 "BFD_RELOC_SH_USES",
736 "BFD_RELOC_SH_COUNT",
737 "BFD_RELOC_SH_ALIGN",
738 "BFD_RELOC_SH_CODE",
739 "BFD_RELOC_SH_DATA",
740 "BFD_RELOC_SH_LABEL",
82b1edf7
KR		 741/* start-sanitize-arc */
742 "BFD_RELOC_ARC_B22_PCREL",
4e98461f 743 "BFD_RELOC_ARC_B26",
82b1edf7 744/* end-sanitize-arc */
50bd50d4 745
50bd50d4 746 "BFD_RELOC_D10V_10_PCREL_R",
0f612729 747 "BFD_RELOC_D10V_10_PCREL_L",
50bd50d4
MH		 748 "BFD_RELOC_D10V_18",
749 "BFD_RELOC_D10V_18_PCREL",
50bd50d4 750
fd8d7c31
MH		 751/* start-sanitize-d30v */
752 "BFD_RELOC_D30V_6",
753 "BFD_RELOC_D30V_15",
754 "BFD_RELOC_D30V_15_PCREL",
755 "BFD_RELOC_D30V_21",
756 "BFD_RELOC_D30V_21_PCREL",
757 "BFD_RELOC_D30V_32",
758 "BFD_RELOC_D30V_32_PCREL",
759/* end-sanitize-d30v */
760
6b31fd3a 761/* start-sanitize-m32r */
c7f8d0a5
ILT		 762 "BFD_RELOC_M32R_24",
763 "BFD_RELOC_M32R_10_PCREL",
764 "BFD_RELOC_M32R_18_PCREL",
765 "BFD_RELOC_M32R_26_PCREL",
1d5c6cfd
DE		 766 "BFD_RELOC_M32R_HI16_ULO",
767 "BFD_RELOC_M32R_HI16_SLO",
768 "BFD_RELOC_M32R_LO16",
35a3e78e 769 "BFD_RELOC_M32R_SDA16",
6b31fd3a
ILT		 770/* end-sanitize-m32r */
771
772/* start-sanitize-v850 */
773 "BFD_RELOC_V850_9_PCREL",
774 "BFD_RELOC_V850_22_PCREL",
b6d08fce
JL		 775 "BFD_RELOC_V850_SDA_OFFSET",
776 "BFD_RELOC_V850_ZDA_OFFSET",
777 "BFD_RELOC_V850_TDA_OFFSET",
6b31fd3a
ILT		 778/* end-sanitize-v850 */
779
c7f8d0a5
ILT		 780 "BFD_RELOC_MN10300_32_PCREL",
781 "BFD_RELOC_MN10300_16_PCREL",
0443af31
KR		 782 "@@overflow: BFD_RELOC_UNUSED@@",
783};
784#endif
785
4e98461f 786reloc_howto_type *
fefb4b30 787bfd_default_reloc_type_lookup
57a1867e 788 PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
fefb4b30
JG		 789
790boolean
791bfd_generic_relax_section
792 PARAMS ((bfd *abfd,
d58b7049 793 asection *section,
4c3721d5 794 struct bfd_link_info *,
326e32d7 795 boolean *));
fefb4b30 796
e98e6ec1 797bfd_byte *
fefb4b30 798
287c221d 799bfd_generic_get_relocated_section_contents PARAMS ((bfd *abfd,
4c3721d5
ILT		 800 struct bfd_link_info *link_info,
801 struct bfd_link_order *link_order,
14e3c2e4 802 bfd_byte *data,
4c3721d5
ILT		 803 boolean relocateable,
804 asymbol **symbols));
14e3c2e4 805
2ffbb79a 806extern const bfd_arch_info_type bfd_default_arch_struct;
fefb4b30
JG		 807boolean
808bfd_default_set_arch_mach PARAMS ((bfd *abfd,
e98e6ec1
SC		 809 enum bfd_architecture arch,
810 unsigned long mach));
fefb4b30 811
2ffbb79a 812const bfd_arch_info_type *
fefb4b30 813bfd_default_compatible
2ffbb79a
ILT		 814 PARAMS ((const bfd_arch_info_type *a,
815 const bfd_arch_info_type *b));
fefb4b30
JG		 816
817boolean
2ffbb79a 818bfd_default_scan PARAMS ((const struct bfd_arch_info *info, const char *string));
fefb4b30 819
3ceaa255 820struct elf_internal_shdr *
6affd66a 821bfd_elf_find_section PARAMS ((bfd *abfd, char *name));
fefb4b30 822
GDB Binutils - Deliverables
This page took 0.250782 seconds and 4 git commands to generate.