Subversion Repositories HelenOS-historic

Rev

Rev 1425 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 1425 Rev 1702
1
/*
1
/*
2
 * Copyright (C) 2006 Sergey Bondari
2
 * Copyright (C) 2006 Sergey Bondari
3
 * All rights reserved.
3
 * All rights reserved.
4
 *
4
 *
5
 * Redistribution and use in source and binary forms, with or without
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
6
 * modification, are permitted provided that the following conditions
7
 * are met:
7
 * are met:
8
 *
8
 *
9
 * - Redistributions of source code must retain the above copyright
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
13
 *   documentation and/or other materials provided with the distribution.
14
 * - The name of the author may not be used to endorse or promote products
14
 * - The name of the author may not be used to endorse or promote products
15
 *   derived from this software without specific prior written permission.
15
 *   derived from this software without specific prior written permission.
16
 *
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
27
 */
28
 
28
 
-
 
29
 /** @addtogroup generic   
-
 
30
 * @{
-
 
31
 */
-
 
32
/** @file
-
 
33
 */
-
 
34
 
29
#ifndef __ELF_H__
35
#ifndef __ELF_H__
30
#define __ELF_H__
36
#define __ELF_H__
31
 
37
 
32
#include <arch/elf.h>
38
#include <arch/elf.h>
33
#include <arch/types.h>
39
#include <arch/types.h>
34
#include <typedefs.h>
40
#include <typedefs.h>
35
 
41
 
36
/**
42
/**
37
 * current ELF version
43
 * current ELF version
38
 */
44
 */
39
#define EV_CURRENT  1
45
#define EV_CURRENT  1
40
 
46
 
41
/**
47
/**
42
 * ELF types
48
 * ELF types
43
 */
49
 */
44
#define ET_NONE     0   /* No type */
50
#define ET_NONE     0   /* No type */
45
#define ET_REL      1   /* Relocatable file */
51
#define ET_REL      1   /* Relocatable file */
46
#define ET_EXEC     2   /* Executable */
52
#define ET_EXEC     2   /* Executable */
47
#define ET_DYN      3   /* Shared object */
53
#define ET_DYN      3   /* Shared object */
48
#define ET_CORE     4   /* Core */
54
#define ET_CORE     4   /* Core */
49
#define ET_LOPROC   0xff00  /* Processor specific */
55
#define ET_LOPROC   0xff00  /* Processor specific */
50
#define ET_HIPROC   0xffff  /* Processor specific */
56
#define ET_HIPROC   0xffff  /* Processor specific */
51
 
57
 
52
/**
58
/**
53
 * ELF machine types
59
 * ELF machine types
54
 */
60
 */
55
#define EM_NO       0   /* No machine */
61
#define EM_NO       0   /* No machine */
56
#define EM_SPARC    2   /* SPARC */
62
#define EM_SPARC    2   /* SPARC */
57
#define EM_386      3   /* i386 */
63
#define EM_386      3   /* i386 */
58
#define EM_MIPS     8   /* MIPS RS3000 */
64
#define EM_MIPS     8   /* MIPS RS3000 */
59
#define EM_MIPS_RS3_LE  10  /* MIPS RS3000 LE */
65
#define EM_MIPS_RS3_LE  10  /* MIPS RS3000 LE */
60
#define EM_PPC      20  /* PPC32 */
66
#define EM_PPC      20  /* PPC32 */
61
#define EM_PPC64    21  /* PPC64 */
67
#define EM_PPC64    21  /* PPC64 */
62
#define EM_SPARCV9  43  /* SPARC64 */
68
#define EM_SPARCV9  43  /* SPARC64 */
63
#define EM_IA_64    50  /* IA-64 */
69
#define EM_IA_64    50  /* IA-64 */
64
#define EM_X86_64   62  /* AMD64/EMT64 */
70
#define EM_X86_64   62  /* AMD64/EMT64 */
65
 
71
 
66
/**
72
/**
67
 * ELF identification indexes
73
 * ELF identification indexes
68
 */
74
 */
