1 /* libbfd.h -- Declarations used by bfd library *implementation*.
2 (This include file is not for users of the library.)
3 Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
4 Written by Cygnus Support.
6 This file is part of BFD, the Binary File Descriptor library.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
23 /* Align an address upward to a boundary, expressed as a number of bytes.
24 E.g. align to an 8-byte boundary with argument of 8. */
25 #define BFD_ALIGN(this, boundary) \
26 ((( (this) + ((boundary) -1)) & (~((boundary)-1))))
28 /* If you want to read and write large blocks, you might want to do it
29 in quanta of this amount */
30 #define DEFAULT_BUFFERSIZE 8192
32 /* Set a tdata field. Can't use the other macros for this, since they
33 do casts, and casting to the left of assignment isn't portable. */
34 #define set_tdata(bfd, v) ((bfd)->tdata.any = (PTR) (v))
36 /* tdata for an archive. For an input archive, cache
37 needs to be free()'d. For an output archive, symdefs do. */
40 file_ptr first_file_filepos
;
41 /* Speed up searching the armap */
42 struct ar_cache
*cache
;
43 bfd
*archive_head
; /* Only interesting in output routines */
44 carsym
*symdefs
; /* the symdef entries */
45 symindex symdef_count
; /* how many there are */
46 char *extended_names
; /* clever intel extension */
49 #define bfd_ardata(bfd) ((bfd)->tdata.aout_ar_data)
51 /* Goes in bfd's arelt_data slot */
53 char * arch_header
; /* it's actually a string */
54 unsigned int parsed_size
; /* octets of filesize not including ar_hdr */
55 char *filename
; /* null-terminated */
58 #define arelt_size(bfd) (((struct areltdata *)((bfd)->arelt_data))->parsed_size)
60 char *zalloc
PARAMS ((bfd_size_type size
));
62 /* These routines allocate and free things on the BFD's obstack. Note
63 that realloc can never occur in place. */
65 PTR bfd_alloc
PARAMS ((bfd
*abfd
, size_t size
));
66 PTR bfd_zalloc
PARAMS ((bfd
*abfd
, size_t size
));
67 PTR bfd_realloc
PARAMS ((bfd
*abfd
, PTR orig
, size_t new));
68 void bfd_alloc_grow
PARAMS ((bfd
*abfd
, PTR thing
, size_t size
));
69 PTR bfd_alloc_finish
PARAMS ((bfd
*abfd
));
70 PTR bfd_alloc_by_size_t
PARAMS ((bfd
*abfd
, size_t wanted
));
72 #define bfd_release(x,y) (void) obstack_free(&(x->memory),y)
75 bfd_size_type bfd_read
PARAMS ((PTR ptr
, bfd_size_type size
,
76 bfd_size_type nitems
, bfd
*abfd
));
77 bfd_size_type bfd_write
PARAMS ((CONST PTR ptr
, bfd_size_type size
,
78 bfd_size_type nitems
, bfd
*abfd
));
79 int bfd_seek
PARAMS ((bfd
* CONST abfd
, CONST file_ptr fp
,
80 CONST
int direction
));
81 long bfd_tell
PARAMS ((bfd
*abfd
));
83 bfd
* _bfd_create_empty_archive_element_shell
PARAMS ((bfd
*obfd
));
84 bfd
* look_for_bfd_in_cache
PARAMS ((bfd
*arch_bfd
, file_ptr index
));
85 boolean _bfd_generic_mkarchive
PARAMS ((bfd
*abfd
));
86 struct areltdata
* snarf_ar_hdr
PARAMS ((bfd
*abfd
));
87 bfd_target
* bfd_generic_archive_p
PARAMS ((bfd
*abfd
));
88 boolean bfd_slurp_armap
PARAMS ((bfd
*abfd
));
89 boolean bfd_slurp_bsd_armap_f2
PARAMS ((bfd
*abfd
));
90 #define bfd_slurp_bsd_armap bfd_slurp_armap
91 #define bfd_slurp_coff_armap bfd_slurp_armap
92 boolean _bfd_slurp_extended_name_table
PARAMS ((bfd
*abfd
));
93 boolean _bfd_write_archive_contents
PARAMS ((bfd
*abfd
));
94 bfd
* new_bfd
PARAMS (());
96 #define DEFAULT_STRING_SPACE_SIZE 0x2000
97 boolean bfd_add_to_string_table
PARAMS ((char **table
, char *new_string
,
98 unsigned int *table_length
,
101 /* Byte swapping routines from libbfd.c */
103 /* namespace protection */
104 #define _do_getb64 _bfd__do_getb64
105 #define _do_getl64 _bfd__do_getl64
106 #define _do_getb_signed_64 _bfd__do_getb_signed_64
107 #define _do_getl_signed_64 _bfd__do_getl_signed_64
108 #define _do_getb32 _bfd__do_getb32
109 #define _do_getl32 _bfd__do_getl32
110 #define _do_getb_signed_32 _bfd__do_getb_signed_32
111 #define _do_getl_signed_32 _bfd__do_getl_signed_32
112 #define _do_getb16 _bfd__do_getb16
113 #define _do_getl16 _bfd__do_getl16
114 #define _do_getb_signed_16 _bfd__do_getb_signed_16
115 #define _do_getl_signed_16 _bfd__do_getl_signed_16
116 #define _do_putb64 _bfd__do_putb64
117 #define _do_putl64 _bfd__do_putl64
118 #define _do_putb32 _bfd__do_putb32
119 #define _do_putl32 _bfd__do_putl32
120 #define _do_putb16 _bfd__do_putb16
121 #define _do_putl16 _bfd__do_putl16
123 bfd_vma _do_getb64
PARAMS ((unsigned char *addr
));
124 bfd_vma _do_getl64
PARAMS ((unsigned char *addr
));
125 bfd_signed_vma _do_getb_signed_64
PARAMS ((unsigned char *addr
));
126 bfd_signed_vma _do_getl_signed_64
PARAMS ((unsigned char *addr
));
127 bfd_vma _do_getb32
PARAMS ((unsigned char *addr
));
128 bfd_vma _do_getl32
PARAMS ((unsigned char *addr
));
129 bfd_signed_vma _do_getb_signed_32
PARAMS ((unsigned char *addr
));
130 bfd_signed_vma _do_getl_signed_32
PARAMS ((unsigned char *addr
));
131 bfd_vma _do_getb16
PARAMS ((unsigned char *addr
));
132 bfd_vma _do_getl16
PARAMS ((unsigned char *addr
));
133 bfd_signed_vma _do_getb_signed_16
PARAMS ((unsigned char *addr
));
134 bfd_signed_vma _do_getl_signed_16
PARAMS ((unsigned char *addr
));
135 void _do_putb64
PARAMS ((bfd_vma data
, unsigned char *addr
));
136 void _do_putl64
PARAMS ((bfd_vma data
, unsigned char *addr
));
137 void _do_putb32
PARAMS ((bfd_vma data
, unsigned char *addr
));
138 void _do_putl32
PARAMS ((bfd_vma data
, unsigned char *addr
));
139 void _do_putb16
PARAMS ((bfd_vma data
, unsigned char *addr
));
140 void _do_putl16
PARAMS ((bfd_vma data
, unsigned char *addr
));
142 boolean bfd_false
PARAMS ((bfd
*ignore
));
143 boolean bfd_true
PARAMS ((bfd
*ignore
));
144 PTR bfd_nullvoidptr
PARAMS ((bfd
*ignore
));
145 int bfd_0
PARAMS ((bfd
*ignore
));
146 unsigned int bfd_0u
PARAMS ((bfd
*ignore
));
147 void bfd_void
PARAMS ((bfd
*ignore
));
149 bfd
* new_bfd_contained_in
PARAMS ((bfd
*));
150 boolean _bfd_dummy_new_section_hook
PARAMS ((bfd
*ignore
, asection
*newsect
));
151 char * _bfd_dummy_core_file_failing_command
PARAMS ((bfd
*abfd
));
152 int _bfd_dummy_core_file_failing_signal
PARAMS ((bfd
*abfd
));
153 boolean _bfd_dummy_core_file_matches_executable_p
PARAMS ((bfd
*core_bfd
,
155 bfd_target
* _bfd_dummy_target
PARAMS ((bfd
*abfd
));
157 void bfd_dont_truncate_arname
PARAMS ((bfd
*abfd
, CONST
char *filename
,
159 void bfd_bsd_truncate_arname
PARAMS ((bfd
*abfd
, CONST
char *filename
,
161 void bfd_gnu_truncate_arname
PARAMS ((bfd
*abfd
, CONST
char *filename
,
164 boolean bsd_write_armap
PARAMS ((bfd
*arch
, unsigned int elength
,
165 struct orl
*map
, unsigned int orl_count
, int stridx
));
167 boolean coff_write_armap
PARAMS ((bfd
*arch
, unsigned int elength
,
168 struct orl
*map
, unsigned int orl_count
, int stridx
));
170 bfd
* bfd_generic_openr_next_archived_file
PARAMS ((bfd
*archive
,
173 int bfd_generic_stat_arch_elt
PARAMS ((bfd
*, struct stat
*));
175 boolean bfd_generic_get_section_contents
PARAMS ((bfd
*abfd
, sec_ptr section
,
176 PTR location
, file_ptr offset
,
177 bfd_size_type count
));
179 boolean bfd_generic_set_section_contents
PARAMS ((bfd
*abfd
, sec_ptr section
,
180 PTR location
, file_ptr offset
,
181 bfd_size_type count
));
183 /* Macros to tell if bfds are read or write enabled.
185 Note that bfds open for read may be scribbled into if the fd passed
186 to bfd_fdopenr is actually open both for read and write
187 simultaneously. However an output bfd will never be open for
188 read. Therefore sometimes you want to check bfd_read_p or
189 !bfd_read_p, and only sometimes bfd_write_p.
192 #define bfd_read_p(abfd) ((abfd)->direction == read_direction || (abfd)->direction == both_direction)
193 #define bfd_write_p(abfd) ((abfd)->direction == write_direction || (abfd)->direction == both_direction)
195 void bfd_assert
PARAMS ((char*,int));
197 #define BFD_ASSERT(x) \
198 { if (!(x)) bfd_assert(__FILE__,__LINE__); }
201 { bfd_assert(__FILE__,__LINE__); }
203 FILE * bfd_cache_lookup_worker
PARAMS ((bfd
*));
205 extern bfd
*bfd_last_cache
;
207 /* Now Steve, what's the story here? */
212 #define itos(x) ((char*)(x))
213 #define stoi(x) ((int)(x))
216 /* Generic routine for close_and_cleanup is really just bfd_true. */
217 #define bfd_generic_close_and_cleanup bfd_true
219 /* And more follows */