[8b80b72] | 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 |
|
---|
[b45c443] | 29 | /** @addtogroup generic
|
---|
| 30 | * @{
|
---|
| 31 | */
|
---|
| 32 | /** @file
|
---|
| 33 | */
|
---|
| 34 |
|
---|
[8b80b72] | 35 | #ifndef __ELF_H__
|
---|
| 36 | #define __ELF_H__
|
---|
| 37 |
|
---|
| 38 | #include <arch/elf.h>
|
---|
[de6b301] | 39 | #include <arch/types.h>
|
---|
[127c957b] | 40 | #include <typedefs.h>
|
---|
[de6b301] | 41 |
|
---|
| 42 | /**
|
---|
| 43 | * current ELF version
|
---|
| 44 | */
|
---|
| 45 | #define EV_CURRENT 1
|
---|
| 46 |
|
---|
| 47 | /**
|
---|
| 48 | * ELF types
|
---|
| 49 | */
|
---|
| 50 | #define ET_NONE 0 /* No type */
|
---|
| 51 | #define ET_REL 1 /* Relocatable file */
|
---|
| 52 | #define ET_EXEC 2 /* Executable */
|
---|
| 53 | #define ET_DYN 3 /* Shared object */
|
---|
| 54 | #define ET_CORE 4 /* Core */
|
---|
| 55 | #define ET_LOPROC 0xff00 /* Processor specific */
|
---|
| 56 | #define ET_HIPROC 0xffff /* Processor specific */
|
---|
| 57 |
|
---|
| 58 | /**
|
---|
| 59 | * ELF machine types
|
---|
| 60 | */
|
---|
| 61 | #define EM_NO 0 /* No machine */
|
---|
| 62 | #define EM_SPARC 2 /* SPARC */
|
---|
| 63 | #define EM_386 3 /* i386 */
|
---|
| 64 | #define EM_MIPS 8 /* MIPS RS3000 */
|
---|
| 65 | #define EM_MIPS_RS3_LE 10 /* MIPS RS3000 LE */
|
---|
| 66 | #define EM_PPC 20 /* PPC32 */
|
---|
| 67 | #define EM_PPC64 21 /* PPC64 */
|
---|
| 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_MASKPROC 0xf0000000
|
---|
| 148 |
|
---|
| 149 | /**
|
---|
| 150 | * Symbol binding
|
---|
| 151 | */
|
---|
| 152 | #define STB_LOCAL 0
|
---|
| 153 | #define STB_GLOBAL 1
|
---|
| 154 | #define STB_WEAK 2
|
---|
| 155 | #define STB_LOPROC 13
|
---|
| 156 | #define STB_HIPROC 15
|
---|
| 157 |
|
---|
| 158 | /**
|
---|
| 159 | * Symbol types
|
---|
| 160 | */
|
---|
| 161 | #define STT_NOTYPE 0
|
---|
| 162 | #define STT_OBJECT 1
|
---|
| 163 | #define STT_FUNC 2
|
---|
| 164 | #define STT_SECTION 3
|
---|
| 165 | #define STT_FILE 4
|
---|
| 166 | #define STT_LOPROC 13
|
---|
| 167 | #define STT_HIPROC 15
|
---|
| 168 |
|
---|
| 169 | /**
|
---|
| 170 | * Program segment types
|
---|
| 171 | */
|
---|
| 172 | #define PT_NULL 0
|
---|
| 173 | #define PT_LOAD 1
|
---|
| 174 | #define PT_DYNAMIC 2
|
---|
| 175 | #define PT_INTERP 3
|
---|
| 176 | #define PT_NOTE 4
|
---|
| 177 | #define PT_SHLIB 5
|
---|
| 178 | #define PT_PHDR 6
|
---|
| 179 | #define PT_LOPROC 0x70000000
|
---|
| 180 | #define PT_HIPROC 0x7fffffff
|
---|
| 181 |
|
---|
| 182 | /**
|
---|
| 183 | * Program segment attributes.
|
---|
| 184 | */
|
---|
| 185 | #define PF_X 1
|
---|
| 186 | #define PF_W 2
|
---|
| 187 | #define PF_R 4
|
---|
| 188 |
|
---|
| 189 | /**
|
---|
| 190 | * ELF data types
|
---|
| 191 | *
|
---|
| 192 | * These types are found to be identical in both 32-bit and 64-bit
|
---|
| 193 | * ELF object file specifications. They are the only types used
|
---|
| 194 | * in ELF header.
|
---|
| 195 | */
|
---|
[7f1c620] | 196 | typedef uint64_t elf_xword;
|
---|
| 197 | typedef int64_t elf_sxword;
|
---|
| 198 | typedef uint32_t elf_word;
|
---|
| 199 | typedef int32_t elf_sword;
|
---|
| 200 | typedef uint16_t elf_half;
|
---|
[de6b301] | 201 |
|
---|
| 202 | /**
|
---|
| 203 | * 32-bit ELF data types.
|
---|
| 204 | *
|
---|
| 205 | * These types are specific for 32-bit format.
|
---|
| 206 | */
|
---|
[7f1c620] | 207 | typedef uint32_t elf32_addr;
|
---|
| 208 | typedef uint32_t elf32_off;
|
---|
[de6b301] | 209 |
|
---|
| 210 | /**
|
---|
| 211 | * 64-bit ELF data types.
|
---|
| 212 | *
|
---|
| 213 | * These types are specific for 64-bit format.
|
---|
| 214 | */
|
---|
[7f1c620] | 215 | typedef uint64_t elf64_addr;
|
---|
| 216 | typedef uint64_t elf64_off;
|
---|
[de6b301] | 217 |
|
---|
| 218 | /** ELF header */
|
---|
| 219 | struct elf32_header {
|
---|
[7f1c620] | 220 | uint8_t e_ident[EI_NIDENT];
|
---|
[de6b301] | 221 | elf_half e_type;
|
---|
| 222 | elf_half e_machine;
|
---|
| 223 | elf_word e_version;
|
---|
| 224 | elf32_addr e_entry;
|
---|
| 225 | elf32_off e_phoff;
|
---|
| 226 | elf32_off e_shoff;
|
---|
| 227 | elf_word e_flags;
|
---|
| 228 | elf_half e_ehsize;
|
---|
| 229 | elf_half e_phentsize;
|
---|
| 230 | elf_half e_phnum;
|
---|
| 231 | elf_half e_shentsize;
|
---|
| 232 | elf_half e_shnum;
|
---|
| 233 | elf_half e_shstrndx;
|
---|
| 234 | };
|
---|
| 235 | struct elf64_header {
|
---|
[7f1c620] | 236 | uint8_t e_ident[EI_NIDENT];
|
---|
[de6b301] | 237 | elf_half e_type;
|
---|
| 238 | elf_half e_machine;
|
---|
| 239 | elf_word e_version;
|
---|
| 240 | elf64_addr e_entry;
|
---|
| 241 | elf64_off e_phoff;
|
---|
| 242 | elf64_off e_shoff;
|
---|
| 243 | elf_word e_flags;
|
---|
| 244 | elf_half e_ehsize;
|
---|
| 245 | elf_half e_phentsize;
|
---|
| 246 | elf_half e_phnum;
|
---|
| 247 | elf_half e_shentsize;
|
---|
| 248 | elf_half e_shnum;
|
---|
| 249 | elf_half e_shstrndx;
|
---|
| 250 | };
|
---|
| 251 |
|
---|
[78a95d6f] | 252 | /*
|
---|
| 253 | * ELF segment header.
|
---|
| 254 | * Segments headers are also known as program headers.
|
---|
| 255 | */
|
---|
| 256 | struct elf32_segment_header {
|
---|
| 257 | elf_word p_type;
|
---|
| 258 | elf32_off p_offset;
|
---|
| 259 | elf32_addr p_vaddr;
|
---|
| 260 | elf32_addr p_paddr;
|
---|
| 261 | elf_word p_filesz;
|
---|
| 262 | elf_word p_memsz;
|
---|
| 263 | elf_word p_flags;
|
---|
| 264 | elf_word p_align;
|
---|
| 265 | };
|
---|
| 266 | struct elf64_segment_header {
|
---|
| 267 | elf_word p_type;
|
---|
| 268 | elf_word p_flags;
|
---|
| 269 | elf64_off p_offset;
|
---|
| 270 | elf64_addr p_vaddr;
|
---|
| 271 | elf64_addr p_paddr;
|
---|
| 272 | elf_xword p_filesz;
|
---|
| 273 | elf_xword p_memsz;
|
---|
| 274 | elf_xword p_align;
|
---|
| 275 | };
|
---|
| 276 |
|
---|
[de6b301] | 277 | /*
|
---|
| 278 | * ELF section header
|
---|
| 279 | */
|
---|
| 280 | struct elf32_section_header {
|
---|
| 281 | elf_word sh_name;
|
---|
| 282 | elf_word sh_type;
|
---|
| 283 | elf_word sh_flags;
|
---|
| 284 | elf32_addr sh_addr;
|
---|
| 285 | elf32_off sh_offset;
|
---|
| 286 | elf_word sh_size;
|
---|
| 287 | elf_word sh_link;
|
---|
| 288 | elf_word sh_info;
|
---|
| 289 | elf_word sh_addralign;
|
---|
| 290 | elf_word sh_entsize;
|
---|
| 291 | };
|
---|
| 292 | struct elf64_section_header {
|
---|
| 293 | elf_word sh_name;
|
---|
| 294 | elf_word sh_type;
|
---|
| 295 | elf_xword sh_flags;
|
---|
| 296 | elf64_addr sh_addr;
|
---|
| 297 | elf64_off sh_offset;
|
---|
| 298 | elf_xword sh_size;
|
---|
| 299 | elf_word sh_link;
|
---|
| 300 | elf_word sh_info;
|
---|
| 301 | elf_xword sh_addralign;
|
---|
| 302 | elf_xword sh_entsize;
|
---|
| 303 | };
|
---|
| 304 |
|
---|
| 305 | /*
|
---|
| 306 | * ELF symbol table entry
|
---|
| 307 | */
|
---|
| 308 | struct elf32_symbol {
|
---|
| 309 | elf_word st_name;
|
---|
| 310 | elf32_addr st_value;
|
---|
| 311 | elf_word st_size;
|
---|
[7f1c620] | 312 | uint8_t st_info;
|
---|
| 313 | uint8_t st_other;
|
---|
[de6b301] | 314 | elf_half st_shndx;
|
---|
| 315 | };
|
---|
| 316 | struct elf64_symbol {
|
---|
| 317 | elf_word st_name;
|
---|
[7f1c620] | 318 | uint8_t st_info;
|
---|
| 319 | uint8_t st_other;
|
---|
[de6b301] | 320 | elf_half st_shndx;
|
---|
| 321 | elf64_addr st_value;
|
---|
| 322 | elf_xword st_size;
|
---|
| 323 | };
|
---|
| 324 |
|
---|
| 325 | #ifdef __32_BITS__
|
---|
| 326 | typedef struct elf32_header elf_header_t;
|
---|
[78a95d6f] | 327 | typedef struct elf32_segment_header elf_segment_header_t;
|
---|
[de6b301] | 328 | typedef struct elf32_section_header elf_section_header_t;
|
---|
| 329 | typedef struct elf32_symbol elf_symbol_t;
|
---|
| 330 | #endif
|
---|
| 331 | #ifdef __64_BITS__
|
---|
| 332 | typedef struct elf64_header elf_header_t;
|
---|
[78a95d6f] | 333 | typedef struct elf64_segment_header elf_segment_header_t;
|
---|
[de6b301] | 334 | typedef struct elf64_section_header elf_section_header_t;
|
---|
| 335 | typedef struct elf64_symbol elf_symbol_t;
|
---|
| 336 | #endif
|
---|
| 337 |
|
---|
| 338 | extern int elf_load(elf_header_t *header, as_t * as);
|
---|
| 339 | extern char *elf_error(int rc);
|
---|
[8b80b72] | 340 |
|
---|
| 341 | #endif
|
---|
[b45c443] | 342 |
|
---|
| 343 | /** @}
|
---|
| 344 | */
|
---|
| 345 |
|
---|