69
#define EI_MAG0     0
75
#define EI_MAG0     0
70
#define EI_MAG1     1
76
#define EI_MAG1     1
71
#define EI_MAG2     2
77
#define EI_MAG2     2
72
#define EI_MAG3     3
78
#define EI_MAG3     3
73
#define EI_CLASS    4       /* File class */
79
#define EI_CLASS    4       /* File class */
74
#define EI_DATA     5       /* Data encoding */
80
#define EI_DATA     5       /* Data encoding */
75
#define EI_VERSION  6       /* File version */
81
#define EI_VERSION  6       /* File version */
76
#define EI_OSABI    7
82
#define EI_OSABI    7
77
#define EI_ABIVERSION   8
83
#define EI_ABIVERSION   8
78
#define EI_PAD      9       /* Start of padding bytes */
84
#define EI_PAD      9       /* Start of padding bytes */
79
#define EI_NIDENT   16      /* ELF identification table size */
85
#define EI_NIDENT   16      /* ELF identification table size */
80
 
86
 
81
/**
87
/**
82
 * ELF magic number
88
 * ELF magic number
83
 */
89
 */
84
#define ELFMAG0     0x7f
90
#define ELFMAG0     0x7f
85
#define ELFMAG1     'E'
91
#define ELFMAG1     'E'
86
#define ELFMAG2     'L'
92
#define ELFMAG2     'L'
87
#define ELFMAG3     'F'
93
#define ELFMAG3     'F'
88
 
94
 
89
/**
95
/**
90
 * ELF file classes
96
 * ELF file classes
91
 */
97
 */
92
#define ELFCLASSNONE    0
98
#define ELFCLASSNONE    0
93
#define ELFCLASS32  1
99
#define ELFCLASS32  1
94
#define ELFCLASS64  2
100
#define ELFCLASS64  2
95
 
101
 
96
/**
102
/**
97
 * ELF data encoding types
103
 * ELF data encoding types
98
 */
104
 */
99
#define ELFDATANONE 0
105
#define ELFDATANONE 0
100
#define ELFDATA2LSB 1       /* Least significant byte first (little endian) */
106
#define ELFDATA2LSB 1       /* Least significant byte first (little endian) */
101
#define ELFDATA2MSB 2       /* Most signigicant byte first (big endian) */
107
#define ELFDATA2MSB 2       /* Most signigicant byte first (big endian) */
102
 
108
 
103
/**
109
/**
104
 * ELF error return codes
110
 * ELF error return codes
105
 */
111
 */
106
#define EE_OK           0   /* No error */
112
#define EE_OK           0   /* No error */
107
#define EE_INVALID      1   /* Invalid ELF image */
113
#define EE_INVALID      1   /* Invalid ELF image */
108
#define EE_MEMORY       2   /* Cannot allocate address space */
114
#define EE_MEMORY       2   /* Cannot allocate address space */
109
#define EE_INCOMPATIBLE     3   /* ELF image is not compatible with current architecture */
115
#define EE_INCOMPATIBLE     3   /* ELF image is not compatible with current architecture */
110
#define EE_UNSUPPORTED      4   /* Non-supported ELF (e.g. dynamic ELFs) */
116
#define EE_UNSUPPORTED      4   /* Non-supported ELF (e.g. dynamic ELFs) */
111
#define EE_IRRECOVERABLE    5
117
#define EE_IRRECOVERABLE    5
112
 
118
 
113
/**
119
/**
114
 * ELF section types
120
 * ELF section types
115
 */
121
 */
116
#define SHT_NULL        0
122
#define SHT_NULL        0
117
#define SHT_PROGBITS        1
123
#define SHT_PROGBITS        1
118
#define SHT_SYMTAB      2
124
#define SHT_SYMTAB      2
119
#define SHT_STRTAB      3
125
#define SHT_STRTAB      3
120
#define SHT_RELA        4
126
#define SHT_RELA        4
121
#define SHT_HASH        5
127
#define SHT_HASH        5
122
#define SHT_DYNAMIC     6
128
#define SHT_DYNAMIC     6
123
#define SHT_NOTE        7
129
#define SHT_NOTE        7
124
#define SHT_NOBITS      8
130
#define SHT_NOBITS      8
125
#define SHT_REL         9
131
#define SHT_REL         9
126
#define SHT_SHLIB       10
132
#define SHT_SHLIB       10
127
#define SHT_DYNSYM      11
133
#define SHT_DYNSYM      11
128
#define SHT_LOOS        0x60000000
134
#define SHT_LOOS        0x60000000
129
#define SHT_HIOS        0x6fffffff
135
#define SHT_HIOS        0x6fffffff
130
#define SHT_LOPROC      0x70000000
136
#define SHT_LOPROC      0x70000000
131
#define SHT_HIPROC      0x7fffffff
137
#define SHT_HIPROC      0x7fffffff
132
#define SHT_LOUSER      0x80000000
138
#define SHT_LOUSER      0x80000000
133
#define SHT_HIUSER      0xffffffff
139
#define SHT_HIUSER      0xffffffff
134
 
