* libelf.h: Added some comments.
[binutils-gdb.git] / bfd / elf64-target.h
1 /* Target definitions for 64-bit ELF
2 Copyright 1993 Free Software Foundation, Inc.
3
4 This file is part of BFD, the Binary File Descriptor library.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
19
20 /* This structure contains everything that BFD knows about a target.
21 It includes things like its byte order, name, what routines to call
22 to do various operations, etc. Every BFD points to a target structure
23 with its "xvec" member.
24
25 There are two such structures here: one for big-endian machines and
26 one for little-endian machines. */
27
28 /* Archives are generic or unimplemented. */
29 #ifndef bfd_elf64_slurp_armap
30 #define bfd_elf64_slurp_armap bfd_slurp_coff_armap
31 #endif
32 #define bfd_elf64_slurp_extended_name_table _bfd_slurp_extended_name_table
33 #define bfd_elf64_truncate_arname bfd_dont_truncate_arname
34 #define bfd_elf64_openr_next_archived_file bfd_generic_openr_next_archived_file
35 #define bfd_elf64_generic_stat_arch_elt bfd_generic_stat_arch_elt
36 #ifndef bfd_elf64_write_armap
37 #define bfd_elf64_write_armap coff_write_armap
38 #endif
39
40 /* Ordinary section reading and writing */
41 #define bfd_elf64_get_section_contents bfd_generic_get_section_contents
42 #define bfd_elf64_close_and_cleanup bfd_generic_close_and_cleanup
43
44 #define bfd_elf64_bfd_debug_info_start bfd_void
45 #define bfd_elf64_bfd_debug_info_end bfd_void
46 #define bfd_elf64_bfd_debug_info_accumulate (PROTO(void,(*),(bfd*, struct sec *))) bfd_void
47 #define bfd_elf64_bfd_get_relocated_section_contents \
48 bfd_generic_get_relocated_section_contents
49 #define bfd_elf64_bfd_relax_section bfd_generic_relax_section
50 #define bfd_elf64_bfd_seclet_link bfd_generic_seclet_link
51 #define bfd_elf64_bfd_make_debug_symbol \
52 ((asymbol *(*) PARAMS ((bfd *, void *, unsigned long))) bfd_nullvoidptr)
53
54 #ifndef elf_info_to_howto_rel
55 #define elf_info_to_howto_rel 0
56 #endif
57
58 #ifndef ELF_MAXPAGESIZE
59 #define ELF_MAXPAGESIZE 1
60 #endif
61
62 #ifndef elf_backend_symbol_processing
63 #define elf_backend_symbol_processing 0 /* elf_backend_symbol_processing */
64 #endif
65 #ifndef elf_backend_symbol_table_processing
66 #define elf_backend_symbol_table_processing 0 /* elf_backend_symbol_table_processing */
67 #endif
68 #ifndef elf_backend_section_processing
69 #define elf_backend_section_processing 0 /* elf_backend_section_processing */
70 #endif
71 #ifndef elf_backend_section_from_shdr
72 #define elf_backend_section_from_shdr 0 /* elf_backend_section_from_shdr */
73 #endif
74 #ifndef elf_backend_fake_sections
75 #define elf_backend_fake_sections 0 /* elf_backend_fake_sections */
76 #endif
77 #ifndef elf_backend_section_from_bfd_section
78 #define elf_backend_section_from_bfd_section 0 /* elf_backend_section_from_bfd_section */
79 #endif
80 #ifndef elf_backend_ecoff_debug_swap
81 #define elf_backend_ecoff_debug_swap 0 /* elf_backed_ecoff_debug_swap */
82 #endif
83
84 static CONST struct elf_backend_data elf64_bed =
85 {
86 #ifdef USE_REL
87 0, /* use_rela_p */
88 #else
89 1, /* use_rela_p */
90 #endif
91 1, /* elf_64_p */
92 ELF_ARCH, /* arch */
93 ELF_MAXPAGESIZE, /* maxpagesize */
94 elf_info_to_howto, /* elf_info_to_howto */
95 elf_info_to_howto_rel, /* elf_info_to_howto_rel */
96 elf_backend_symbol_processing, /* elf_backend_symbol_processing */
97 elf_backend_symbol_table_processing, /* elf_backend_symbol_table_processing */
98 elf_backend_section_processing, /* elf_backend_section_processing */
99 elf_backend_section_from_shdr, /* elf_backend_section_from_shdr */
100 elf_backend_fake_sections, /* elf_backend_fake_sections */
101 elf_backend_section_from_bfd_section, /* elf_backend_section_from_bfd_section */
102 elf_backend_ecoff_debug_swap /* elf_backend_ecoff_debug_swap */
103 };
104
105 #ifdef TARGET_BIG_SYM
106 bfd_target TARGET_BIG_SYM =
107 {
108 /* name: identify kind of target */
109 TARGET_BIG_NAME,
110
111 /* flavour: general indication about file */
112 bfd_target_elf_flavour,
113
114 /* byteorder_big_p: data is big endian */
115 true,
116
117 /* header_byteorder_big_p: header is also big endian */
118 true,
119
120 /* object_flags: mask of all file flags */
121 (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
122 DYNAMIC | WP_TEXT),
123
124 /* section_flags: mask of all section flags */
125 (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
126 SEC_CODE | SEC_DATA | SEC_DEBUGGING),
127
128 /* leading_symbol_char: is the first char of a user symbol
129 predictable, and if so what is it */
130 0,
131
132 /* ar_pad_char: pad character for filenames within an archive header
133 FIXME: this really has nothing to do with ELF, this is a characteristic
134 of the archiver and/or os and should be independently tunable */
135 '/',
136
137 /* ar_max_namelen: maximum number of characters in an archive header
138 FIXME: this really has nothing to do with ELF, this is a characteristic
139 of the archiver and should be independently tunable. This value is
140 a WAG (wild a** guess) */
141 15,
142
143 /* align_power_min: minimum alignment restriction for any section
144 FIXME: this value may be target machine dependent */
145 3,
146
147 /* Routines to byte-swap various sized integers from the data sections */
148 bfd_getb64, bfd_getb_signed_64, bfd_putb64,
149 bfd_getb32, bfd_getb_signed_32, bfd_putb32,
150 bfd_getb16, bfd_getb_signed_16, bfd_putb16,
151
152 /* Routines to byte-swap various sized integers from the file headers */
153 bfd_getb64, bfd_getb_signed_64, bfd_putb64,
154 bfd_getb32, bfd_getb_signed_32, bfd_putb32,
155 bfd_getb16, bfd_getb_signed_16, bfd_putb16,
156
157 /* bfd_check_format: check the format of a file being read */
158 { _bfd_dummy_target, /* unknown format */
159 bfd_elf64_object_p, /* assembler/linker output (object file) */
160 bfd_generic_archive_p, /* an archive */
161 bfd_elf64_core_file_p /* a core file */
162 },
163
164 /* bfd_set_format: set the format of a file being written */
165 { bfd_false,
166 bfd_elf_mkobject,
167 _bfd_generic_mkarchive,
168 bfd_false
169 },
170
171 /* bfd_write_contents: write cached information into a file being written */
172 { bfd_false,
173 bfd_elf64_write_object_contents,
174 _bfd_write_archive_contents,
175 bfd_false
176 },
177
178 /* Initialize a jump table with the standard macro. All names start with
179 "elf" */
180 JUMP_TABLE(bfd_elf64),
181
182 /* backend_data: */
183 (PTR) &elf64_bed,
184 };
185 #endif
186
187 #ifdef TARGET_LITTLE_SYM
188 bfd_target TARGET_LITTLE_SYM =
189 {
190 /* name: identify kind of target */
191 TARGET_LITTLE_NAME,
192
193 /* flavour: general indication about file */
194 bfd_target_elf_flavour,
195
196 /* byteorder_big_p: data is big endian */
197 false, /* Nope -- this one's little endian */
198
199 /* header_byteorder_big_p: header is also big endian */
200 false, /* Nope -- this one's little endian */
201
202 /* object_flags: mask of all file flags */
203 (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
204 DYNAMIC | WP_TEXT),
205
206 /* section_flags: mask of all section flags */
207 (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
208 SEC_CODE | SEC_DATA | SEC_DEBUGGING),
209
210 /* leading_symbol_char: is the first char of a user symbol
211 predictable, and if so what is it */
212 0,
213
214 /* ar_pad_char: pad character for filenames within an archive header
215 FIXME: this really has nothing to do with ELF, this is a characteristic
216 of the archiver and/or os and should be independently tunable */
217 '/',
218
219 /* ar_max_namelen: maximum number of characters in an archive header
220 FIXME: this really has nothing to do with ELF, this is a characteristic
221 of the archiver and should be independently tunable. This value is
222 a WAG (wild a** guess) */
223 15,
224
225 /* align_power_min: minimum alignment restriction for any section
226 FIXME: this value may be target machine dependent */
227 3,
228
229 /* Routines to byte-swap various sized integers from the data sections */
230 bfd_getl64, bfd_getl_signed_64, bfd_putl64,
231 bfd_getl32, bfd_getl_signed_32, bfd_putl32,
232 bfd_getl16, bfd_getl_signed_16, bfd_putl16,
233
234 /* Routines to byte-swap various sized integers from the file headers */
235 bfd_getl64, bfd_getl_signed_64, bfd_putl64,
236 bfd_getl32, bfd_getl_signed_32, bfd_putl32,
237 bfd_getl16, bfd_getl_signed_16, bfd_putl16,
238
239 /* bfd_check_format: check the format of a file being read */
240 { _bfd_dummy_target, /* unknown format */
241 bfd_elf64_object_p, /* assembler/linker output (object file) */
242 bfd_generic_archive_p, /* an archive */
243 bfd_elf64_core_file_p /* a core file */
244 },
245
246 /* bfd_set_format: set the format of a file being written */
247 { bfd_false,
248 bfd_elf_mkobject,
249 _bfd_generic_mkarchive,
250 bfd_false
251 },
252
253 /* bfd_write_contents: write cached information into a file being written */
254 { bfd_false,
255 bfd_elf64_write_object_contents,
256 _bfd_write_archive_contents,
257 bfd_false
258 },
259
260 /* Initialize a jump table with the standard macro. All names start with
261 "elf" */
262 JUMP_TABLE(bfd_elf64),
263
264 /* backend_data: */
265 (PTR) &elf64_bed,
266 };
267 #endif