projects / deliverable / binutils-gdb.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Fixed disassembler to use processor type when decoding instructions.
[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
37bdd624 90/* These routines allocate and free things on the BFD's objalloc. */
4a81b561 91
37bdd624
DE		 92extern PTR bfd_alloc PARAMS ((bfd *, size_t));
93extern PTR bfd_zalloc PARAMS ((bfd *, size_t));
94extern void bfd_release PARAMS ((bfd *, PTR));
287c221d 95
287c221d 96bfd * _bfd_create_empty_archive_element_shell PARAMS ((bfd *obfd));
f4bd7a8f 97bfd * _bfd_look_for_bfd_in_cache PARAMS ((bfd *arch_bfd, file_ptr index));
b59f0276 98boolean _bfd_add_bfd_to_archive_cache PARAMS ((bfd *, file_ptr, bfd *));
287c221d 99boolean _bfd_generic_mkarchive PARAMS ((bfd *abfd));
e914ed52 100const bfd_target *bfd_generic_archive_p PARAMS ((bfd *abfd));
287c221d 101boolean bfd_slurp_armap PARAMS ((bfd *abfd));
898728d4 102boolean bfd_slurp_bsd_armap_f2 PARAMS ((bfd *abfd));
287c221d
PB		 103#define bfd_slurp_bsd_armap bfd_slurp_armap
104#define bfd_slurp_coff_armap bfd_slurp_armap
105boolean _bfd_slurp_extended_name_table PARAMS ((bfd *abfd));
fca2b81b
KR		 106extern boolean _bfd_construct_extended_name_table
107 PARAMS ((bfd *, boolean, char **, bfd_size_type *));
287c221d 108boolean _bfd_write_archive_contents PARAMS ((bfd *abfd));
c53fac12 109boolean _bfd_compute_and_write_armap PARAMS ((bfd *, unsigned int elength));
f4bd7a8f 110bfd *_bfd_get_elt_at_filepos PARAMS ((bfd *archive, file_ptr filepos));
64d5f5d0 111extern bfd *_bfd_generic_get_elt_at_index PARAMS ((bfd *, symindex));
f4bd7a8f 112bfd * _bfd_new_bfd PARAMS ((void));
4a81b561 113
287c221d
PB		 114boolean bfd_false PARAMS ((bfd *ignore));
115boolean bfd_true PARAMS ((bfd *ignore));
116PTR bfd_nullvoidptr PARAMS ((bfd *ignore));
117int bfd_0 PARAMS ((bfd *ignore));
118unsigned int bfd_0u PARAMS ((bfd *ignore));
326e32d7 119long bfd_0l PARAMS ((bfd *ignore));
6812b607 120long _bfd_n1 PARAMS ((bfd *ignore));
287c221d
PB		 121void bfd_void PARAMS ((bfd *ignore));
122
e914ed52
ILT		 123bfd *_bfd_new_bfd_contained_in PARAMS ((bfd *));
124const bfd_target *_bfd_dummy_target PARAMS ((bfd *abfd));
4a81b561 125
287c221d 126void bfd_dont_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 127 char *hdr));
287c221d 128void bfd_bsd_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 129 char *hdr));
287c221d 130void bfd_gnu_truncate_arname PARAMS ((bfd *abfd, CONST char *filename,
69ebee86 131 char *hdr));
4a81b561 132
287c221d 133boolean bsd_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 134 struct orl *map, unsigned int orl_count, int stridx));
4a81b561 135
287c221d 136boolean coff_write_armap PARAMS ((bfd *arch, unsigned int elength,
01dd1b2b 137 struct orl *map, unsigned int orl_count, int stridx));
4a81b561 138
c53fac12
ILT		 139extern PTR _bfd_generic_read_ar_hdr PARAMS ((bfd *));
140
64d5f5d0
ILT		 141extern PTR _bfd_generic_read_ar_hdr_mag PARAMS ((bfd *, const char *));
142
287c221d 143bfd * bfd_generic_openr_next_archived_file PARAMS ((bfd *archive,
2203f786 144 bfd *last_file));
4a81b561 145
287c221d 146int bfd_generic_stat_arch_elt PARAMS ((bfd *, struct stat *));
fc723380 147
c53fac12 148#define _bfd_read_ar_hdr(abfd) \
64d5f5d0 149 BFD_SEND (abfd, _bfd_read_ar_hdr_fn, (abfd))
6812b607
ILT		 150\f
151/* Generic routines to use for BFD_JUMP_TABLE_GENERIC. Use
152 BFD_JUMP_TABLE_GENERIC (_bfd_generic). */
153
154#define _bfd_generic_close_and_cleanup bfd_true
155#define _bfd_generic_bfd_free_cached_info bfd_true
156#define _bfd_generic_new_section_hook \
157 ((boolean (*) PARAMS ((bfd *, asection *))) bfd_true)
158extern boolean _bfd_generic_get_section_contents
159 PARAMS ((bfd *, asection *, PTR location, file_ptr offset,
160 bfd_size_type count));
64d5f5d0
ILT		 161extern boolean _bfd_generic_get_section_contents_in_window
162 PARAMS ((bfd *, asection *, bfd_window *, file_ptr, bfd_size_type));
6812b607
ILT		 163
164/* Generic routines to use for BFD_JUMP_TABLE_COPY. Use
165 BFD_JUMP_TABLE_COPY (_bfd_generic). */
166
167#define _bfd_generic_bfd_copy_private_bfd_data \
168 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
4e98461f
SC		 169#define _bfd_generic_bfd_merge_private_bfd_data \
170 ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
171#define _bfd_generic_bfd_set_private_flags \
172 ((boolean (*) PARAMS ((bfd *, flagword))) bfd_true)
6812b607
ILT		 173#define _bfd_generic_bfd_copy_private_section_data \
174 ((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
4e98461f
SC		 175#define _bfd_generic_bfd_copy_private_symbol_data \
176 ((boolean (*) PARAMS ((bfd *, asymbol *, bfd *, asymbol *))) bfd_true)
177#define _bfd_generic_bfd_print_private_bfd_data \
64d5f5d0 178 ((boolean (*) PARAMS ((bfd *, PTR))) bfd_true)
6812b607
ILT		 179
180/* Routines to use for BFD_JUMP_TABLE_CORE when there is no core file
181 support. Use BFD_JUMP_TABLE_CORE (_bfd_nocore). */
182
183extern char *_bfd_nocore_core_file_failing_command PARAMS ((bfd *));
184extern int _bfd_nocore_core_file_failing_signal PARAMS ((bfd *));
185extern boolean _bfd_nocore_core_file_matches_executable_p
186 PARAMS ((bfd *, bfd *));
187
188/* Routines to use for BFD_JUMP_TABLE_ARCHIVE when there is no archive
189 file support. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_noarchive). */
190
191#define _bfd_noarchive_slurp_armap bfd_false
192#define _bfd_noarchive_slurp_extended_name_table bfd_false
fca2b81b
KR		 193#define _bfd_noarchive_construct_extended_name_table \
194 ((boolean (*) PARAMS ((bfd *, char **, bfd_size_type *, const char **))) \
195 bfd_false)
6812b607
ILT		 196#define _bfd_noarchive_truncate_arname \
197 ((void (*) PARAMS ((bfd *, const char *, char *))) bfd_void)
198#define _bfd_noarchive_write_armap \
199 ((boolean (*) \
200 PARAMS ((bfd *, unsigned int, struct orl *, unsigned int, int))) \
201 bfd_false)
c53fac12 202#define _bfd_noarchive_read_ar_hdr bfd_nullvoidptr
6812b607
ILT		 203#define _bfd_noarchive_openr_next_archived_file \
204 ((bfd *(*) PARAMS ((bfd *, bfd *))) bfd_nullvoidptr)
64d5f5d0
ILT		 205#define _bfd_noarchive_get_elt_at_index \
206 ((bfd *(*) PARAMS ((bfd *, symindex))) bfd_nullvoidptr)
6812b607 207#define _bfd_noarchive_generic_stat_arch_elt bfd_generic_stat_arch_elt
0443af31 208#define _bfd_noarchive_update_armap_timestamp bfd_false
6812b607
ILT		 209
210/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get BSD style
211 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_bsd). */
212
213#define _bfd_archive_bsd_slurp_armap bfd_slurp_bsd_armap
214#define _bfd_archive_bsd_slurp_extended_name_table \
215 _bfd_slurp_extended_name_table
fca2b81b
KR		 216extern boolean _bfd_archive_bsd_construct_extended_name_table
217 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT		 218#define _bfd_archive_bsd_truncate_arname bfd_bsd_truncate_arname
219#define _bfd_archive_bsd_write_armap bsd_write_armap
c53fac12 220#define _bfd_archive_bsd_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT		 221#define _bfd_archive_bsd_openr_next_archived_file \
222 bfd_generic_openr_next_archived_file
64d5f5d0 223#define _bfd_archive_bsd_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT		 224#define _bfd_archive_bsd_generic_stat_arch_elt \
225 bfd_generic_stat_arch_elt
0443af31 226extern boolean _bfd_archive_bsd_update_armap_timestamp PARAMS ((bfd *));
6812b607
ILT		 227
228/* Routines to use for BFD_JUMP_TABLE_ARCHIVE to get COFF style
229 archives. Use BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff). */
230
231#define _bfd_archive_coff_slurp_armap bfd_slurp_coff_armap
232#define _bfd_archive_coff_slurp_extended_name_table \
233 _bfd_slurp_extended_name_table
fca2b81b
KR		 234extern boolean _bfd_archive_coff_construct_extended_name_table
235 PARAMS ((bfd *, char **, bfd_size_type *, const char **));
6812b607
ILT		 236#define _bfd_archive_coff_truncate_arname bfd_dont_truncate_arname
237#define _bfd_archive_coff_write_armap coff_write_armap
c53fac12 238#define _bfd_archive_coff_read_ar_hdr _bfd_generic_read_ar_hdr
6812b607
ILT		 239#define _bfd_archive_coff_openr_next_archived_file \
240 bfd_generic_openr_next_archived_file
64d5f5d0 241#define _bfd_archive_coff_get_elt_at_index _bfd_generic_get_elt_at_index
6812b607
ILT		 242#define _bfd_archive_coff_generic_stat_arch_elt \
243 bfd_generic_stat_arch_elt
0443af31 244#define _bfd_archive_coff_update_armap_timestamp bfd_true
6812b607
ILT		 245
246/* Routines to use for BFD_JUMP_TABLE_SYMBOLS where there is no symbol
247 support. Use BFD_JUMP_TABLE_SYMBOLS (_bfd_nosymbols). */
248
249#define _bfd_nosymbols_get_symtab_upper_bound _bfd_n1
250#define _bfd_nosymbols_get_symtab \
251 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
252#define _bfd_nosymbols_make_empty_symbol \
253 ((asymbol *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
254#define _bfd_nosymbols_print_symbol \
255 ((void (*) PARAMS ((bfd *, PTR, asymbol *, bfd_print_symbol_type))) bfd_void)
256#define _bfd_nosymbols_get_symbol_info \
257 ((void (*) PARAMS ((bfd *, asymbol *, symbol_info *))) bfd_void)
35a3e78e
ILT		 258#define _bfd_nosymbols_bfd_is_local_label_name \
259 ((boolean (*) PARAMS ((bfd *, const char *))) bfd_false)
6812b607
ILT		 260#define _bfd_nosymbols_get_lineno \
261 ((alent *(*) PARAMS ((bfd *, asymbol *))) bfd_nullvoidptr)
262#define _bfd_nosymbols_find_nearest_line \
263 ((boolean (*) \
264 PARAMS ((bfd *, asection *, asymbol **, bfd_vma, const char **, \
265 const char **, unsigned int *))) \
266 bfd_false)
267#define _bfd_nosymbols_bfd_make_debug_symbol \
268 ((asymbol *(*) PARAMS ((bfd *, PTR, unsigned long))) bfd_nullvoidptr)
4e98461f
SC		 269#define _bfd_nosymbols_read_minisymbols \
270 ((long (*) PARAMS ((bfd *, boolean, PTR *, unsigned int *))) _bfd_n1)
271#define _bfd_nosymbols_minisymbol_to_symbol \
272 ((asymbol *(*) PARAMS ((bfd *, boolean, const PTR, asymbol *))) \
273 bfd_nullvoidptr)
6812b607
ILT		 274
275/* Routines to use for BFD_JUMP_TABLE_RELOCS when there is no reloc
276 support. Use BFD_JUMP_TABLE_RELOCS (_bfd_norelocs). */
277
278#define _bfd_norelocs_get_reloc_upper_bound \
279 ((long (*) PARAMS ((bfd *, asection *))) _bfd_n1)
280#define _bfd_norelocs_canonicalize_reloc \
281 ((long (*) PARAMS ((bfd *, asection *, arelent **, asymbol **))) _bfd_n1)
282#define _bfd_norelocs_bfd_reloc_type_lookup \
82b1edf7 283 ((reloc_howto_type *(*) PARAMS ((bfd *, bfd_reloc_code_real_type))) \
6812b607
ILT		 284 bfd_nullvoidptr)
285
286/* Routines to use for BFD_JUMP_TABLE_WRITE for targets which may not
287 be written. Use BFD_JUMP_TABLE_WRITE (_bfd_nowrite). */
288
289#define _bfd_nowrite_set_arch_mach \
290 ((boolean (*) PARAMS ((bfd *, enum bfd_architecture, unsigned long))) \
291 bfd_false)
292#define _bfd_nowrite_set_section_contents \
293 ((boolean (*) PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type))) \
294 bfd_false)
295
296/* Generic routines to use for BFD_JUMP_TABLE_WRITE. Use
297 BFD_JUMP_TABLE_WRITE (_bfd_generic). */
298
299#define _bfd_generic_set_arch_mach bfd_default_set_arch_mach
300extern boolean _bfd_generic_set_section_contents
301 PARAMS ((bfd *, asection *, PTR, file_ptr, bfd_size_type));
302
303/* Routines to use for BFD_JUMP_TABLE_LINK for targets which do not
304 support linking. Use BFD_JUMP_TABLE_LINK (_bfd_nolink). */
305
306#define _bfd_nolink_sizeof_headers ((int (*) PARAMS ((bfd *, boolean))) bfd_0)
307#define _bfd_nolink_bfd_get_relocated_section_contents \
308 ((bfd_byte *(*) \
309 PARAMS ((bfd *, struct bfd_link_info *, struct bfd_link_order *, \
310 bfd_byte *, boolean, asymbol **))) \
311 bfd_nullvoidptr)
312#define _bfd_nolink_bfd_relax_section \
313 ((boolean (*) \
314 PARAMS ((bfd *, asection *, struct bfd_link_info *, boolean *))) \
315 bfd_false)
316#define _bfd_nolink_bfd_link_hash_table_create \
317 ((struct bfd_link_hash_table *(*) PARAMS ((bfd *))) bfd_nullvoidptr)
318#define _bfd_nolink_bfd_link_add_symbols \
319 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
320#define _bfd_nolink_bfd_final_link \
321 ((boolean (*) PARAMS ((bfd *, struct bfd_link_info *))) bfd_false)
4e98461f
SC		 322#define _bfd_nolink_bfd_link_split_section \
323 ((boolean (*) PARAMS ((bfd *, struct sec *))) bfd_false)
4ee3b9be
JL		 324
325/* Routines to use for BFD_JUMP_TABLE_DYNAMIC for targets which do not
326 have dynamic symbols or relocs. Use BFD_JUMP_TABLE_DYNAMIC
327 (_bfd_nodynamic). */
328
329#define _bfd_nodynamic_get_dynamic_symtab_upper_bound _bfd_n1
330#define _bfd_nodynamic_canonicalize_dynamic_symtab \
331 ((long (*) PARAMS ((bfd *, asymbol **))) _bfd_n1)
332#define _bfd_nodynamic_get_dynamic_reloc_upper_bound _bfd_n1
333#define _bfd_nodynamic_canonicalize_dynamic_reloc \
334 ((long (*) PARAMS ((bfd *, arelent **, asymbol **))) _bfd_n1)
4c3721d5 335\f
f1cca647
ILT		 336/* Generic routine to determine of the given symbol is a local
337 label. */
35a3e78e 338extern boolean bfd_generic_is_local_label_name PARAMS ((bfd *, const char *));
f1cca647 339
4e98461f
SC		 340/* Generic minisymbol routines. */
341extern long _bfd_generic_read_minisymbols
342 PARAMS ((bfd *, boolean, PTR *, unsigned int *));
343extern asymbol *_bfd_generic_minisymbol_to_symbol
344 PARAMS ((bfd *, boolean, const PTR, asymbol *));
345
e9f03cd4
ILT		 346/* Find the nearest line using .stab/.stabstr sections. */
347extern boolean _bfd_stab_section_find_nearest_line
348 PARAMS ((bfd *, asymbol **, asection *, bfd_vma, boolean *, const char **,
349 const char **, unsigned int *, PTR *));
350
4c3721d5
ILT		 351/* A routine to create entries for a bfd_link_hash_table. */
352extern struct bfd_hash_entry *_bfd_link_hash_newfunc
353 PARAMS ((struct bfd_hash_entry *entry,
354 struct bfd_hash_table *table,
355 const char *string));
356
357/* Initialize a bfd_link_hash_table. */
358extern boolean _bfd_link_hash_table_init
359 PARAMS ((struct bfd_link_hash_table *, bfd *,
360 struct bfd_hash_entry *(*) (struct bfd_hash_entry *,
361 struct bfd_hash_table *,
362 const char *)));
363
364/* Generic link hash table creation routine. */
365extern struct bfd_link_hash_table *_bfd_generic_link_hash_table_create
366 PARAMS ((bfd *));
367
368/* Generic add symbol routine. */
369extern boolean _bfd_generic_link_add_symbols
370 PARAMS ((bfd *, struct bfd_link_info *));
371
4335ce64
ILT		 372/* Generic add symbol routine. This version is used by targets for
373 which the linker must collect constructors and destructors by name,
374 as the collect2 program does. */
375extern boolean _bfd_generic_link_add_symbols_collect
376 PARAMS ((bfd *, struct bfd_link_info *));
377
4c3721d5
ILT		 378/* Generic archive add symbol routine. */
379extern boolean _bfd_generic_link_add_archive_symbols
380 PARAMS ((bfd *, struct bfd_link_info *,
381 boolean (*checkfn) (bfd *, struct bfd_link_info *, boolean *)));
382
39f27966
JL		 383
384
4c3721d5
ILT		 385/* Forward declaration to avoid prototype errors. */
386typedef struct bfd_link_hash_entry _bfd_link_hash_entry;
387
388/* Generic routine to add a single symbol. */
389extern boolean _bfd_generic_link_add_one_symbol
390 PARAMS ((struct bfd_link_info *, bfd *, const char *name, flagword,
391 asection *, bfd_vma, const char *, boolean copy,
f1cca647 392 boolean constructor, struct bfd_link_hash_entry **));
4c3721d5
ILT		 393
394/* Generic link routine. */
395extern boolean _bfd_generic_final_link
396 PARAMS ((bfd *, struct bfd_link_info *));
397
4e98461f
SC		 398extern boolean _bfd_generic_link_split_section
399 PARAMS ((bfd *, struct sec *));
400
f1cca647
ILT		 401/* Generic reloc_link_order processing routine. */
402extern boolean _bfd_generic_reloc_link_order
403 PARAMS ((bfd *, struct bfd_link_info *, asection *,
404 struct bfd_link_order *));
405
4c3721d5
ILT		 406/* Default link order processing routine. */
407extern boolean _bfd_default_link_order
408 PARAMS ((bfd *, struct bfd_link_info *, asection *,
409 struct bfd_link_order *));
410
f1cca647
ILT		 411/* Count the number of reloc entries in a link order list. */
412extern unsigned int _bfd_count_link_order_relocs
413 PARAMS ((struct bfd_link_order *));
414
4c3721d5
ILT		 415/* Final link relocation routine. */
416extern bfd_reloc_status_type _bfd_final_link_relocate
82b1edf7 417 PARAMS ((reloc_howto_type *, bfd *, asection *, bfd_byte *,
4c3721d5
ILT		 418 bfd_vma address, bfd_vma value, bfd_vma addend));
419
420/* Relocate a particular location by a howto and a value. */
421extern bfd_reloc_status_type _bfd_relocate_contents
82b1edf7 422 PARAMS ((reloc_howto_type *, bfd *, bfd_vma, bfd_byte *));
e914ed52 423
50bd50d4
MH		 424/* Link stabs in sections in the first pass. */
425
426extern boolean _bfd_link_section_stabs
427 PARAMS ((bfd *, PTR *, asection *, asection *, PTR *));
428
429/* Write out the .stab section when linking stabs in sections. */
430
431extern boolean _bfd_write_section_stabs
3cd5cf3d 432 PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_byte *));
50bd50d4
MH		 433
434/* Write out the .stabstr string table when linking stabs in sections. */
435
436extern boolean _bfd_write_stab_strings PARAMS ((bfd *, PTR *));
437
48e509bf
NC		 438/* Find an offset within a .stab section when linking stabs in
439 sections. */
440
441extern bfd_vma _bfd_stab_section_offset
442 PARAMS ((bfd *, PTR *, asection *, PTR *, bfd_vma));
443
e914ed52
ILT		 444/* Create a string table. */
445extern struct bfd_strtab_hash *_bfd_stringtab_init PARAMS ((void));
446
64d5f5d0
ILT		 447/* Create an XCOFF .debug section style string table. */
448extern struct bfd_strtab_hash *_bfd_xcoff_stringtab_init PARAMS ((void));
449
e914ed52
ILT		 450/* Free a string table. */
451extern void _bfd_stringtab_free PARAMS ((struct bfd_strtab_hash *));
452
453/* Get the size of a string table. */
454extern bfd_size_type _bfd_stringtab_size PARAMS ((struct bfd_strtab_hash *));
455
456/* Add a string to a string table. */
457extern bfd_size_type _bfd_stringtab_add
458 PARAMS ((struct bfd_strtab_hash *, const char *, boolean hash,
459 boolean copy));
460
461/* Write out a string table. */
462extern boolean _bfd_stringtab_emit PARAMS ((bfd *, struct bfd_strtab_hash *));
4c3721d5 463\f
4a81b561
DHW		 464/* Macros to tell if bfds are read or write enabled.
465
466 Note that bfds open for read may be scribbled into if the fd passed
467 to bfd_fdopenr is actually open both for read and write
468 simultaneously. However an output bfd will never be open for
469 read. Therefore sometimes you want to check bfd_read_p or
470 !bfd_read_p, and only sometimes bfd_write_p.
471*/
472
287c221d
PB		 473#define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
474#define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
475
c53fac12 476void bfd_assert PARAMS ((const char*,int));
4a81b561 477
4a81b561
DHW		 478#define BFD_ASSERT(x) \
479{ if (!(x)) bfd_assert(__FILE__,__LINE__); }
480
481#define BFD_FAIL() \
482{ bfd_assert(__FILE__,__LINE__); }
483
287c221d 484FILE * bfd_cache_lookup_worker PARAMS ((bfd *));
4a81b561
DHW		 485
486extern bfd *bfd_last_cache;
69ebee86 487
4c3721d5 488/* List of supported target vectors, and the default vector (if
f4bd7a8f 489 bfd_default_vector[0] is NULL, there is no default). */
e914ed52 490extern const bfd_target * const bfd_target_vector[];
50ede03d 491extern const bfd_target *bfd_default_vector[];
4c3721d5 492
02f85cda 493/* Functions shared by the ECOFF and MIPS ELF backends, which have no
4e98461f
SC		 494 other common header files. */
495
496#if defined(__STDC__) || defined(ALMOST_STDC)
497struct ecoff_find_line;
498#endif
499
02f85cda 500extern boolean _bfd_ecoff_locate_line
4e98461f
SC		 501 PARAMS ((bfd *, asection *, bfd_vma, struct ecoff_debug_info * const,
502 const struct ecoff_debug_swap * const, struct ecoff_find_line *,
503 const char **, const char **, unsigned int *));
02f85cda
MM		 504extern boolean _bfd_ecoff_get_accumulated_pdr PARAMS ((PTR, bfd_byte *));
505extern boolean _bfd_ecoff_get_accumulated_sym PARAMS ((PTR, bfd_byte *));
506extern boolean _bfd_ecoff_get_accumulated_ss PARAMS ((PTR, bfd_byte *));
4e98461f 507
39f27966
JL		 508extern bfd_vma _bfd_get_gp_value PARAMS ((bfd *));
509extern void _bfd_set_gp_value PARAMS ((bfd *, bfd_vma));
510
c86158e5
ILT		 511/* Function shared by the COFF and ELF SH backends, which have no
512 other common header files. */
513
514extern boolean _bfd_sh_align_load_span
515 PARAMS ((bfd *, asection *, bfd_byte *,
516 boolean (*) (bfd *, asection *, PTR, bfd_byte *, bfd_vma),
517 PTR, bfd_vma **, bfd_vma *, bfd_vma, bfd_vma, boolean *));
518
b8d69097 519/* And more follows */
6f715d66 520
fefb4b30
JG		 521void
522bfd_write_bigendian_4byte_int PARAMS ((bfd *abfd, int i));
523
3ceaa255 524unsigned int
fefb4b30
JG		 525bfd_log2 PARAMS ((bfd_vma x));
526
6f715d66 527#define BFD_CACHE_MAX_OPEN 10
6f715d66 528extern bfd *bfd_last_cache;
e98e6ec1 529
6f715d66 530#define bfd_cache_lookup(x) \
0cda46cf
SC		 531 ((x)==bfd_last_cache? \
532 (FILE*)(bfd_last_cache->iostream): \
533 bfd_cache_lookup_worker(x))
4ee3b9be
JL		 534boolean
535bfd_cache_init PARAMS ((bfd *abfd));
536
fefb4b30 537boolean
c188b0be 538bfd_cache_close PARAMS ((bfd *abfd));
fefb4b30
JG		 539
540FILE*
c188b0be 541bfd_open_file PARAMS ((bfd *abfd));
fefb4b30
JG		 542
543FILE *
c188b0be 544bfd_cache_lookup_worker PARAMS ((bfd *abfd));
fefb4b30 545
0443af31
KR		 546#ifdef _BFD_MAKE_TABLE_bfd_reloc_code_real
547
548static const char *const bfd_reloc_code_real_names[] = { "@@uninitialized@@",
549
550 "BFD_RELOC_64",
551 "BFD_RELOC_32",
552 "BFD_RELOC_26",
c7f8d0a5 553 "BFD_RELOC_24",
0443af31
KR		 554 "BFD_RELOC_16",
555 "BFD_RELOC_14",
556 "BFD_RELOC_8",
557 "BFD_RELOC_64_PCREL",
558 "BFD_RELOC_32_PCREL",
559 "BFD_RELOC_24_PCREL",
560 "BFD_RELOC_16_PCREL",
fca2b81b 561 "BFD_RELOC_12_PCREL",
0443af31 562 "BFD_RELOC_8_PCREL",
4e98461f
SC		 563 "BFD_RELOC_32_GOT_PCREL",
564 "BFD_RELOC_16_GOT_PCREL",
565 "BFD_RELOC_8_GOT_PCREL",
566 "BFD_RELOC_32_GOTOFF",
567 "BFD_RELOC_16_GOTOFF",
02f85cda
MM		 568 "BFD_RELOC_LO16_GOTOFF",
569 "BFD_RELOC_HI16_GOTOFF",
570 "BFD_RELOC_HI16_S_GOTOFF",
4e98461f
SC		 571 "BFD_RELOC_8_GOTOFF",
572 "BFD_RELOC_32_PLT_PCREL",
02f85cda 573 "BFD_RELOC_24_PLT_PCREL",
4e98461f
SC		 574 "BFD_RELOC_16_PLT_PCREL",
575 "BFD_RELOC_8_PLT_PCREL",
576 "BFD_RELOC_32_PLTOFF",
577 "BFD_RELOC_16_PLTOFF",
02f85cda
MM		 578 "BFD_RELOC_LO16_PLTOFF",
579 "BFD_RELOC_HI16_PLTOFF",
580 "BFD_RELOC_HI16_S_PLTOFF",
4e98461f
SC		 581 "BFD_RELOC_8_PLTOFF",
582 "BFD_RELOC_68K_GLOB_DAT",
583 "BFD_RELOC_68K_JMP_SLOT",
584 "BFD_RELOC_68K_RELATIVE",
0443af31
KR		 585 "BFD_RELOC_32_BASEREL",
586 "BFD_RELOC_16_BASEREL",
02f85cda
MM		 587 "BFD_RELOC_LO16_BASEREL",
588 "BFD_RELOC_HI16_BASEREL",
589 "BFD_RELOC_HI16_S_BASEREL",
0443af31 590 "BFD_RELOC_8_BASEREL",
4e98461f 591 "BFD_RELOC_RVA",
0443af31
KR		 592 "BFD_RELOC_8_FFnn",
593 "BFD_RELOC_32_PCREL_S2",
594 "BFD_RELOC_16_PCREL_S2",
595 "BFD_RELOC_23_PCREL_S2",
596 "BFD_RELOC_HI22",
597 "BFD_RELOC_LO10",
598 "BFD_RELOC_GPREL16",
599 "BFD_RELOC_GPREL32",
600 "BFD_RELOC_I960_CALLJ",
601 "BFD_RELOC_NONE",
602 "BFD_RELOC_SPARC_WDISP22",
603 "BFD_RELOC_SPARC22",
604 "BFD_RELOC_SPARC13",
605 "BFD_RELOC_SPARC_GOT10",
606 "BFD_RELOC_SPARC_GOT13",
607 "BFD_RELOC_SPARC_GOT22",
608 "BFD_RELOC_SPARC_PC10",
609 "BFD_RELOC_SPARC_PC22",
610 "BFD_RELOC_SPARC_WPLT30",
611 "BFD_RELOC_SPARC_COPY",
612 "BFD_RELOC_SPARC_GLOB_DAT",
613 "BFD_RELOC_SPARC_JMP_SLOT",
614 "BFD_RELOC_SPARC_RELATIVE",
615 "BFD_RELOC_SPARC_UA32",
616 "BFD_RELOC_SPARC_BASE13",
617 "BFD_RELOC_SPARC_BASE22",
618 "BFD_RELOC_SPARC_10",
619 "BFD_RELOC_SPARC_11",
620 "BFD_RELOC_SPARC_OLO10",
621 "BFD_RELOC_SPARC_HH22",
622 "BFD_RELOC_SPARC_HM10",
623 "BFD_RELOC_SPARC_LM22",
624 "BFD_RELOC_SPARC_PC_HH22",
625 "BFD_RELOC_SPARC_PC_HM10",
626 "BFD_RELOC_SPARC_PC_LM22",
627 "BFD_RELOC_SPARC_WDISP16",
628 "BFD_RELOC_SPARC_WDISP19",
e9f03cd4
ILT		 629 "BFD_RELOC_SPARC_7",
630 "BFD_RELOC_SPARC_6",
631 "BFD_RELOC_SPARC_5",
0443af31
KR		 632 "BFD_RELOC_ALPHA_GPDISP_HI16",
633 "BFD_RELOC_ALPHA_GPDISP_LO16",
50bd50d4 634 "BFD_RELOC_ALPHA_GPDISP",
0443af31 635 "BFD_RELOC_ALPHA_LITERAL",
6b31fd3a 636 "BFD_RELOC_ALPHA_ELF_LITERAL",
0443af31
KR		 637 "BFD_RELOC_ALPHA_LITUSE",
638 "BFD_RELOC_ALPHA_HINT",
50bd50d4 639 "BFD_RELOC_ALPHA_LINKAGE",
fd8d7c31 640 "BFD_RELOC_ALPHA_CODEADDR",
0443af31 641 "BFD_RELOC_MIPS_JMP",
c7f8d0a5 642 "BFD_RELOC_MIPS16_JMP",
a4183ba5 643 "BFD_RELOC_MIPS16_GPREL",
0443af31
KR		 644 "BFD_RELOC_HI16",
645 "BFD_RELOC_HI16_S",
646 "BFD_RELOC_LO16",
647 "BFD_RELOC_PCREL_HI16_S",
648 "BFD_RELOC_PCREL_LO16",
649 "BFD_RELOC_MIPS_LITERAL",
650 "BFD_RELOC_MIPS_GOT16",
651 "BFD_RELOC_MIPS_CALL16",
e9f03cd4
ILT		 652 "BFD_RELOC_MIPS_GOT_HI16",
653 "BFD_RELOC_MIPS_GOT_LO16",
b7384d22
ILT		 654 "BFD_RELOC_MIPS_CALL_HI16",
655 "BFD_RELOC_MIPS_CALL_LO16",
0443af31
KR		 656 "BFD_RELOC_386_GOT32",
657 "BFD_RELOC_386_PLT32",
658 "BFD_RELOC_386_COPY",
659 "BFD_RELOC_386_GLOB_DAT",
660 "BFD_RELOC_386_JUMP_SLOT",
661 "BFD_RELOC_386_RELATIVE",
662 "BFD_RELOC_386_GOTOFF",
663 "BFD_RELOC_386_GOTPC",
664 "BFD_RELOC_NS32K_IMM_8",
665 "BFD_RELOC_NS32K_IMM_16",
666 "BFD_RELOC_NS32K_IMM_32",
667 "BFD_RELOC_NS32K_IMM_8_PCREL",
668 "BFD_RELOC_NS32K_IMM_16_PCREL",
669 "BFD_RELOC_NS32K_IMM_32_PCREL",
670 "BFD_RELOC_NS32K_DISP_8",
671 "BFD_RELOC_NS32K_DISP_16",
672 "BFD_RELOC_NS32K_DISP_32",
673 "BFD_RELOC_NS32K_DISP_8_PCREL",
674 "BFD_RELOC_NS32K_DISP_16_PCREL",
675 "BFD_RELOC_NS32K_DISP_32_PCREL",
676 "BFD_RELOC_PPC_B26",
677 "BFD_RELOC_PPC_BA26",
678 "BFD_RELOC_PPC_TOC16",
02f85cda
MM		 679 "BFD_RELOC_PPC_B16",
680 "BFD_RELOC_PPC_B16_BRTAKEN",
681 "BFD_RELOC_PPC_B16_BRNTAKEN",
682 "BFD_RELOC_PPC_BA16",
683 "BFD_RELOC_PPC_BA16_BRTAKEN",
684 "BFD_RELOC_PPC_BA16_BRNTAKEN",
685 "BFD_RELOC_PPC_COPY",
686 "BFD_RELOC_PPC_GLOB_DAT",
687 "BFD_RELOC_PPC_JMP_SLOT",
688 "BFD_RELOC_PPC_RELATIVE",
689 "BFD_RELOC_PPC_LOCAL24PC",
e9f03cd4
ILT		 690 "BFD_RELOC_PPC_EMB_NADDR32",
691 "BFD_RELOC_PPC_EMB_NADDR16",
692 "BFD_RELOC_PPC_EMB_NADDR16_LO",
693 "BFD_RELOC_PPC_EMB_NADDR16_HI",
694 "BFD_RELOC_PPC_EMB_NADDR16_HA",
695 "BFD_RELOC_PPC_EMB_SDAI16",
696 "BFD_RELOC_PPC_EMB_SDA2I16",
697 "BFD_RELOC_PPC_EMB_SDA2REL",
698 "BFD_RELOC_PPC_EMB_SDA21",
699 "BFD_RELOC_PPC_EMB_MRKREF",
700 "BFD_RELOC_PPC_EMB_RELSEC16",
701 "BFD_RELOC_PPC_EMB_RELST_LO",
702 "BFD_RELOC_PPC_EMB_RELST_HI",
703 "BFD_RELOC_PPC_EMB_RELST_HA",
704 "BFD_RELOC_PPC_EMB_BIT_FLD",
705 "BFD_RELOC_PPC_EMB_RELSDA",
0443af31 706 "BFD_RELOC_CTOR",
fca2b81b
KR		 707 "BFD_RELOC_ARM_PCREL_BRANCH",
708 "BFD_RELOC_ARM_IMMEDIATE",
709 "BFD_RELOC_ARM_OFFSET_IMM",
710 "BFD_RELOC_ARM_SHIFT_IMM",
711 "BFD_RELOC_ARM_SWI",
712 "BFD_RELOC_ARM_MULTI",
713 "BFD_RELOC_ARM_CP_OFF_IMM",
4e98461f
SC		 714 "BFD_RELOC_ARM_ADR_IMM",
715 "BFD_RELOC_ARM_LDR_IMM",
716 "BFD_RELOC_ARM_LITERAL",
717 "BFD_RELOC_ARM_IN_POOL",
d1b40d8e
JSC		 718 "BFD_RELOC_ARM_OFFSET_IMM8",
719 "BFD_RELOC_ARM_HWLITERAL",
c86158e5
ILT		 720 "BFD_RELOC_ARM_THUMB_ADD",
721 "BFD_RELOC_ARM_THUMB_IMM",
722 "BFD_RELOC_ARM_THUMB_SHIFT",
723 "BFD_RELOC_ARM_THUMB_OFFSET",
724 "BFD_RELOC_SH_PCDISP8BY2",
725 "BFD_RELOC_SH_PCDISP12BY2",
726 "BFD_RELOC_SH_IMM4",
727 "BFD_RELOC_SH_IMM4BY2",
728 "BFD_RELOC_SH_IMM4BY4",
729 "BFD_RELOC_SH_IMM8",
730 "BFD_RELOC_SH_IMM8BY2",
731 "BFD_RELOC_SH_IMM8BY4",
732 "BFD_RELOC_SH_PCRELIMM8BY2",
733 "BFD_RELOC_SH_PCRELIMM8BY4",
734 "BFD_RELOC_SH_SWITCH16",
735 "BFD_RELOC_SH_SWITCH32",
736 "BFD_RELOC_SH_USES",
737 "BFD_RELOC_SH_COUNT",
738 "BFD_RELOC_SH_ALIGN",
739 "BFD_RELOC_SH_CODE",
740 "BFD_RELOC_SH_DATA",
741 "BFD_RELOC_SH_LABEL",
48e509bf
NC		 742 "BFD_RELOC_THUMB_PCREL_BRANCH9",
743 "BFD_RELOC_THUMB_PCREL_BRANCH12",
744 "BFD_RELOC_THUMB_PCREL_BRANCH23",
76af94b9
DE		 745 "BFD_RELOC_ARC_B22_PCREL",
746 "BFD_RELOC_ARC_B26",
50bd50d4 747 "BFD_RELOC_D10V_10_PCREL_R",
0f612729 748 "BFD_RELOC_D10V_10_PCREL_L",
50bd50d4
MH		 749 "BFD_RELOC_D10V_18",
750 "BFD_RELOC_D10V_18_PCREL",
50bd50d4 751
fd8d7c31
MH		 752/* start-sanitize-d30v */
753 "BFD_RELOC_D30V_6",
2199f848
KR		 754 "BFD_RELOC_D30V_9_PCREL",
755 "BFD_RELOC_D30V_9_PCREL_R",
fd8d7c31
MH		 756 "BFD_RELOC_D30V_15",
757 "BFD_RELOC_D30V_15_PCREL",
2199f848 758 "BFD_RELOC_D30V_15_PCREL_R",
fd8d7c31
MH		 759 "BFD_RELOC_D30V_21",
760 "BFD_RELOC_D30V_21_PCREL",
2199f848 761 "BFD_RELOC_D30V_21_PCREL_R",
fd8d7c31
MH		 762 "BFD_RELOC_D30V_32",
763 "BFD_RELOC_D30V_32_PCREL",
764/* end-sanitize-d30v */
765
c7f8d0a5
ILT		 766 "BFD_RELOC_M32R_24",
767 "BFD_RELOC_M32R_10_PCREL",
768 "BFD_RELOC_M32R_18_PCREL",
769 "BFD_RELOC_M32R_26_PCREL",
1d5c6cfd
DE		 770 "BFD_RELOC_M32R_HI16_ULO",
771 "BFD_RELOC_M32R_HI16_SLO",
772 "BFD_RELOC_M32R_LO16",
35a3e78e 773 "BFD_RELOC_M32R_SDA16",
6b31fd3a
ILT		 774 "BFD_RELOC_V850_9_PCREL",
775 "BFD_RELOC_V850_22_PCREL",
def31039
NC		 776 "BFD_RELOC_V850_SDA_16_16_OFFSET",
777 "BFD_RELOC_V850_SDA_15_16_OFFSET",
778 "BFD_RELOC_V850_ZDA_16_16_OFFSET",
779 "BFD_RELOC_V850_ZDA_15_16_OFFSET",
780 "BFD_RELOC_V850_TDA_6_8_OFFSET",
781 "BFD_RELOC_V850_TDA_7_8_OFFSET",
782 "BFD_RELOC_V850_TDA_7_7_OFFSET",
5bb28764 783 "BFD_RELOC_V850_TDA_16_16_OFFSET",
def31039
NC		 784/* start-sanitize-v850e */
785 "BFD_RELOC_V850_TDA_4_5_OFFSET",
786 "BFD_RELOC_V850_TDA_4_4_OFFSET",
787 "BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET",
788 "BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET",
3869b11f
DE		 789 "BFD_RELOC_V850_CALLT_6_7_OFFSET",
790 "BFD_RELOC_V850_CALLT_16_16_OFFSET",
2cf9a0d0 791/* end-sanitize-v850e */
6b31fd3a 792
c7f8d0a5
ILT		 793 "BFD_RELOC_MN10300_32_PCREL",
794 "BFD_RELOC_MN10300_16_PCREL",
0443af31
KR		 795 "@@overflow: BFD_RELOC_UNUSED@@",
796};
797#endif
798
4e98461f 799reloc_howto_type *
fefb4b30 800bfd_default_reloc_type_lookup
57a1867e 801 PARAMS ((bfd *abfd, bfd_reloc_code_real_type code));
fefb4b30
JG		 802
803boolean
804bfd_generic_relax_section
805 PARAMS ((bfd *abfd,
d58b7049 806 asection *section,
4c3721d5 807 struct bfd_link_info *,
326e32d7 808 boolean *));
fefb4b30 809
e98e6ec1 810bfd_byte *
fefb4b30 811
287c221d 812bfd_generic_get_relocated_section_contents PARAMS ((bfd *abfd,
4c3721d5
ILT		 813 struct bfd_link_info *link_info,
814 struct bfd_link_order *link_order,
14e3c2e4 815 bfd_byte *data,
4c3721d5
ILT		 816 boolean relocateable,
817 asymbol **symbols));
14e3c2e4 818
2ffbb79a 819extern const bfd_arch_info_type bfd_default_arch_struct;
fefb4b30
JG		 820boolean
821bfd_default_set_arch_mach PARAMS ((bfd *abfd,
e98e6ec1
SC		 822 enum bfd_architecture arch,
823 unsigned long mach));
fefb4b30 824
2ffbb79a 825const bfd_arch_info_type *
fefb4b30 826bfd_default_compatible
2ffbb79a
ILT		 827 PARAMS ((const bfd_arch_info_type *a,
828 const bfd_arch_info_type *b));
fefb4b30
JG		 829
830boolean
2ffbb79a 831bfd_default_scan PARAMS ((const struct bfd_arch_info *info, const char *string));
fefb4b30 832
3ceaa255 833struct elf_internal_shdr *
6affd66a 834bfd_elf_find_section PARAMS ((bfd *abfd, char *name));
fefb4b30 835
GDB Binutils - Deliverables
This page took 0.264043 seconds and 4 git commands to generate.