140
 
135
/**
141
/**
136
 * ELF section flags
142
 * ELF section flags
137
 */
143
 */
138
#define SHF_WRITE       0x1 
144
#define SHF_WRITE       0x1 
139
#define SHF_ALLOC       0x2
145
#define SHF_ALLOC       0x2
140
#define SHF_EXECINSTR       0x4
146
#define SHF_EXECINSTR       0x4
141
#define SHF_MASKPROC        0xf0000000
147
#define SHF_MASKPROC        0xf0000000
142
 
148
 
143
/**
149
/**
144
 * Symbol binding
150
 * Symbol binding
145
 */
151
 */
146
#define STB_LOCAL       0
152
#define STB_LOCAL       0
147
#define STB_GLOBAL      1
153
#define STB_GLOBAL      1
148
#define STB_WEAK        2
154
#define STB_WEAK        2
149
#define STB_LOPROC      13
155
#define STB_LOPROC      13
150
#define STB_HIPROC      15
156
#define STB_HIPROC      15
151
 
157
 
152
/**
158
/**
153
 * Symbol types
159
 * Symbol types
154
 */
160
 */
155
#define STT_NOTYPE      0
161
#define STT_NOTYPE      0
156
#define STT_OBJECT      1
162
#define STT_OBJECT      1
157
#define STT_FUNC        2
163
#define STT_FUNC        2
158
#define STT_SECTION     3
164
#define STT_SECTION     3
159
#define STT_FILE        4
165
#define STT_FILE        4
160
#define STT_LOPROC      13
166
#define STT_LOPROC      13
161
#define STT_HIPROC      15
167
#define STT_HIPROC      15
162
 
168
 
163
/**
169
/**
164
 * Program segment types
170
 * Program segment types
165
 */
171
 */
166
#define PT_NULL         0
172
#define PT_NULL         0
167
#define PT_LOAD         1
173
#define PT_LOAD         1
168
#define PT_DYNAMIC      2
174
#define PT_DYNAMIC      2
169
#define PT_INTERP       3
175
#define PT_INTERP       3
170
#define PT_NOTE         4
176
#define PT_NOTE         4
171
#define PT_SHLIB        5
177
#define PT_SHLIB        5
172
#define PT_PHDR         6
178
#define PT_PHDR         6
173
#define PT_LOPROC       0x70000000
179
#define PT_LOPROC       0x70000000
174
#define PT_HIPROC       0x7fffffff
180
#define PT_HIPROC       0x7fffffff
175
 
181
 
176
/**
182
/**
177
 * Program segment attributes.
183
 * Program segment attributes.
178
 */
184
 */
179
#define PF_X    1
185
#define PF_X    1
180
#define PF_W    2
186
#define PF_W    2
181
#define PF_R    4
187
#define PF_R    4
182
 
188
 
183
/**
189
/**
184
 * ELF data types
190
 * ELF data types
185
 *
191
 *
186
 * These types are found to be identical in both 32-bit and 64-bit
192
 * These types are found to be identical in both 32-bit and 64-bit
187
 * ELF object file specifications. They are the only types used
193
 * ELF object file specifications. They are the only types used
188
 * in ELF header.
194
 * in ELF header.
189
 */
195
 */
190
typedef __u64 elf_xword;
196
typedef __u64 elf_xword;
191
typedef __s64 elf_sxword;
197
typedef __s64 elf_sxword;
192
typedef __u32 elf_word;
198
typedef __u32 elf_word;
193
typedef __s32 elf_sword;
199
typedef __s32 elf_sword;
194
typedef __u16 elf_half;
200
typedef __u16 elf_half;
195
 
201
 
196
/**
202
/**
197
 * 32-bit ELF data types.
203
 * 32-bit ELF data types.
198
 *
204
 *
199
 * These types are specific for 32-bit format.
205
 * These types are specific for 32-bit format.
200
 */
206
 */
201
typedef __u32 elf32_addr;
207
typedef __u32 elf32_addr;
202
typedef __u32 elf32_off;
208
typedef __u32 elf32_off;
203
 
