* Many files: change all bfd_target vectors to be const. Change
[external/binutils.git] / bfd / elf32-target.h
1 /* Target definitions for 32-bit ELF
2    Copyright 1993, 1994 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 #define bfd_elf32_close_and_cleanup _bfd_generic_close_and_cleanup
29 #define bfd_elf32_bfd_free_cached_info _bfd_generic_bfd_free_cached_info
30 #ifndef bfd_elf32_get_section_contents
31 #define bfd_elf32_get_section_contents _bfd_generic_get_section_contents
32 #endif
33
34 #define bfd_elf32_bfd_get_relocated_section_contents \
35  bfd_generic_get_relocated_section_contents
36 #define bfd_elf32_bfd_relax_section bfd_generic_relax_section
37 #define bfd_elf32_bfd_make_debug_symbol \
38   ((asymbol *(*) PARAMS ((bfd *, void *, unsigned long))) bfd_nullvoidptr)
39
40 #ifndef bfd_elf32_bfd_copy_private_section_data
41 #define bfd_elf32_bfd_copy_private_section_data \
42   ((boolean (*) PARAMS ((bfd *, asection *, bfd *, asection *))) bfd_true)
43 #endif
44 #ifndef bfd_elf32_bfd_copy_private_bfd_data
45 #define bfd_elf32_bfd_copy_private_bfd_data \
46   ((boolean (*) PARAMS ((bfd *, bfd *))) bfd_true)
47 #endif
48 #ifndef bfd_elf32_bfd_is_local_label
49 #define bfd_elf32_bfd_is_local_label bfd_generic_is_local_label
50 #endif
51
52 #ifndef bfd_elf32_get_dynamic_reloc_upper_bound
53 #define bfd_elf32_get_dynamic_reloc_upper_bound \
54   _bfd_nodynamic_get_dynamic_reloc_upper_bound
55 #endif
56 #ifndef bfd_elf32_canonicalize_dynamic_reloc
57 #define bfd_elf32_canonicalize_dynamic_reloc \
58   _bfd_nodynamic_canonicalize_dynamic_reloc
59 #endif
60
61 #ifdef elf_backend_relocate_section
62 #ifndef bfd_elf32_bfd_link_hash_table_create
63 #define bfd_elf32_bfd_link_hash_table_create _bfd_elf_link_hash_table_create
64 #endif
65 #else /* ! defined (elf_backend_relocate_section) */
66 /* If no backend relocate_section routine, use the generic linker.  */
67 #ifndef bfd_elf32_bfd_link_hash_table_create
68 #define bfd_elf32_bfd_link_hash_table_create \
69   _bfd_generic_link_hash_table_create
70 #endif
71 #ifndef bfd_elf32_bfd_link_add_symbols
72 #define bfd_elf32_bfd_link_add_symbols  _bfd_generic_link_add_symbols
73 #endif
74 #ifndef bfd_elf32_bfd_final_link
75 #define bfd_elf32_bfd_final_link        _bfd_generic_final_link
76 #endif
77 #endif /* ! defined (elf_backend_relocate_section) */
78
79 #ifndef elf_info_to_howto_rel
80 #define elf_info_to_howto_rel 0
81 #endif
82
83 #ifndef ELF_MAXPAGESIZE
84 #define ELF_MAXPAGESIZE 1
85 #endif
86
87 #ifndef elf_backend_collect
88 #define elf_backend_collect false
89 #endif
90
91 #ifndef elf_backend_sym_is_global
92 #define elf_backend_sym_is_global       0
93 #endif
94 #ifndef elf_backend_object_p
95 #define elf_backend_object_p            0
96 #endif
97 #ifndef elf_backend_symbol_processing
98 #define elf_backend_symbol_processing   0
99 #endif
100 #ifndef elf_backend_symbol_table_processing
101 #define elf_backend_symbol_table_processing     0
102 #endif
103 #ifndef elf_backend_section_processing
104 #define elf_backend_section_processing  0
105 #endif
106 #ifndef elf_backend_section_from_shdr
107 #define elf_backend_section_from_shdr   0
108 #endif
109 #ifndef elf_backend_fake_sections
110 #define elf_backend_fake_sections       0
111 #endif
112 #ifndef elf_backend_section_from_bfd_section
113 #define elf_backend_section_from_bfd_section    0
114 #endif
115 #ifndef elf_backend_add_symbol_hook
116 #define elf_backend_add_symbol_hook     0
117 #endif
118 #ifndef elf_backend_create_dynamic_sections
119 #define elf_backend_create_dynamic_sections 0
120 #endif
121 #ifndef elf_backend_adjust_dynamic_symbol
122 #define elf_backend_adjust_dynamic_symbol 0
123 #endif
124 #ifndef elf_backend_size_dynamic_sections
125 #define elf_backend_size_dynamic_sections 0
126 #endif
127 #ifndef elf_backend_relocate_section
128 #define elf_backend_relocate_section    0
129 #endif
130 #ifndef elf_backend_finish_dynamic_symbol
131 #define elf_backend_finish_dynamic_symbol       0
132 #endif
133 #ifndef elf_backend_finish_dynamic_sections
134 #define elf_backend_finish_dynamic_sections     0
135 #endif
136 #ifndef elf_backend_begin_write_processing
137 #define elf_backend_begin_write_processing      0
138 #endif
139 #ifndef elf_backend_final_write_processing
140 #define elf_backend_final_write_processing      0
141 #endif
142 #ifndef elf_backend_ecoff_debug_swap
143 #define elf_backend_ecoff_debug_swap    0
144 #endif
145
146 static CONST struct elf_backend_data elf32_bed =
147 {
148 #ifdef USE_REL
149   0,                            /* use_rela_p */
150 #else
151   1,                            /* use_rela_p */
152 #endif
153   0,                            /* elf_64_p */
154   ELF_ARCH,                     /* arch */
155   ELF_MACHINE_CODE,             /* elf_machine_code */
156   ELF_MAXPAGESIZE,              /* maxpagesize */
157   elf_backend_collect,
158   elf_info_to_howto,
159   elf_info_to_howto_rel,
160   elf_backend_sym_is_global,
161   elf_backend_object_p,
162   elf_backend_symbol_processing,
163   elf_backend_symbol_table_processing,
164   elf_backend_section_processing,
165   elf_backend_section_from_shdr,
166   elf_backend_fake_sections,
167   elf_backend_section_from_bfd_section,
168   elf_backend_add_symbol_hook,
169   elf_backend_create_dynamic_sections,
170   elf_backend_adjust_dynamic_symbol,
171   elf_backend_size_dynamic_sections,
172   elf_backend_relocate_section,
173   elf_backend_finish_dynamic_symbol,
174   elf_backend_finish_dynamic_sections,
175   elf_backend_begin_write_processing,
176   elf_backend_final_write_processing,
177   elf_backend_ecoff_debug_swap
178 };
179
180 #ifdef TARGET_BIG_SYM
181 const bfd_target TARGET_BIG_SYM =
182 {
183   /* name: identify kind of target */
184   TARGET_BIG_NAME,
185
186   /* flavour: general indication about file */
187   bfd_target_elf_flavour,
188
189   /* byteorder_big_p: data is big endian */
190   true,
191
192   /* header_byteorder_big_p: header is also big endian */
193   true,
194
195   /* object_flags: mask of all file flags */
196   (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
197    DYNAMIC | WP_TEXT | D_PAGED),
198   
199   /* section_flags: mask of all section flags */
200   (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
201    SEC_CODE | SEC_DATA | SEC_DEBUGGING),
202
203    /* leading_symbol_char: is the first char of a user symbol
204       predictable, and if so what is it */
205    0,
206
207   /* ar_pad_char: pad character for filenames within an archive header
208      FIXME:  this really has nothing to do with ELF, this is a characteristic
209      of the archiver and/or os and should be independently tunable */
210   '/',
211
212   /* ar_max_namelen: maximum number of characters in an archive header
213      FIXME:  this really has nothing to do with ELF, this is a characteristic
214      of the archiver and should be independently tunable.  This value is
215      a WAG (wild a** guess) */
216   14,
217
218   /* align_power_min: minimum alignment restriction for any section
219      FIXME:  this value may be target machine dependent */
220   3,
221
222   /* Routines to byte-swap various sized integers from the data sections */
223   bfd_getb64, bfd_getb_signed_64, bfd_putb64,
224     bfd_getb32, bfd_getb_signed_32, bfd_putb32,
225     bfd_getb16, bfd_getb_signed_16, bfd_putb16,
226
227   /* Routines to byte-swap various sized integers from the file headers */
228   bfd_getb64, bfd_getb_signed_64, bfd_putb64,
229     bfd_getb32, bfd_getb_signed_32, bfd_putb32,
230     bfd_getb16, bfd_getb_signed_16, bfd_putb16,
231
232   /* bfd_check_format: check the format of a file being read */
233   { _bfd_dummy_target,          /* unknown format */
234     bfd_elf32_object_p,         /* assembler/linker output (object file) */
235     bfd_generic_archive_p,      /* an archive */
236     bfd_elf32_core_file_p       /* a core file */
237   },
238
239   /* bfd_set_format: set the format of a file being written */
240   { bfd_false,
241     bfd_elf_mkobject,
242     _bfd_generic_mkarchive,
243     bfd_false
244   },
245
246   /* bfd_write_contents: write cached information into a file being written */
247   { bfd_false,
248     bfd_elf32_write_object_contents,
249     _bfd_write_archive_contents,
250     bfd_false
251   },
252
253       BFD_JUMP_TABLE_GENERIC (bfd_elf32),
254       BFD_JUMP_TABLE_COPY (bfd_elf32),
255       BFD_JUMP_TABLE_CORE (bfd_elf32),
256       BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff),
257       BFD_JUMP_TABLE_SYMBOLS (bfd_elf32),
258       BFD_JUMP_TABLE_RELOCS (bfd_elf32),
259       BFD_JUMP_TABLE_WRITE (bfd_elf32),
260       BFD_JUMP_TABLE_LINK (bfd_elf32),
261       BFD_JUMP_TABLE_DYNAMIC (bfd_elf32),
262
263   /* backend_data: */
264   (PTR) &elf32_bed,
265 };
266 #endif
267
268 #ifdef TARGET_LITTLE_SYM
269 const bfd_target TARGET_LITTLE_SYM =
270 {
271   /* name: identify kind of target */
272   TARGET_LITTLE_NAME,
273
274   /* flavour: general indication about file */
275   bfd_target_elf_flavour,
276
277   /* byteorder_big_p: data is big endian */
278   false,                /* Nope -- this one's little endian */
279
280   /* header_byteorder_big_p: header is also big endian */
281   false,                /* Nope -- this one's little endian */
282
283   /* object_flags: mask of all file flags */
284   (HAS_RELOC | EXEC_P | HAS_LINENO | HAS_DEBUG | HAS_SYMS | HAS_LOCALS |
285    DYNAMIC | WP_TEXT | D_PAGED),
286   
287   /* section_flags: mask of all section flags */
288   (SEC_HAS_CONTENTS | SEC_ALLOC | SEC_LOAD | SEC_RELOC | SEC_READONLY |
289    SEC_CODE | SEC_DATA | SEC_DEBUGGING),
290
291    /* leading_symbol_char: is the first char of a user symbol
292       predictable, and if so what is it */
293    0,
294
295   /* ar_pad_char: pad character for filenames within an archive header
296      FIXME:  this really has nothing to do with ELF, this is a characteristic
297      of the archiver and/or os and should be independently tunable */
298   '/',
299
300   /* ar_max_namelen: maximum number of characters in an archive header
301      FIXME:  this really has nothing to do with ELF, this is a characteristic
302      of the archiver and should be independently tunable.  This value is
303      a WAG (wild a** guess) */
304   14,
305
306   /* align_power_min: minimum alignment restriction for any section
307      FIXME:  this value may be target machine dependent */
308   3,
309
310   /* Routines to byte-swap various sized integers from the data sections */
311   bfd_getl64, bfd_getl_signed_64, bfd_putl64,
312     bfd_getl32, bfd_getl_signed_32, bfd_putl32,
313     bfd_getl16, bfd_getl_signed_16, bfd_putl16,
314
315   /* Routines to byte-swap various sized integers from the file headers */
316   bfd_getl64, bfd_getl_signed_64, bfd_putl64,
317     bfd_getl32, bfd_getl_signed_32, bfd_putl32,
318     bfd_getl16, bfd_getl_signed_16, bfd_putl16,
319
320   /* bfd_check_format: check the format of a file being read */
321   { _bfd_dummy_target,          /* unknown format */
322     bfd_elf32_object_p,         /* assembler/linker output (object file) */
323     bfd_generic_archive_p,      /* an archive */
324     bfd_elf32_core_file_p       /* a core file */
325   },
326
327   /* bfd_set_format: set the format of a file being written */
328   { bfd_false,
329     bfd_elf_mkobject,
330     _bfd_generic_mkarchive,
331     bfd_false
332   },
333
334   /* bfd_write_contents: write cached information into a file being written */
335   { bfd_false,
336     bfd_elf32_write_object_contents,
337     _bfd_write_archive_contents,
338     bfd_false
339   },
340
341       BFD_JUMP_TABLE_GENERIC (bfd_elf32),
342       BFD_JUMP_TABLE_COPY (bfd_elf32),
343       BFD_JUMP_TABLE_CORE (bfd_elf32),
344       BFD_JUMP_TABLE_ARCHIVE (_bfd_archive_coff),
345       BFD_JUMP_TABLE_SYMBOLS (bfd_elf32),
346       BFD_JUMP_TABLE_RELOCS (bfd_elf32),
347       BFD_JUMP_TABLE_WRITE (bfd_elf32),
348       BFD_JUMP_TABLE_LINK (bfd_elf32),
349       BFD_JUMP_TABLE_DYNAMIC (bfd_elf32),
350
351   /* backend_data: */
352   (PTR) &elf32_bed,
353 };
354 #endif