source: mainline/uspace/app/taskdump/include/elf.h@ 0e26444

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 0e26444 was 83349b03, checked in by Jiri Svoboda <jiri@…>, 16 years ago

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