209
 
204
/**
210
/**
205
 * 64-bit ELF data types.
211
 * 64-bit ELF data types.
206
 *
212
 *
207
 * These types are specific for 64-bit format.
213
 * These types are specific for 64-bit format.
208
 */
214
 */
209
typedef __u64 elf64_addr;
215
typedef __u64 elf64_addr;
210
typedef __u64 elf64_off;
216
typedef __u64 elf64_off;
211
 
217
 
212
/** ELF header */
218
/** ELF header */
213
struct elf32_header {
219
struct elf32_header {
214
    __u8 e_ident[EI_NIDENT];
220
    __u8 e_ident[EI_NIDENT];
215
    elf_half e_type;
221
    elf_half e_type;
216
    elf_half e_machine;
222
    elf_half e_machine;
217
    elf_word e_version;
223
    elf_word e_version;
218
    elf32_addr e_entry;
224
    elf32_addr e_entry;
219
    elf32_off e_phoff;
225
    elf32_off e_phoff;
220
    elf32_off e_shoff;
226
    elf32_off e_shoff;
221
    elf_word e_flags;
227
    elf_word e_flags;
222
    elf_half e_ehsize;
228
    elf_half e_ehsize;
223
    elf_half e_phentsize;
229
    elf_half e_phentsize;
224
    elf_half e_phnum;
230
    elf_half e_phnum;
225
    elf_half e_shentsize;
231
    elf_half e_shentsize;
226
    elf_half e_shnum;
232
    elf_half e_shnum;
227
    elf_half e_shstrndx;
233
    elf_half e_shstrndx;
228
};
234
};
229
struct elf64_header {
235
struct elf64_header {
230
    __u8 e_ident[EI_NIDENT];
236
    __u8 e_ident[EI_NIDENT];
231
    elf_half e_type;
237
    elf_half e_type;
232
    elf_half e_machine;
238
    elf_half e_machine;
233
    elf_word e_version;
239
    elf_word e_version;
234
    elf64_addr e_entry;
240
    elf64_addr e_entry;
235
    elf64_off e_phoff;
241
    elf64_off e_phoff;
236
    elf64_off e_shoff;
242
    elf64_off e_shoff;
237
    elf_word e_flags;
243
    elf_word e_flags;
238
    elf_half e_ehsize;
244
    elf_half e_ehsize;
239
    elf_half e_phentsize;
245
    elf_half e_phentsize;
240
    elf_half e_phnum;
246
    elf_half e_phnum;
241
    elf_half e_shentsize;
247
    elf_half e_shentsize;
242
    elf_half e_shnum;
248
    elf_half e_shnum;
243
    elf_half e_shstrndx;
249
    elf_half e_shstrndx;
244
};
250
};
245
 
251
 
246
/*
252
/*
247
 * ELF segment header.
253
 * ELF segment header.
248
 * Segments headers are also known as program headers.
254
 * Segments headers are also known as program headers.
249
 */
255
 */
250
struct elf32_segment_header {
256
struct elf32_segment_header {
251
    elf_word p_type;
257
    elf_word p_type;
252
    elf32_off p_offset;
258
    elf32_off p_offset;
253
    elf32_addr p_vaddr;
259
    elf32_addr p_vaddr;
254
    elf32_addr p_paddr;
260
    elf32_addr p_paddr;
255
    elf_word p_filesz;
261
    elf_word p_filesz;
256
    elf_word p_memsz;
262
    elf_word p_memsz;
257
    elf_word p_flags;
263
    elf_word p_flags;
258
    elf_word p_align;
264
    elf_word p_align;
259
};
265
};
260
struct elf64_segment_header {
266
struct elf64_segment_header {
261
    elf_word p_type;
267
    elf_word p_type;
262
    elf_word p_flags;
268
    elf_word p_flags;
263
    elf64_off p_offset;
269
    elf64_off p_offset;
264
    elf64_addr p_vaddr;
270
    elf64_addr p_vaddr;
265
    elf64_addr p_paddr;
271
    elf64_addr p_paddr;
266
    elf_xword p_filesz;
272
    elf_xword p_filesz;
267
    elf_xword p_memsz;
273
    elf_xword p_memsz;
268
    elf_xword p_align;
274
    elf_xword p_align;
269
};
275
};
270
 
276
 
