jcs.org
Serenity Operating System
1/* $OpenBSD: exec_elf.h,v 1.83 2019/01/22 23:23:18 jsg Exp $ */
2/*
3 * Copyright (c) 1995, 1996 Erik Theisen. 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 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. The name of the author may not be used to endorse or promote products
14 * derived from this software without specific prior written permission
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 */
27
28/*
29 * This is the ELF ABI header file
30 * formerly known as "elf_abi.h".
31 */
32
33#ifndef _SYS_EXEC_ELF_H_
34#define _SYS_EXEC_ELF_H_
35
36#include <AK/Types.h>
37
38typedef uint8_t Elf_Byte;
39
40typedef uint32_t Elf32_Addr; /* Unsigned program address */
41typedef uint32_t Elf32_Off; /* Unsigned file offset */
42typedef int32_t Elf32_Sword; /* Signed large integer */
43typedef uint32_t Elf32_Word; /* Unsigned large integer */
44typedef uint16_t Elf32_Half; /* Unsigned medium integer */
45typedef uint64_t Elf32_Lword;
46
47typedef uint64_t Elf64_Addr;
48typedef uint64_t Elf64_Off;
49typedef int32_t Elf64_Shalf;
50
51#ifdef __alpha__
52typedef int64_t Elf64_Sword;
53typedef uint64_t Elf64_Word;
54#else
55typedef int32_t Elf64_Sword;
56typedef uint32_t Elf64_Word;
57#endif
58
59typedef int64_t Elf64_Sxword;
60typedef uint64_t Elf64_Xword;
61typedef uint64_t Elf64_Lword;
62
63typedef uint32_t Elf64_Half;
64typedef uint16_t Elf64_Quarter;
65
66/*
67 * e_ident[] identification indexes
68 * See http://www.sco.com/developers/gabi/latest/ch4.eheader.html
69 */
70#define EI_MAG0 0 /* file ID */
71#define EI_MAG1 1 /* file ID */
72#define EI_MAG2 2 /* file ID */
73#define EI_MAG3 3 /* file ID */
74#define EI_CLASS 4 /* file class */
75#define EI_DATA 5 /* data encoding */
76#define EI_VERSION 6 /* ELF header version */
77#define EI_OSABI 7 /* OS/ABI ID */
78#define EI_ABIVERSION 8 /* ABI version */
79#define EI_PAD 9 /* start of pad bytes */
80#define EI_NIDENT 16 /* Gfx::Size of e_ident[] */
81
82/* e_ident[] magic number */
83#define ELFMAG0 0x7f /* e_ident[EI_MAG0] */
84#define ELFMAG1 'E' /* e_ident[EI_MAG1] */
85#define ELFMAG2 'L' /* e_ident[EI_MAG2] */
86#define ELFMAG3 'F' /* e_ident[EI_MAG3] */
87#define ELFMAG "\177ELF" /* magic */
88#define SELFMAG 4 /* size of magic */
89
90/* e_ident[] file class */
91#define ELFCLASSNONE 0 /* invalid */
92#define ELFCLASS32 1 /* 32-bit objs */
93#define ELFCLASS64 2 /* 64-bit objs */
94#define ELFCLASSNUM 3 /* number of classes */
95
96/* e_ident[] data encoding */
97#define ELFDATANONE 0 /* invalid */
98#define ELFDATA2LSB 1 /* Little-Endian */
99#define ELFDATA2MSB 2 /* Big-Endian */
100#define ELFDATANUM 3 /* number of data encode defines */
101
102/* e_ident[] Operating System/ABI */
103#define ELFOSABI_SYSV 0 /* UNIX System V ABI */
104#define ELFOSABI_HPUX 1 /* HP-UX operating system */
105#define ELFOSABI_NETBSD 2 /* NetBSD */
106#define ELFOSABI_LINUX 3 /* GNU/Linux */
107#define ELFOSABI_HURD 4 /* GNU/Hurd */
108#define ELFOSABI_86OPEN 5 /* 86Open common IA32 ABI */
109#define ELFOSABI_SOLARIS 6 /* Solaris */
110#define ELFOSABI_MONTEREY 7 /* Monterey */
111#define ELFOSABI_IRIX 8 /* IRIX */
112#define ELFOSABI_FREEBSD 9 /* FreeBSD */
113#define ELFOSABI_TRU64 10 /* TRU64 UNIX */
114#define ELFOSABI_MODESTO 11 /* Novell Modesto */
115#define ELFOSABI_OPENBSD 12 /* OpenBSD */
116#define ELFOSABI_ARM 97 /* ARM */
117#define ELFOSABI_STANDALONE 255 /* Standalone (embedded) application */
118
119/* e_ident */
120#define IS_ELF(ehdr) ((ehdr).e_ident[EI_MAG0] == ELFMAG0 && (ehdr).e_ident[EI_MAG1] == ELFMAG1 && (ehdr).e_ident[EI_MAG2] == ELFMAG2 && (ehdr).e_ident[EI_MAG3] == ELFMAG3)
121
122/* ELF Header */
123typedef struct elfhdr {
124 unsigned char e_ident[EI_NIDENT]; /* ELF Identification */
125 Elf32_Half e_type; /* object file type */
126 Elf32_Half e_machine; /* machine */
127 Elf32_Word e_version; /* object file version */
128 Elf32_Addr e_entry; /* virtual entry point */
129 Elf32_Off e_phoff; /* program header table offset */
130 Elf32_Off e_shoff; /* section header table offset */
131 Elf32_Word e_flags; /* processor-specific flags */
132 Elf32_Half e_ehsize; /* ELF header size */
133 Elf32_Half e_phentsize; /* program header entry size */
134 Elf32_Half e_phnum; /* number of program header entries */
135 Elf32_Half e_shentsize; /* section header entry size */
136 Elf32_Half e_shnum; /* number of section header entries */
137 Elf32_Half e_shstrndx; /* section header table's "section
138 header string table" entry offset */
139} Elf32_Ehdr;
140
141typedef struct {
142 unsigned char e_ident[EI_NIDENT]; /* Id bytes */
143 Elf64_Quarter e_type; /* file type */
144 Elf64_Quarter e_machine; /* machine type */
145 Elf64_Half e_version; /* version number */
146 Elf64_Addr e_entry; /* entry point */
147 Elf64_Off e_phoff; /* Program hdr offset */
148 Elf64_Off e_shoff; /* Section hdr offset */
149 Elf64_Half e_flags; /* Processor flags */
150 Elf64_Quarter e_ehsize; /* sizeof ehdr */
151 Elf64_Quarter e_phentsize; /* Program header entry size */
152 Elf64_Quarter e_phnum; /* Number of program headers */
153 Elf64_Quarter e_shentsize; /* Section header entry size */
154 Elf64_Quarter e_shnum; /* Number of section headers */
155 Elf64_Quarter e_shstrndx; /* String table index */
156} Elf64_Ehdr;
157
158/* e_type */
159#define ET_NONE 0 /* No file type */
160#define ET_REL 1 /* relocatable file */
161#define ET_EXEC 2 /* executable file */
162#define ET_DYN 3 /* shared object file */
163#define ET_CORE 4 /* core file */
164#define ET_NUM 5 /* number of types */
165#define ET_LOPROC 0xff00 /* reserved range for processor */
166#define ET_HIPROC 0xffff /* specific e_type */
167
168/* e_machine */
169#define EM_NONE 0 /* No Machine */
170#define EM_M32 1 /* AT&T WE 32100 */
171#define EM_SPARC 2 /* SPARC */
172#define EM_386 3 /* Intel 80386 */
173#define EM_68K 4 /* Motorola 68000 */
174#define EM_88K 5 /* Motorola 88000 */
175#define EM_486 6 /* Intel 80486 - unused? */
176#define EM_860 7 /* Intel 80860 */
177#define EM_MIPS 8 /* MIPS R3000 Big-Endian only */
178/*
179 * Don't know if EM_MIPS_RS4_BE,
180 * EM_SPARC64, EM_PARISC,
181 * or EM_PPC are ABI compliant
182 */
183#define EM_MIPS_RS4_BE 10 /* MIPS R4000 Big-Endian */
184#define EM_SPARC64 11 /* SPARC v9 64-bit unofficial */
185#define EM_PARISC 15 /* HPPA */
186#define EM_SPARC32PLUS 18 /* Enhanced instruction set SPARC */
187#define EM_PPC 20 /* PowerPC */
188#define EM_PPC64 21 /* PowerPC 64 */
189#define EM_ARM 40 /* Advanced RISC Machines ARM */
190#define EM_ALPHA 41 /* DEC ALPHA */
191#define EM_SH 42 /* Hitachi/Renesas Super-H */
192#define EM_SPARCV9 43 /* SPARC version 9 */
193#define EM_IA_64 50 /* Intel IA-64 Processor */
194#define EM_AMD64 62 /* AMD64 architecture */
195#define EM_X86_64 EM_AMD64
196#define EM_VAX 75 /* DEC VAX */
197#define EM_AARCH64 183 /* ARM 64-bit architecture (AArch64) */
198
199/* Non-standard */
200#define EM_ALPHA_EXP 0x9026 /* DEC ALPHA */
201#define EM__LAST__ (EM_ALPHA_EXP + 1)
202
203#define EM_NUM 22 /* number of machine types */
204
205/* Version */
206#define EV_NONE 0 /* Invalid */
207#define EV_CURRENT 1 /* Current */
208#define EV_NUM 2 /* number of versions */
209
210/* Magic for e_phnum: get real value from sh_info of first section header */
211#define PN_XNUM 0xffff
212
213/* Section Header */
214typedef struct {
215 Elf32_Word sh_name; /* name - index into section header
216 string table section */
217 Elf32_Word sh_type; /* type */
218 Elf32_Word sh_flags; /* flags */
219 Elf32_Addr sh_addr; /* address */
220 Elf32_Off sh_offset; /* file offset */
221 Elf32_Word sh_size; /* section size */
222 Elf32_Word sh_link; /* section header table index link */
223 Elf32_Word sh_info; /* extra information */
224 Elf32_Word sh_addralign; /* address alignment */
225 Elf32_Word sh_entsize; /* section entry size */
226} Elf32_Shdr;
227
228typedef struct {
229 Elf64_Half sh_name; /* section name */
230 Elf64_Half sh_type; /* section type */
231 Elf64_Xword sh_flags; /* section flags */
232 Elf64_Addr sh_addr; /* virtual address */
233 Elf64_Off sh_offset; /* file offset */
234 Elf64_Xword sh_size; /* section size */
235 Elf64_Half sh_link; /* link to another */
236 Elf64_Half sh_info; /* misc info */
237 Elf64_Xword sh_addralign; /* memory alignment */
238 Elf64_Xword sh_entsize; /* table entry size */
239} Elf64_Shdr;
240
241/* Special Section Indexes */
242#define SHN_UNDEF 0 /* undefined */
243#define SHN_LORESERVE 0xff00 /* lower bounds of reserved indexes */
244#define SHN_LOPROC 0xff00 /* reserved range for processor */
245#define SHN_HIPROC 0xff1f /* specific section indexes */
246#define SHN_ABS 0xfff1 /* absolute value */
247#define SHN_COMMON 0xfff2 /* common symbol */
248#define SHN_XINDEX 0xffff /* Escape -- index stored elsewhere. */
249#define SHN_HIRESERVE 0xffff /* upper bounds of reserved indexes */
250
251/* sh_type */
252#define SHT_NULL 0 /* inactive */
253#define SHT_PROGBITS 1 /* program defined information */
254#define SHT_SYMTAB 2 /* symbol table section */
255#define SHT_STRTAB 3 /* string table section */
256#define SHT_RELA 4 /* relocation section with addends*/
257#define SHT_HASH 5 /* symbol hash table section */
258#define SHT_DYNAMIC 6 /* dynamic section */
259#define SHT_NOTE 7 /* note section */
260#define SHT_NOBITS 8 /* no space section */
261#define SHT_REL 9 /* relation section without addends */
262#define SHT_SHLIB 10 /* reserved - purpose unknown */
263#define SHT_DYNSYM 11 /* dynamic symbol table section */
264#define SHT_NUM 12 /* number of section types */
265#define SHT_INIT_ARRAY 14 /* pointers to init functions */
266#define SHT_FINI_ARRAY 15 /* pointers to termination functions */
267#define SHT_PREINIT_ARRAY 16 /* ptrs to funcs called before init */
268#define SHT_GROUP 17 /* defines a section group */
269#define SHT_SYMTAB_SHNDX 18 /* Section indexes (see SHN_XINDEX). */
270#define SHT_LOOS 0x60000000 /* reserved range for OS specific */
271#define SHT_SUNW_dof 0x6ffffff4 /* used by dtrace */
272#define SHT_GNU_LIBLIST 0x6ffffff7 /* libraries to be prelinked */
273#define SHT_SUNW_move 0x6ffffffa /* inf for partially init'ed symbols */
274#define SHT_SUNW_syminfo 0x6ffffffc /* ad symbol information */
275#define SHT_SUNW_verdef 0x6ffffffd /* symbol versioning inf */
276#define SHT_SUNW_verneed 0x6ffffffe /* symbol versioning req */
277#define SHT_SUNW_versym 0x6fffffff /* symbol versioning table */
278#define SHT_HIOS 0x6fffffff /* section header types */
279#define SHT_LOPROC 0x70000000 /* reserved range for processor */
280#define SHT_HIPROC 0x7fffffff /* specific section header types */
281#define SHT_LOUSER 0x80000000 /* reserved range for application */
282#define SHT_HIUSER 0xffffffff /* specific indexes */
283
284#define SHT_GNU_HASH 0x6ffffff6 /* GNU-style hash table section */
285
286/* Section names */
287#define ELF_BSS ".bss" /* uninitialized data */
288#define ELF_DATA ".data" /* initialized data */
289#define ELF_CTF ".SUNW_ctf" /* CTF data */
290#define ELF_DEBUG ".debug" /* debug */
291#define ELF_DYNAMIC ".dynamic" /* dynamic linking information */
292#define ELF_DYNSTR ".dynstr" /* dynamic string table */
293#define ELF_DYNSYM ".dynsym" /* dynamic symbol table */
294#define ELF_FINI ".fini" /* termination code */
295#define ELF_GOT ".got" /* global offset table */
296#define ELF_HASH ".hash" /* symbol hash table */
297#define ELF_INIT ".init" /* initialization code */
298#define ELF_REL_DATA ".rel.data" /* relocation data */
299#define ELF_REL_FINI ".rel.fini" /* relocation termination code */
300#define ELF_REL_INIT ".rel.init" /* relocation initialization code */
301#define ELF_REL_DYN ".rel.dyn" /* relocation dynamic link info */
302#define ELF_REL_RODATA ".rel.rodata" /* relocation read-only data */
303#define ELF_REL_TEXT ".rel.text" /* relocation code */
304#define ELF_RODATA ".rodata" /* read-only data */
305#define ELF_SHSTRTAB ".shstrtab" /* section header string table */
306#define ELF_STRTAB ".strtab" /* string table */
307#define ELF_SYMTAB ".symtab" /* symbol table */
308#define ELF_TEXT ".text" /* code */
309#define ELF_OPENBSDRANDOMDATA ".openbsd.randomdata" /* constant randomdata */
310
311/* Section Attribute Flags - sh_flags */
312#define SHF_WRITE 0x1 /* Writable */
313#define SHF_ALLOC 0x2 /* occupies memory */
314#define SHF_EXECINSTR 0x4 /* executable */
315#define SHF_MERGE 0x10 /* may be merged */
316#define SHF_STRINGS 0x20 /* contains strings */
317#define SHF_INFO_LINK 0x40 /* sh_info holds section index */
318#define SHF_LINK_ORDER 0x80 /* ordering requirements */
319#define SHF_OS_NONCONFORMING 0x100 /* OS-specific processing required */
320#define SHF_GROUP 0x200 /* member of section group */
321#define SHF_TLS 0x400 /* thread local storage */
322#define SHF_COMPRESSED 0x800 /* contains compressed data */
323#define SHF_MASKOS 0x0ff00000 /* OS-specific semantics */
324#define SHF_MASKPROC 0xf0000000 /* reserved bits for processor */
325 /* specific section attributes */
326
327/* Symbol Table Entry */
328typedef struct elf32_sym {
329 Elf32_Word st_name; /* name - index into string table */
330 Elf32_Addr st_value; /* symbol value */
331 Elf32_Word st_size; /* symbol size */
332 unsigned char st_info; /* type and binding */
333 unsigned char st_other; /* 0 - no defined meaning */
334 Elf32_Half st_shndx; /* section header index */
335} Elf32_Sym;
336
337typedef struct {
338 Elf64_Half st_name; /* Symbol name index in str table */
339 Elf_Byte st_info; /* type / binding attrs */
340 Elf_Byte st_other; /* unused */
341 Elf64_Quarter st_shndx; /* section index of symbol */
342 Elf64_Xword st_value; /* value of symbol */
343 Elf64_Xword st_size; /* size of symbol */
344} Elf64_Sym;
345
346/* Symbol table index */
347#define STN_UNDEF 0 /* undefined */
348
349/* Extract symbol info - st_info */
350#define ELF32_ST_BIND(x) ((x) >> 4)
351#define ELF32_ST_TYPE(x) (((unsigned int)x) & 0xf)
352#define ELF32_ST_INFO(b, t) (((b) << 4) + ((t)&0xf))
353
354#define ELF64_ST_BIND(x) ((x) >> 4)
355#define ELF64_ST_TYPE(x) (((unsigned int)x) & 0xf)
356#define ELF64_ST_INFO(b, t) (((b) << 4) + ((t)&0xf))
357
358/* Symbol Binding - ELF32_ST_BIND - st_info */
359#define STB_LOCAL 0 /* Local symbol */
360#define STB_GLOBAL 1 /* Global symbol */
361#define STB_WEAK 2 /* like global - lower precedence */
362#define STB_NUM 3 /* number of symbol bindings */
363#define STB_LOPROC 13 /* reserved range for processor */
364#define STB_HIPROC 15 /* specific symbol bindings */
365
366/* Symbol type - ELF32_ST_TYPE - st_info */
367#define STT_NOTYPE 0 /* not specified */
368#define STT_OBJECT 1 /* data object */
369#define STT_FUNC 2 /* function */
370#define STT_SECTION 3 /* section */
371#define STT_FILE 4 /* file */
372#define STT_TLS 6 /* thread local storage */
373#define STT_LOPROC 13 /* reserved range for processor */
374#define STT_HIPROC 15 /* specific symbol types */
375
376/* Extract symbol visibility - st_other */
377#define ELF_ST_VISIBILITY(v) ((v)&0x3)
378#define ELF32_ST_VISIBILITY ELF_ST_VISIBILITY
379#define ELF64_ST_VISIBILITY ELF_ST_VISIBILITY
380
381#define STV_DEFAULT 0 /* Visibility set by binding type */
382#define STV_INTERNAL 1 /* OS specific version of STV_HIDDEN */
383#define STV_HIDDEN 2 /* can only be seen inside own .so */
384#define STV_PROTECTED 3 /* HIDDEN inside, DEFAULT outside */
385
386/* Relocation entry with implicit addend */
387typedef struct {
388 Elf32_Addr r_offset; /* offset of relocation */
389 Elf32_Word r_info; /* symbol table index and type */
390} Elf32_Rel;
391
392/* Relocation entry with explicit addend */
393typedef struct {
394 Elf32_Addr r_offset; /* offset of relocation */
395 Elf32_Word r_info; /* symbol table index and type */
396 Elf32_Sword r_addend;
397} Elf32_Rela;
398
399/* Extract relocation info - r_info */
400#define ELF32_R_SYM(i) ((i) >> 8)
401#define ELF32_R_TYPE(i) ((unsigned char)(i))
402#define ELF32_R_INFO(s, t) (((s) << 8) + (unsigned char)(t))
403
404typedef struct {
405 Elf64_Xword r_offset; /* where to do it */
406 Elf64_Xword r_info; /* index & type of relocation */
407} Elf64_Rel;
408
409typedef struct {
410 Elf64_Xword r_offset; /* where to do it */
411 Elf64_Xword r_info; /* index & type of relocation */
412 Elf64_Sxword r_addend; /* adjustment value */
413} Elf64_Rela;
414
415#define ELF64_R_SYM(info) ((info) >> 32)
416#define ELF64_R_TYPE(info) ((info)&0xFFFFFFFF)
417#define ELF64_R_INFO(s, t) (((s) << 32) + (uint32_t)(t))
418
419#if defined(__mips64__) && defined(__MIPSEL__)
420/*
421 * The 64-bit MIPS ELF ABI uses a slightly different relocation format
422 * than the regular ELF ABI: the r_info field is split into several
423 * pieces (see gnu/usr.bin/binutils-2.17/include/elf/mips.h for details).
424 */
425# undef ELF64_R_SYM
426# undef ELF64_R_TYPE
427# undef ELF64_R_INFO
428# define ELF64_R_TYPE(info) ((uint64_t)swap32((info) >> 32))
429# define ELF64_R_SYM(info) ((info)&0xFFFFFFFF)
430# define ELF64_R_INFO(s, t) (((uint64_t)swap32(t) << 32) + (uint32_t)(s))
431#endif /* __mips64__ && __MIPSEL__ */
432
433/* Program Header */
434typedef struct {
435 Elf32_Word p_type; /* segment type */
436 Elf32_Off p_offset; /* segment offset */
437 Elf32_Addr p_vaddr; /* virtual address of segment */
438 Elf32_Addr p_paddr; /* physical address - ignored? */
439 Elf32_Word p_filesz; /* number of bytes in file for seg. */
440 Elf32_Word p_memsz; /* number of bytes in mem. for seg. */
441 Elf32_Word p_flags; /* flags */
442 Elf32_Word p_align; /* memory alignment */
443} Elf32_Phdr;
444
445typedef struct {
446 Elf64_Half p_type; /* entry type */
447 Elf64_Half p_flags; /* flags */
448 Elf64_Off p_offset; /* offset */
449 Elf64_Addr p_vaddr; /* virtual address */
450 Elf64_Addr p_paddr; /* physical address */
451 Elf64_Xword p_filesz; /* file size */
452 Elf64_Xword p_memsz; /* memory size */
453 Elf64_Xword p_align; /* memory & file alignment */
454} Elf64_Phdr;
455
456/* Segment types - p_type */
457#define PT_NULL 0 /* unused */
458#define PT_LOAD 1 /* loadable segment */
459#define PT_DYNAMIC 2 /* dynamic linking section */
460#define PT_INTERP 3 /* the RTLD */
461#define PT_NOTE 4 /* auxiliary information */
462#define PT_SHLIB 5 /* reserved - purpose undefined */
463#define PT_PHDR 6 /* program header */
464#define PT_TLS 7 /* thread local storage */
465#define PT_LOOS 0x60000000 /* reserved range for OS */
466#define PT_HIOS 0x6fffffff /* specific segment types */
467#define PT_LOPROC 0x70000000 /* reserved range for processor */
468#define PT_HIPROC 0x7fffffff /* specific segment types */
469
470#define PT_GNU_EH_FRAME 0x6474e550 /* Exception handling info */
471#define PT_GNU_RELRO 0x6474e552 /* Read-only after relocation */
472
473#define PT_OPENBSD_RANDOMIZE 0x65a3dbe6 /* fill with random data */
474#define PT_OPENBSD_WXNEEDED 0x65a3dbe7 /* program performs W^X violations */
475#define PT_OPENBSD_BOOTDATA 0x65a41be6 /* section for boot arguments */
476
477/* Segment flags - p_flags */
478#define PF_X 0x1 /* Executable */
479#define PF_W 0x2 /* Writable */
480#define PF_R 0x4 /* Readable */
481#define PF_MASKPROC 0xf0000000 /* reserved bits for processor */
482 /* specific segment flags */
483
484/* Dynamic structure */
485typedef struct {
486 Elf32_Sword d_tag; /* controls meaning of d_val */
487 union {
488 Elf32_Word d_val; /* Multiple meanings - see d_tag */
489 Elf32_Addr d_ptr; /* program virtual address */
490 } d_un;
491} Elf32_Dyn;
492
493typedef struct {
494 Elf64_Xword d_tag; /* controls meaning of d_val */
495 union {
496 Elf64_Addr d_ptr;
497 Elf64_Xword d_val;
498 } d_un;
499} Elf64_Dyn;
500
501/* Dynamic Array Tags - d_tag */
502#define DT_NULL 0 /* marks end of _DYNAMIC array */
503#define DT_NEEDED 1 /* string table offset of needed lib */
504#define DT_PLTRELSZ 2 /* size of relocation entries in PLT */
505#define DT_PLTGOT 3 /* address PLT/GOT */
506#define DT_HASH 4 /* address of symbol hash table */
507#define DT_STRTAB 5 /* address of string table */
508#define DT_SYMTAB 6 /* address of symbol table */
509#define DT_RELA 7 /* address of relocation table */
510#define DT_RELASZ 8 /* size of relocation table */
511#define DT_RELAENT 9 /* size of relocation entry */
512#define DT_STRSZ 10 /* size of string table */
513#define DT_SYMENT 11 /* size of symbol table entry */
514#define DT_INIT 12 /* address of initialization func. */
515#define DT_FINI 13 /* address of termination function */
516#define DT_SONAME 14 /* string table offset of shared obj */
517#define DT_RPATH 15 /* string table offset of library \
518 search path */
519#define DT_SYMBOLIC 16 /* start sym search in shared obj. */
520#define DT_REL 17 /* address of rel. tbl. w addends */
521#define DT_RELSZ 18 /* size of DT_REL relocation table */
522#define DT_RELENT 19 /* size of DT_REL relocation entry */
523#define DT_PLTREL 20 /* PLT referenced relocation entry */
524#define DT_DEBUG 21 /* bugger */
525#define DT_TEXTREL 22 /* Allow rel. mod. to unwritable seg */
526#define DT_JMPREL 23 /* add. of PLT's relocation entries */
527#define DT_BIND_NOW 24 /* Bind now regardless of env setting */
528#define DT_INIT_ARRAY 25 /* address of array of init func */
529#define DT_FINI_ARRAY 26 /* address of array of term func */
530#define DT_INIT_ARRAYSZ 27 /* size of array of init func */
531#define DT_FINI_ARRAYSZ 28 /* size of array of term func */
532#define DT_RUNPATH 29 /* strtab offset of lib search path */
533#define DT_FLAGS 30 /* Set of DF_* flags */
534#define DT_ENCODING 31 /* further DT_* follow encoding rules */
535#define DT_PREINIT_ARRAY 32 /* address of array of preinit func */
536#define DT_PREINIT_ARRAYSZ 33 /* size of array of preinit func */
537#define DT_LOOS 0x6000000d /* reserved range for OS */
538#define DT_HIOS 0x6ffff000 /* specific dynamic array tags */
539#define DT_LOPROC 0x70000000 /* reserved range for processor */
540#define DT_HIPROC 0x7fffffff /* specific dynamic array tags */
541
542/* some other useful tags */
543#define DT_GNU_HASH 0x6ffffef5 /* address of GNU hash table */
544#define DT_RELACOUNT 0x6ffffff9 /* if present, number of RELATIVE */
545#define DT_RELCOUNT 0x6ffffffa /* relocs, which must come first */
546#define DT_FLAGS_1 0x6ffffffb
547
548/* Dynamic Flags - DT_FLAGS .dynamic entry */
549#define DF_ORIGIN 0x00000001
550#define DF_SYMBOLIC 0x00000002
551#define DF_TEXTREL 0x00000004
552#define DF_BIND_NOW 0x00000008
553#define DF_STATIC_TLS 0x00000010
554
555/* Dynamic Flags - DT_FLAGS_1 .dynamic entry */
556#define DF_1_NOW 0x00000001
557#define DF_1_GLOBAL 0x00000002
558#define DF_1_GROUP 0x00000004
559#define DF_1_NODELETE 0x00000008
560#define DF_1_LOADFLTR 0x00000010
561#define DF_1_INITFIRST 0x00000020
562#define DF_1_NOOPEN 0x00000040
563#define DF_1_ORIGIN 0x00000080
564#define DF_1_DIRECT 0x00000100
565#define DF_1_TRANS 0x00000200
566#define DF_1_INTERPOSE 0x00000400
567#define DF_1_NODEFLIB 0x00000800
568#define DF_1_NODUMP 0x00001000
569#define DF_1_CONLFAT 0x00002000
570
571/*
572 * Note header
573 */
574typedef struct {
575 Elf32_Word n_namesz;
576 Elf32_Word n_descsz;
577 Elf32_Word n_type;
578} Elf32_Nhdr;
579
580typedef struct {
581 Elf64_Half n_namesz;
582 Elf64_Half n_descsz;
583 Elf64_Half n_type;
584} Elf64_Nhdr;
585
586/*
587 * Note Definitions
588 */
589typedef struct {
590 Elf32_Word namesz;
591 Elf32_Word descsz;
592 Elf32_Word type;
593} Elf32_Note;
594
595typedef struct {
596 Elf64_Half namesz;
597 Elf64_Half descsz;
598 Elf64_Half type;
599} Elf64_Note;
600
601/* Values for n_type. */
602#define NT_PRSTATUS 1 /* Process status. */
603#define NT_FPREGSET 2 /* Floating point registers. */
604#define NT_PRPSINFO 3 /* Process state info. */
605
606/*
607 * OpenBSD-specific core file information.
608 *
609 * OpenBSD ELF core files use notes to provide information about
610 * the process's state. The note name is "OpenBSD" for information
611 * that is global to the process, and "OpenBSD@nn", where "nn" is the
612 * thread ID of the thread that the information belongs to (such as
613 * register state).
614 *
615 * We use the following note identifiers:
616 *
617 * NT_OPENBSD_PROCINFO
618 * Note is a "elfcore_procinfo" structure.
619 * NT_OPENBSD_AUXV
620 * Note is a a bunch of Auxilliary Vectors, terminated by
621 * an AT_NULL entry.
622 * NT_OPENBSD_REGS
623 * Note is a "reg" structure.
624 * NT_OPENBSD_FPREGS
625 * Note is a "fpreg" structure.
626 *
627 * Please try to keep the members of the "elfcore_procinfo" structure
628 * nicely aligned, and if you add elements, add them to the end and
629 * bump the version.
630 */
631
632#define NT_OPENBSD_PROCINFO 10
633#define NT_OPENBSD_AUXV 11
634
635#define NT_OPENBSD_REGS 20
636#define NT_OPENBSD_FPREGS 21
637#define NT_OPENBSD_XFPREGS 22
638#define NT_OPENBSD_WCOOKIE 23
639
640struct elfcore_procinfo {
641 /* Version 1 fields start here. */
642 uint32_t cpi_version; /* netbsd_elfcore_procinfo version */
643#define ELFCORE_PROCINFO_VERSION 1
644 uint32_t cpi_cpisize; /* sizeof(netbsd_elfcore_procinfo) */
645 uint32_t cpi_signo; /* killing signal */
646 uint32_t cpi_sigcode; /* signal code */
647 uint32_t cpi_sigpend; /* pending signals */
648 uint32_t cpi_sigmask; /* blocked signals */
649 uint32_t cpi_sigignore; /* ignored signals */
650 uint32_t cpi_sigcatch; /* signals being caught by user */
651 int32_t cpi_pid; /* process ID */
652 int32_t cpi_ppid; /* parent process ID */
653 int32_t cpi_pgrp; /* process group ID */
654 int32_t cpi_sid; /* session ID */
655 uint32_t cpi_ruid; /* real user ID */
656 uint32_t cpi_euid; /* effective user ID */
657 uint32_t cpi_svuid; /* saved user ID */
658 uint32_t cpi_rgid; /* real group ID */
659 uint32_t cpi_egid; /* effective group ID */
660 uint32_t cpi_svgid; /* saved group ID */
661 int8_t cpi_name[32]; /* copy of pr->ps_comm */
662};
663
664/*
665 * XXX - these _KERNEL items aren't part of the ABI!
666 */
667#if defined(_KERNEL) || defined(_DYN_LOADER)
668
669# define ELF32_NO_ADDR ((uint32_t)~0) /* Indicates addr. not yet filled in */
670
671typedef struct {
672 Elf32_Sword au_id; /* 32-bit id */
673 Elf32_Word au_v; /* 32-bit value */
674} Aux32Info;
675
676# define ELF64_NO_ADDR ((uint64_t)~0) /* Indicates addr. not yet filled in */
677
678typedef struct {
679 Elf64_Shalf au_id; /* 32-bit id */
680 Elf64_Xword au_v; /* 64-bit value */
681} Aux64Info;
682
683enum AuxID {
684 AUX_null = 0,
685 AUX_ignore = 1,
686 AUX_execfd = 2,
687 AUX_phdr = 3, /* &phdr[0] */
688 AUX_phent = 4, /* sizeof(phdr[0]) */
689 AUX_phnum = 5, /* # phdr entries */
690 AUX_pagesz = 6, /* PAGESIZE */
691 AUX_base = 7, /* ld.so base addr */
692 AUX_flags = 8, /* processor flags */
693 AUX_entry = 9, /* a.out entry */
694 AUX_sun_uid = 2000, /* euid */
695 AUX_sun_ruid = 2001, /* ruid */
696 AUX_sun_gid = 2002, /* egid */
697 AUX_sun_rgid = 2003 /* rgid */
698};
699
700struct elf_args {
701 u_long arg_entry; /* program entry point */
702 u_long arg_interp; /* Interpreter load address */
703 u_long arg_phaddr; /* program header address */
704 u_long arg_phentsize; /* Gfx::Size of program header */
705 u_long arg_phnum; /* Number of program headers */
706};
707
708#endif
709
710#if !defined(ELFSIZE) && defined(ARCH_ELFSIZE)
711# define ELFSIZE ARCH_ELFSIZE
712#endif
713
714#if defined(ELFSIZE)
715# define CONCAT(x, y) __CONCAT(x, y)
716# define ELFNAME(x) CONCAT(elf, CONCAT(ELFSIZE, CONCAT(_, x)))
717# define ELFDEFNNAME(x) CONCAT(ELF, CONCAT(ELFSIZE, CONCAT(_, x)))
718#endif
719
720#if defined(ELFSIZE) && (ELFSIZE == 32)
721# define Elf_Ehdr Elf32_Ehdr
722# define Elf_Phdr Elf32_Phdr
723# define Elf_Shdr Elf32_Shdr
724# define Elf_Sym Elf32_Sym
725# define Elf_Rel Elf32_Rel
726# define Elf_RelA Elf32_Rela
727# define Elf_Dyn Elf32_Dyn
728# define Elf_Half Elf32_Half
729# define Elf_Word Elf32_Word
730# define Elf_Sword Elf32_Sword
731# define Elf_Addr Elf32_Addr
732# define Elf_Off Elf32_Off
733# define Elf_Nhdr Elf32_Nhdr
734# define Elf_Note Elf32_Note
735
736# define ELF_R_SYM ELF32_R_SYM
737# define ELF_R_TYPE ELF32_R_TYPE
738# define ELF_R_INFO ELF32_R_INFO
739# define ELFCLASS ELFCLASS32
740
741# define ELF_ST_BIND ELF32_ST_BIND
742# define ELF_ST_TYPE ELF32_ST_TYPE
743# define ELF_ST_INFO ELF32_ST_INFO
744
745# define ELF_NO_ADDR ELF32_NO_ADDR
746# define AuxInfo Aux32Info
747#elif defined(ELFSIZE) && (ELFSIZE == 64)
748# define Elf_Ehdr Elf64_Ehdr
749# define Elf_Phdr Elf64_Phdr
750# define Elf_Shdr Elf64_Shdr
751# define Elf_Sym Elf64_Sym
752# define Elf_Rel Elf64_Rel
753# define Elf_RelA Elf64_Rela
754# define Elf_Dyn Elf64_Dyn
755# define Elf_Half Elf64_Half
756# define Elf_Word Elf64_Word
757# define Elf_Sword Elf64_Sword
758# define Elf_Addr Elf64_Addr
759# define Elf_Off Elf64_Off
760# define Elf_Nhdr Elf64_Nhdr
761# define Elf_Note Elf64_Note
762
763# define ELF_R_SYM ELF64_R_SYM
764# define ELF_R_TYPE ELF64_R_TYPE
765# define ELF_R_INFO ELF64_R_INFO
766# define ELFCLASS ELFCLASS64
767
768# define ELF_ST_BIND ELF64_ST_BIND
769# define ELF_ST_TYPE ELF64_ST_TYPE
770# define ELF_ST_INFO ELF64_ST_INFO
771
772# define ELF_NO_ADDR ELF64_NO_ADDR
773# define AuxInfo Aux64Info
774#endif
775
776#define ELF_TARG_VER 1 /* The ver for which this code is intended */
777
778/* Relocation types */
779#define R_386_NONE 0
780#define R_386_32 1 /* Symbol + Addend */
781#define R_386_PC32 2 /* Symbol + Addend - Section offset */
782#define R_386_GOT32 3 /* Used by build-time linker to create GOT entry */
783#define R_386_PLT32 4 /* Used by build-time linker to create PLT entry */
784#define R_386_COPY 5 /* https://docs.oracle.com/cd/E23824_01/html/819-0690/chapter4-10454.html#chapter4-84604 */
785#define R_386_GLOB_DAT 6 /* Relation b/w GOT entry and symbol */
786#define R_386_JMP_SLOT 7 /* Fixed up by dynamic loader */
787#define R_386_RELATIVE 8 /* Base address + Addned */
788#define R_386_TLS_TPOFF 14 /* Negative offset into the static TLS storage */
789
790
791#endif /* _SYS_EXEC_ELF_H_ */