1/* ----------------------------------------------------------------------- *
2 *
3 * Copyright 1996-2009 The NASM Authors - All Rights Reserved
4 * See the file AUTHORS included with the NASM distribution for
5 * the specific copyright holders.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following
9 * conditions are met:
10 *
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above
14 * copyright notice, this list of conditions and the following
15 * disclaimer in the documentation and/or other materials provided
16 * with the distribution.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
19 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
20 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
23 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 *
32 * ----------------------------------------------------------------------- */
33
34#ifndef OUTPUT_ELF_H
35#define OUTPUT_ELF_H
36
37/*
38 * Since NASM support both Elf32/64 file formats
39 * we need to cover all types, structures, typedefs and etc
40 */
41
42#include "compiler.h"
43
44/* Segment types */
45#define PT_NULL 0
46#define PT_LOAD 1
47#define PT_DYNAMIC 2
48#define PT_INTERP 3
49#define PT_NOTE 4
50#define PT_SHLIB 5
51#define PT_PHDR 6
52#define PT_LOOS 0x60000000
53#define PT_HIOS 0x6fffffff
54#define PT_LOPROC 0x70000000
55#define PT_HIPROC 0x7fffffff
56#define PT_GNU_EH_FRAME 0x6474e550 /* Extension, eh? */
57
58/* ELF file types */
59#define ET_NONE 0
60#define ET_REL 1
61#define ET_EXEC 2
62#define ET_DYN 3
63#define ET_CORE 4
64#define ET_LOPROC 0xff00
65#define ET_HIPROC 0xffff
66
67/* ELF machine types */
68#define EM_NONE 0
69#define EM_M32 1
70#define EM_SPARC 2
71#define EM_386 3
72#define EM_68K 4
73#define EM_88K 5
74#define EM_486 6 /* Not used in Linux at least */
75#define EM_860 7
76#define EM_MIPS 8 /* R3k, bigendian(?) */
77#define EM_MIPS_RS4_BE 10 /* R4k BE */
78#define EM_PARISC 15
79#define EM_SPARC32PLUS 18
80#define EM_PPC 20
81#define EM_PPC64 21
82#define EM_S390 22
83#define EM_SH 42
84#define EM_SPARCV9 43 /* v9 = SPARC64 */
85#define EM_H8_300H 47
86#define EM_H8S 48
87#define EM_IA_64 50
88#define EM_X86_64 62
89#define EM_CRIS 76
90#define EM_V850 87
91#define EM_ALPHA 0x9026 /* Interrim Alpha that stuck around */
92#define EM_CYGNUS_V850 0x9080 /* Old v850 ID used by Cygnus */
93#define EM_S390_OLD 0xA390 /* Obsolete interrim value for S/390 */
94
95/* Dynamic type values */
96#define DT_NULL 0
97#define DT_NEEDED 1
98#define DT_PLTRELSZ 2
99#define DT_PLTGOT 3
100#define DT_HASH 4
101#define DT_STRTAB 5
102#define DT_SYMTAB 6
103#define DT_RELA 7
104#define DT_RELASZ 8
105#define DT_RELAENT 9
106#define DT_STRSZ 10
107#define DT_SYMENT 11
108#define DT_INIT 12
109#define DT_FINI 13
110#define DT_SONAME 14
111#define DT_RPATH 15
112#define DT_SYMBOLIC 16
113#define DT_REL 17
114#define DT_RELSZ 18
115#define DT_RELENT 19
116#define DT_PLTREL 20
117#define DT_DEBUG 21
118#define DT_TEXTREL 22
119#define DT_JMPREL 23
120#define DT_LOPROC 0x70000000
121#define DT_HIPROC 0x7fffffff
122
123/* Auxilliary table entries */
124#define AT_NULL 0 /* end of vector */
125#define AT_IGNORE 1 /* entry should be ignored */
126#define AT_EXECFD 2 /* file descriptor of program */
127#define AT_PHDR 3 /* program headers for program */
128#define AT_PHENT 4 /* size of program header entry */
129#define AT_PHNUM 5 /* number of program headers */
130#define AT_PAGESZ 6 /* system page size */
131#define AT_BASE 7 /* base address of interpreter */
132#define AT_FLAGS 8 /* flags */
133#define AT_ENTRY 9 /* entry point of program */
134#define AT_NOTELF 10 /* program is not ELF */
135#define AT_UID 11 /* real uid */
136#define AT_EUID 12 /* effective uid */
137#define AT_GID 13 /* real gid */
138#define AT_EGID 14 /* effective gid */
139#define AT_PLATFORM 15 /* string identifying CPU for optimizations */
140#define AT_HWCAP 16 /* arch dependent hints at CPU capabilities */
141#define AT_CLKTCK 17 /* frequency at which times() increments */
142/* 18..22 = ? */
143#define AT_SECURE 23 /* secure mode boolean */
144
145/* Program header permission flags */
146#define PF_X 0x1
147#define PF_W 0x2
148#define PF_R 0x4
149
150/* Section header types */
151#define SHT_NULL 0
152#define SHT_PROGBITS 1
153#define SHT_SYMTAB 2
154#define SHT_STRTAB 3
155#define SHT_RELA 4
156#define SHT_HASH 5
157#define SHT_DYNAMIC 6
158#define SHT_NOTE 7
159#define SHT_NOBITS 8
160#define SHT_REL 9
161#define SHT_SHLIB 10
162#define SHT_DYNSYM 11
163#define SHT_NUM 12
164#define SHT_LOPROC 0x70000000
165#define SHT_HIPROC 0x7fffffff
166#define SHT_LOUSER 0x80000000
167#define SHT_HIUSER 0xffffffff
168
169/* Section header flags */
170#define SHF_WRITE (1 << 0) /* Writable */
171#define SHF_ALLOC (1 << 1) /* Occupies memory during execution */
172#define SHF_EXECINSTR (1 << 2) /* Executable */
173#define SHF_MERGE (1 << 4) /* Might be merged */
174#define SHF_STRINGS (1 << 5) /* Contains nul-terminated strings */
175#define SHF_INFO_LINK (1 << 6) /* `sh_info' contains SHT index */
176#define SHF_LINK_ORDER (1 << 7) /* Preserve order after combining */
177#define SHF_OS_NONCONFORMING (1 << 8) /* Non-standard OS specific handling required */
178#define SHF_GROUP (1 << 9) /* Section is member of a group. */
179#define SHF_TLS (1 << 10) /* Section hold thread-local data. */
180
181/* Special section numbers */
182#define SHN_UNDEF 0
183#define SHN_LORESERVE 0xff00
184#define SHN_LOPROC 0xff00
185#define SHN_HIPROC 0xff1f
186#define SHN_ABS 0xfff1
187#define SHN_COMMON 0xfff2
188#define SHN_HIRESERVE 0xffff
189
190/* Section align flag */
191#define SHA_ANY 1 /* No alignment constraint */
192
193/* Lenght of magic at the start of a file */
194#define EI_NIDENT 16
195
196/* Magic number constants... */
197#define EI_MAG0 0 /* e_ident[] indexes */
198#define EI_MAG1 1
199#define EI_MAG2 2
200#define EI_MAG3 3
201#define EI_CLASS 4
202#define EI_DATA 5
203#define EI_VERSION 6
204#define EI_OSABI 7
205#define EI_ABIVERSION 8
206#define EI_NINDENT 16
207
208#define ELFMAG0 0x7f /* EI_MAG */
209#define ELFMAG1 'E'
210#define ELFMAG2 'L'
211#define ELFMAG3 'F'
212#define ELFMAG "\177ELF"
213#define SELFMAG 4
214
215#define ELFCLASSNONE 0 /* EI_CLASS */
216#define ELFCLASS32 1
217#define ELFCLASS64 2
218#define ELFCLASSNUM 3
219
220#define ELFDATANONE 0 /* e_ident[EI_DATA] */
221#define ELFDATA2LSB 1
222#define ELFDATA2MSB 2
223
224#define EV_NONE 0 /* e_version, EI_VERSION */
225#define EV_CURRENT 1
226#define EV_NUM 2
227
228#define ELFOSABI_NONE 0
229#define ELFOSABI_LINUX 3
230
231/* Legal values for ST_BIND subfield of st_info (symbol binding). */
232#define STB_LOCAL 0 /* Local symbol */
233#define STB_GLOBAL 1 /* Global symbol */
234#define STB_WEAK 2 /* Weak symbol */
235#define STB_NUM 3 /* Number of defined types. */
236#define STB_LOOS 10 /* Start of OS-specific */
237#define STB_HIOS 12 /* End of OS-specific */
238#define STB_LOPROC 13 /* Start of processor-specific */
239#define STB_HIPROC 15 /* End of processor-specific */
240
241/* Symbol types */
242#define STT_NOTYPE 0 /* Symbol type is unspecified */
243#define STT_OBJECT 1 /* Symbol is a data object */
244#define STT_FUNC 2 /* Symbol is a code object */
245#define STT_SECTION 3 /* Symbol associated with a section */
246#define STT_FILE 4 /* Symbol's name is file name */
247#define STT_COMMON 5 /* Symbol is a common data object */
248#define STT_TLS 6 /* Symbol is thread-local data object*/
249#define STT_NUM 7 /* Number of defined types. */
250
251/* Symbol visibilities */
252#define STV_DEFAULT 0 /* Default symbol visibility rules */
253#define STV_INTERNAL 1 /* Processor specific hidden class */
254#define STV_HIDDEN 2 /* Sym unavailable in other modules */
255#define STV_PROTECTED 3 /* Not preemptible, not exported */
256
257/* Both Elf32_Sym and Elf64_Sym use the same one-byte st_info field */
258#define ELF32_ST_BIND(i) ((i) >> 4)
259#define ELF32_ST_MKBIND(i) ((i) << 4) /* just a helper */
260#define ELF32_ST_TYPE(i) ((i) & 0xf)
261#define ELF32_ST_INFO(b, i) (ELF32_ST_MKBIND(b) + ELF32_ST_TYPE(i))
262
263#define ELF64_ST_BIND(i) ELF32_ST_BIND(i)
264#define ELF64_ST_MKBIND(i) ELF32_ST_MKBIND(i)
265#define ELF64_ST_TYPE(i) ELF32_ST_TYPE(i)
266#define ELF64_ST_INFO(b, i) ELF32_ST_INFO(b, i)
267
268/*
269 * ELF standard typedefs (yet more proof that <stdint.h> was way overdue)
270 */
271
272typedef uint16_t Elf32_Half;
273typedef int16_t Elf32_SHalf;
274typedef uint32_t Elf32_Word;
275typedef int32_t Elf32_Sword;
276typedef uint64_t Elf32_Xword;
277typedef int64_t Elf32_Sxword;
278
279typedef uint32_t Elf32_Off;
280typedef uint32_t Elf32_Addr;
281typedef uint16_t Elf32_Section;
282
283typedef uint16_t Elf64_Half;
284typedef int16_t Elf64_SHalf;
285typedef uint32_t Elf64_Word;
286typedef int32_t Elf64_Sword;
287typedef uint64_t Elf64_Xword;
288typedef int64_t Elf64_Sxword;
289
290typedef uint64_t Elf64_Off;
291typedef uint64_t Elf64_Addr;
292typedef uint16_t Elf64_Section;
293
294/*
295 * Dynamic header
296 */
297
298typedef struct elf32_dyn {
299 Elf32_Sword d_tag;
300 union {
301 Elf32_Sword d_val;
302 Elf32_Addr d_ptr;
303 } d_un;
304} Elf32_Dyn;
305
306typedef struct elf64_dyn {
307 Elf64_Sxword d_tag;
308 union {
309 Elf64_Xword d_val;
310 Elf64_Addr d_ptr;
311 } d_un;
312} Elf64_Dyn;
313
314/*
315 * Relocations
316 */
317
318#define ELF32_R_SYM(x) ((x) >> 8)
319#define ELF32_R_TYPE(x) ((x) & 0xff)
320#define ELF32_R_INFO(s,t) (((Elf32_Word)(s) << 8) + ELF32_R_TYPE(t))
321
322typedef struct elf32_rel {
323 Elf32_Addr r_offset;
324 Elf32_Word r_info;
325} Elf32_Rel;
326
327typedef struct elf32_rela {
328 Elf32_Addr r_offset;
329 Elf32_Word r_info;
330 Elf32_Sword r_addend;
331} Elf32_Rela;
332
333enum reloc32_type {
334 R_386_32 = 1, /* ordinary absolute relocation */
335 R_386_PC32 = 2, /* PC-relative relocation */
336 R_386_GOT32 = 3, /* an offset into GOT */
337 R_386_PLT32 = 4, /* a PC-relative offset into PLT */
338 R_386_COPY = 5, /* ??? */
339 R_386_GLOB_DAT = 6, /* ??? */
340 R_386_JUMP_SLOT = 7, /* ??? */
341 R_386_RELATIVE = 8, /* ??? */
342 R_386_GOTOFF = 9, /* an offset from GOT base */
343 R_386_GOTPC = 10, /* a PC-relative offset _to_ GOT */
344 R_386_TLS_TPOFF = 14, /* Offset in static TLS block */
345 R_386_TLS_IE = 15, /* Address of GOT entry for static TLS block offset */
346 /* These are GNU extensions, but useful */
347 R_386_16 = 20, /* A 16-bit absolute relocation */
348 R_386_PC16 = 21, /* A 16-bit PC-relative relocation */
349 R_386_8 = 22, /* An 8-bit absolute relocation */
350 R_386_PC8 = 23 /* An 8-bit PC-relative relocation */
351};
352
353#define ELF64_R_SYM(x) ((x) >> 32)
354#define ELF64_R_TYPE(x) ((x) & 0xffffffff)
355#define ELF64_R_INFO(s,t) (((Elf64_Xword)(s) << 32) + ELF64_R_TYPE(t))
356
357typedef struct elf64_rel {
358 Elf64_Addr r_offset;
359 Elf64_Xword r_info;
360} Elf64_Rel;
361
362typedef struct elf64_rela {
363 Elf64_Addr r_offset;
364 Elf64_Xword r_info;
365 Elf64_Sxword r_addend;
366} Elf64_Rela;
367
368enum reloc64_type {
369 R_X86_64_NONE = 0, /* No reloc */
370 R_X86_64_64 = 1, /* Direct 64 bit */
371 R_X86_64_PC32 = 2, /* PC relative 32 bit signed */
372 R_X86_64_GOT32 = 3, /* 32 bit GOT entry */
373 R_X86_64_PLT32 = 4, /* 32 bit PLT address */
374 R_X86_64_COPY = 5, /* Copy symbol at runtime */
375 R_X86_64_GLOB_DAT = 6, /* Create GOT entry */
376 R_X86_64_JUMP_SLOT = 7, /* Create PLT entry */
377 R_X86_64_RELATIVE = 8, /* Adjust by program base */
378 R_X86_64_GOTPCREL = 9, /* 32 bit signed PC relative offset to GOT */
379 R_X86_64_32 = 10, /* Direct 32 bit zero extended */
380 R_X86_64_32S = 11, /* Direct 32 bit sign extended */
381 R_X86_64_16 = 12, /* Direct 16 bit zero extended */
382 R_X86_64_PC16 = 13, /* 16 bit sign extended pc relative */
383 R_X86_64_8 = 14, /* Direct 8 bit sign extended */
384 R_X86_64_PC8 = 15, /* 8 bit sign extended pc relative */
385 R_X86_64_DTPMOD64 = 16, /* ID of module containing symbol */
386 R_X86_64_DTPOFF64 = 17, /* Offset in module's TLS block */
387 R_X86_64_TPOFF64 = 18, /* Offset in initial TLS block */
388 R_X86_64_TLSGD = 19, /* 32 bit signed PC relative offset to two GOT entries for GD symbol */
389 R_X86_64_TLSLD = 20, /* 32 bit signed PC relative offset to two GOT entries for LD symbol */
390 R_X86_64_DTPOFF32 = 21, /* Offset in TLS block */
391 R_X86_64_GOTTPOFF = 22, /* 32 bit signed PC relative offset to GOT entry for IE symbol */
392 R_X86_64_TPOFF32 = 23, /* Offset in initial TLS block */
393 R_X86_64_PC64 = 24, /* word64 S + A - P */
394 R_X86_64_GOTOFF64 = 25, /* word64 S + A - GOT */
395 R_X86_64_GOTPC32 = 26, /* word32 GOT + A - P */
396 R_X86_64_GOT64 = 27, /* word64 G + A */
397 R_X86_64_GOTPCREL64 = 28, /* word64 G + GOT - P + A */
398 R_X86_64_GOTPC64 = 29, /* word64 GOT - P + A */
399 R_X86_64_GOTPLT64 = 30, /* word64 G + A */
400 R_X86_64_PLTOFF64 = 31, /* word64 L - GOT + A */
401 R_X86_64_SIZE32 = 32, /* word32 Z + A */
402 R_X86_64_SIZE64 = 33, /* word64 Z + A */
403 R_X86_64_GOTPC32_TLSDESC = 34, /* word32 */
404 R_X86_64_TLSDESC_CALL = 35, /* none */
405 R_X86_64_TLSDESC = 36 /* word64?2 */
406};
407
408/*
409 * Symbol
410 */
411
412typedef struct elf32_sym {
413 Elf32_Word st_name;
414 Elf32_Addr st_value;
415 Elf32_Word st_size;
416 unsigned char st_info;
417 unsigned char st_other;
418 Elf32_Half st_shndx;
419} Elf32_Sym;
420
421typedef struct elf64_sym {
422 Elf64_Word st_name;
423 unsigned char st_info;
424 unsigned char st_other;
425 Elf64_Half st_shndx;
426 Elf64_Addr st_value;
427 Elf64_Xword st_size;
428} Elf64_Sym;
429
430/*
431 * Main file header
432 */
433
434typedef struct elf32_hdr {
435 unsigned char e_ident[EI_NIDENT];
436 Elf32_Half e_type;
437 Elf32_Half e_machine;
438 Elf32_Word e_version;
439 Elf32_Addr e_entry;
440 Elf32_Off e_phoff;
441 Elf32_Off e_shoff;
442 Elf32_Word e_flags;
443 Elf32_Half e_ehsize;
444 Elf32_Half e_phentsize;
445 Elf32_Half e_phnum;
446 Elf32_Half e_shentsize;
447 Elf32_Half e_shnum;
448 Elf32_Half e_shstrndx;
449} Elf32_Ehdr;
450
451typedef struct elf64_hdr {
452 unsigned char e_ident[EI_NIDENT];
453 Elf64_Half e_type;
454 Elf64_Half e_machine;
455 Elf64_Word e_version;
456 Elf64_Addr e_entry;
457 Elf64_Off e_phoff;
458 Elf64_Off e_shoff;
459 Elf64_Word e_flags;
460 Elf64_Half e_ehsize;
461 Elf64_Half e_phentsize;
462 Elf64_Half e_phnum;
463 Elf64_Half e_shentsize;
464 Elf64_Half e_shnum;
465 Elf64_Half e_shstrndx;
466} Elf64_Ehdr;
467
468/*
469 * Program header
470 */
471
472typedef struct elf32_phdr {
473 Elf32_Word p_type;
474 Elf32_Off p_offset;
475 Elf32_Addr p_vaddr;
476 Elf32_Addr p_paddr;
477 Elf32_Word p_filesz;
478 Elf32_Word p_memsz;
479 Elf32_Word p_flags;
480 Elf32_Word p_align;
481} Elf32_Phdr;
482
483typedef struct elf64_phdr {
484 Elf64_Word p_type;
485 Elf64_Word p_flags;
486 Elf64_Off p_offset;
487 Elf64_Addr p_vaddr;
488 Elf64_Addr p_paddr;
489 Elf64_Xword p_filesz;
490 Elf64_Xword p_memsz;
491 Elf64_Xword p_align;
492} Elf64_Phdr;
493
494/*
495 * Section header
496 */
497
498typedef struct elf32_shdr {
499 Elf32_Word sh_name;
500 Elf32_Word sh_type;
501 Elf32_Word sh_flags;
502 Elf32_Addr sh_addr;
503 Elf32_Off sh_offset;
504 Elf32_Word sh_size;
505 Elf32_Word sh_link;
506 Elf32_Word sh_info;
507 Elf32_Word sh_addralign;
508 Elf32_Word sh_entsize;
509} Elf32_Shdr;
510
511typedef struct elf64_shdr {
512 Elf64_Word sh_name;
513 Elf64_Word sh_type;
514 Elf64_Xword sh_flags;
515 Elf64_Addr sh_addr;
516 Elf64_Off sh_offset;
517 Elf64_Xword sh_size;
518 Elf64_Word sh_link;
519 Elf64_Word sh_info;
520 Elf64_Xword sh_addralign;
521 Elf64_Xword sh_entsize;
522} Elf64_Shdr;
523
524/*
525 * Note header
526 */
527typedef struct elf32_note {
528 Elf32_Word n_namesz; /* Name size */
529 Elf32_Word n_descsz; /* Content size */
530 Elf32_Word n_type; /* Content type */
531} Elf32_Nhdr;
532
533typedef struct elf64_note {
534 Elf64_Word n_namesz; /* Name size */
535 Elf64_Word n_descsz; /* Content size */
536 Elf64_Word n_type; /* Content type */
537} Elf64_Nhdr;
538
539#endif /* OUTPUT_ELF_H */
540