271
/*
277
/*
272
 * ELF section header
278
 * ELF section header
273
 */
279
 */
274
struct elf32_section_header {
280
struct elf32_section_header {
275
    elf_word sh_name;
281
    elf_word sh_name;
276
    elf_word sh_type;
282
    elf_word sh_type;
277
    elf_word sh_flags;
283
    elf_word sh_flags;
278
    elf32_addr sh_addr;
284
    elf32_addr sh_addr;
279
    elf32_off sh_offset;
285
    elf32_off sh_offset;
280
    elf_word sh_size;
286
    elf_word sh_size;
281
    elf_word sh_link;
287
    elf_word sh_link;
282
    elf_word sh_info;
288
    elf_word sh_info;
283
    elf_word sh_addralign;
289
    elf_word sh_addralign;
284
    elf_word sh_entsize;
290
    elf_word sh_entsize;
285
};
291
};
286
struct elf64_section_header {
292
struct elf64_section_header {
287
    elf_word sh_name;
293
    elf_word sh_name;
288
    elf_word sh_type;
294
    elf_word sh_type;
289
    elf_xword sh_flags;
295
    elf_xword sh_flags;
290
    elf64_addr sh_addr;
296
    elf64_addr sh_addr;
291
    elf64_off sh_offset;
297
    elf64_off sh_offset;
292
    elf_xword sh_size;
298
    elf_xword sh_size;
293
    elf_word sh_link;
299
    elf_word sh_link;
294
    elf_word sh_info;
300
    elf_word sh_info;
295
    elf_xword sh_addralign;
301
    elf_xword sh_addralign;
296
    elf_xword sh_entsize;
302
    elf_xword sh_entsize;
297
};
303
};
298
 
304
 
299
/*
305
/*
300
 * ELF symbol table entry
306
 * ELF symbol table entry
301
 */
307
 */
302
struct elf32_symbol {
308
struct elf32_symbol {
303
    elf_word st_name;
309
    elf_word st_name;
304
    elf32_addr st_value;
310
    elf32_addr st_value;
305
    elf_word st_size;
311
    elf_word st_size;
306
    __u8 st_info;
312
    __u8 st_info;
307
    __u8 st_other;
313
    __u8 st_other;
308
    elf_half st_shndx;
314
    elf_half st_shndx;
309
};
315
};
310
struct elf64_symbol {
316
struct elf64_symbol {
311
    elf_word st_name;
317
    elf_word st_name;
312
    __u8 st_info;
318
    __u8 st_info;
313
    __u8 st_other;
319
    __u8 st_other;
314
    elf_half st_shndx;
320
    elf_half st_shndx;
315
    elf64_addr st_value;
321
    elf64_addr st_value;
316
    elf_xword st_size;
322
    elf_xword st_size;
317
};
323
};
318
 
324
 
319
#ifdef __32_BITS__ 
325
#ifdef __32_BITS__ 
320
typedef struct elf32_header elf_header_t;
326
typedef struct elf32_header elf_header_t;
321
typedef struct elf32_segment_header elf_segment_header_t;
327
typedef struct elf32_segment_header elf_segment_header_t;
322
typedef struct elf32_section_header elf_section_header_t;
328
typedef struct elf32_section_header elf_section_header_t;
323
typedef struct elf32_symbol elf_symbol_t;
329
typedef struct elf32_symbol elf_symbol_t;
324
#endif
330
#endif
325
#ifdef __64_BITS__
331
#ifdef __64_BITS__
326
typedef struct elf64_header elf_header_t;
332
typedef struct elf64_header elf_header_t;
327
typedef struct elf64_segment_header elf_segment_header_t;
333
typedef struct elf64_segment_header elf_segment_header_t;
328
typedef struct elf64_section_header elf_section_header_t;
334
typedef struct elf64_section_header elf_section_header_t;
329
typedef struct elf64_symbol elf_symbol_t;
335
typedef struct elf64_symbol elf_symbol_t;
330
#endif
336
#endif
331
 
337
 
332
extern int elf_load(elf_header_t *header, as_t * as);
338
extern int elf_load(elf_header_t *header, as_t * as);
333
extern char *elf_error(int rc);
339
extern char *elf_error(int rc);
334
 
340
 
335
#endif
341
#endif
-
 
342
 
-
 
343
 /** @}
-
 
344
 */
-
 
345
 
336
 
346