1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2#ifndef _UAPI_LINUX_ELF_H
3#define _UAPI_LINUX_ELF_H
4
5#include <linux/types.h>
6#include <linux/elf-em.h>
7
8/* 32-bit ELF base types. */
9typedef __u32 Elf32_Addr;
10typedef __u16 Elf32_Half;
11typedef __u32 Elf32_Off;
12typedef __s32 Elf32_Sword;
13typedef __u32 Elf32_Word;
14
15/* 64-bit ELF base types. */
16typedef __u64 Elf64_Addr;
17typedef __u16 Elf64_Half;
18typedef __s16 Elf64_SHalf;
19typedef __u64 Elf64_Off;
20typedef __s32 Elf64_Sword;
21typedef __u32 Elf64_Word;
22typedef __u64 Elf64_Xword;
23typedef __s64 Elf64_Sxword;
24
25/* These constants are for the segment types stored in the image headers */
26#define PT_NULL 0
27#define PT_LOAD 1
28#define PT_DYNAMIC 2
29#define PT_INTERP 3
30#define PT_NOTE 4
31#define PT_SHLIB 5
32#define PT_PHDR 6
33#define PT_TLS 7 /* Thread local storage segment */
34#define PT_LOOS 0x60000000 /* OS-specific */
35#define PT_HIOS 0x6fffffff /* OS-specific */
36#define PT_LOPROC 0x70000000
37#define PT_HIPROC 0x7fffffff
38#define PT_GNU_EH_FRAME (PT_LOOS + 0x474e550)
39#define PT_GNU_STACK (PT_LOOS + 0x474e551)
40#define PT_GNU_RELRO (PT_LOOS + 0x474e552)
41#define PT_GNU_PROPERTY (PT_LOOS + 0x474e553)
42
43
44/* ARM MTE memory tag segment type */
45#define PT_AARCH64_MEMTAG_MTE (PT_LOPROC + 0x2)
46
47/*
48 * Extended Numbering
49 *
50 * If the real number of program header table entries is larger than
51 * or equal to PN_XNUM(0xffff), it is set to sh_info field of the
52 * section header at index 0, and PN_XNUM is set to e_phnum
53 * field. Otherwise, the section header at index 0 is zero
54 * initialized, if it exists.
55 *
56 * Specifications are available in:
57 *
58 * - Oracle: Linker and Libraries.
59 * Part No: 817–1984–19, August 2011.
60 * https://docs.oracle.com/cd/E18752_01/pdf/817-1984.pdf
61 *
62 * - System V ABI AMD64 Architecture Processor Supplement
63 * Draft Version 0.99.4,
64 * January 13, 2010.
65 * http://www.cs.washington.edu/education/courses/cse351/12wi/supp-docs/abi.pdf
66 */
67#define PN_XNUM 0xffff
68
69/* These constants define the different elf file types */
70#define ET_NONE 0
71#define ET_REL 1
72#define ET_EXEC 2
73#define ET_DYN 3
74#define ET_CORE 4
75#define ET_LOPROC 0xff00
76#define ET_HIPROC 0xffff
77
78/* This is the info that is needed to parse the dynamic section of the file */
79#define DT_NULL 0
80#define DT_NEEDED 1
81#define DT_PLTRELSZ 2
82#define DT_PLTGOT 3
83#define DT_HASH 4
84#define DT_STRTAB 5
85#define DT_SYMTAB 6
86#define DT_RELA 7
87#define DT_RELASZ 8
88#define DT_RELAENT 9
89#define DT_STRSZ 10
90#define DT_SYMENT 11
91#define DT_INIT 12
92#define DT_FINI 13
93#define DT_SONAME 14
94#define DT_RPATH 15
95#define DT_SYMBOLIC 16
96#define DT_REL 17
97#define DT_RELSZ 18
98#define DT_RELENT 19
99#define DT_PLTREL 20
100#define DT_DEBUG 21
101#define DT_TEXTREL 22
102#define DT_JMPREL 23
103#define DT_ENCODING 32
104#define OLD_DT_LOOS 0x60000000
105#define DT_LOOS 0x6000000d
106#define DT_HIOS 0x6ffff000
107#define DT_VALRNGLO 0x6ffffd00
108#define DT_VALRNGHI 0x6ffffdff
109#define DT_ADDRRNGLO 0x6ffffe00
110#define DT_ADDRRNGHI 0x6ffffeff
111#define DT_VERSYM 0x6ffffff0
112#define DT_RELACOUNT 0x6ffffff9
113#define DT_RELCOUNT 0x6ffffffa
114#define DT_FLAGS_1 0x6ffffffb
115#define DT_VERDEF 0x6ffffffc
116#define DT_VERDEFNUM 0x6ffffffd
117#define DT_VERNEED 0x6ffffffe
118#define DT_VERNEEDNUM 0x6fffffff
119#define OLD_DT_HIOS 0x6fffffff
120#define DT_LOPROC 0x70000000
121#define DT_HIPROC 0x7fffffff
122
123/* This info is needed when parsing the symbol table */
124#define STB_LOCAL 0
125#define STB_GLOBAL 1
126#define STB_WEAK 2
127
128#define STT_NOTYPE 0
129#define STT_OBJECT 1
130#define STT_FUNC 2
131#define STT_SECTION 3
132#define STT_FILE 4
133#define STT_COMMON 5
134#define STT_TLS 6
135
136#define ELF_ST_BIND(x) ((x) >> 4)
137#define ELF_ST_TYPE(x) ((x) & 0xf)
138#define ELF32_ST_BIND(x) ELF_ST_BIND(x)
139#define ELF32_ST_TYPE(x) ELF_ST_TYPE(x)
140#define ELF64_ST_BIND(x) ELF_ST_BIND(x)
141#define ELF64_ST_TYPE(x) ELF_ST_TYPE(x)
142
143typedef struct {
144 Elf32_Sword d_tag;
145 union {
146 Elf32_Sword d_val;
147 Elf32_Addr d_ptr;
148 } d_un;
149} Elf32_Dyn;
150
151typedef struct {
152 Elf64_Sxword d_tag; /* entry tag value */
153 union {
154 Elf64_Xword d_val;
155 Elf64_Addr d_ptr;
156 } d_un;
157} Elf64_Dyn;
158
159/* The following are used with relocations */
160#define ELF32_R_SYM(x) ((x) >> 8)
161#define ELF32_R_TYPE(x) ((x) & 0xff)
162
163#define ELF64_R_SYM(i) ((i) >> 32)
164#define ELF64_R_TYPE(i) ((i) & 0xffffffff)
165
166typedef struct elf32_rel {
167 Elf32_Addr r_offset;
168 Elf32_Word r_info;
169} Elf32_Rel;
170
171typedef struct elf64_rel {
172 Elf64_Addr r_offset; /* Location at which to apply the action */
173 Elf64_Xword r_info; /* index and type of relocation */
174} Elf64_Rel;
175
176typedef struct elf32_rela {
177 Elf32_Addr r_offset;
178 Elf32_Word r_info;
179 Elf32_Sword r_addend;
180} Elf32_Rela;
181
182typedef struct elf64_rela {
183 Elf64_Addr r_offset; /* Location at which to apply the action */
184 Elf64_Xword r_info; /* index and type of relocation */
185 Elf64_Sxword r_addend; /* Constant addend used to compute value */
186} Elf64_Rela;
187
188typedef struct elf32_sym {
189 Elf32_Word st_name;
190 Elf32_Addr st_value;
191 Elf32_Word st_size;
192 unsigned char st_info;
193 unsigned char st_other;
194 Elf32_Half st_shndx;
195} Elf32_Sym;
196
197typedef struct elf64_sym {
198 Elf64_Word st_name; /* Symbol name, index in string tbl */
199 unsigned char st_info; /* Type and binding attributes */
200 unsigned char st_other; /* No defined meaning, 0 */
201 Elf64_Half st_shndx; /* Associated section index */
202 Elf64_Addr st_value; /* Value of the symbol */
203 Elf64_Xword st_size; /* Associated symbol size */
204} Elf64_Sym;
205
206
207#define EI_NIDENT 16
208
209typedef struct elf32_hdr {
210 unsigned char e_ident[EI_NIDENT];
211 Elf32_Half e_type;
212 Elf32_Half e_machine;
213 Elf32_Word e_version;
214 Elf32_Addr e_entry; /* Entry point */
215 Elf32_Off e_phoff;
216 Elf32_Off e_shoff;
217 Elf32_Word e_flags;
218 Elf32_Half e_ehsize;
219 Elf32_Half e_phentsize;
220 Elf32_Half e_phnum;
221 Elf32_Half e_shentsize;
222 Elf32_Half e_shnum;
223 Elf32_Half e_shstrndx;
224} Elf32_Ehdr;
225
226typedef struct elf64_hdr {
227 unsigned char e_ident[EI_NIDENT]; /* ELF "magic number" */
228 Elf64_Half e_type;
229 Elf64_Half e_machine;
230 Elf64_Word e_version;
231 Elf64_Addr e_entry; /* Entry point virtual address */
232 Elf64_Off e_phoff; /* Program header table file offset */
233 Elf64_Off e_shoff; /* Section header table file offset */
234 Elf64_Word e_flags;
235 Elf64_Half e_ehsize;
236 Elf64_Half e_phentsize;
237 Elf64_Half e_phnum;
238 Elf64_Half e_shentsize;
239 Elf64_Half e_shnum;
240 Elf64_Half e_shstrndx;
241} Elf64_Ehdr;
242
243/* These constants define the permissions on sections in the program
244 header, p_flags. */
245#define PF_R 0x4
246#define PF_W 0x2
247#define PF_X 0x1
248
249typedef struct elf32_phdr {
250 Elf32_Word p_type;
251 Elf32_Off p_offset;
252 Elf32_Addr p_vaddr;
253 Elf32_Addr p_paddr;
254 Elf32_Word p_filesz;
255 Elf32_Word p_memsz;
256 Elf32_Word p_flags;
257 Elf32_Word p_align;
258} Elf32_Phdr;
259
260typedef struct elf64_phdr {
261 Elf64_Word p_type;
262 Elf64_Word p_flags;
263 Elf64_Off p_offset; /* Segment file offset */
264 Elf64_Addr p_vaddr; /* Segment virtual address */
265 Elf64_Addr p_paddr; /* Segment physical address */
266 Elf64_Xword p_filesz; /* Segment size in file */
267 Elf64_Xword p_memsz; /* Segment size in memory */
268 Elf64_Xword p_align; /* Segment alignment, file & memory */
269} Elf64_Phdr;
270
271/* sh_type */
272#define SHT_NULL 0
273#define SHT_PROGBITS 1
274#define SHT_SYMTAB 2
275#define SHT_STRTAB 3
276#define SHT_RELA 4
277#define SHT_HASH 5
278#define SHT_DYNAMIC 6
279#define SHT_NOTE 7
280#define SHT_NOBITS 8
281#define SHT_REL 9
282#define SHT_SHLIB 10
283#define SHT_DYNSYM 11
284#define SHT_NUM 12
285#define SHT_LOPROC 0x70000000
286#define SHT_HIPROC 0x7fffffff
287#define SHT_LOUSER 0x80000000
288#define SHT_HIUSER 0xffffffff
289
290/* sh_flags */
291#define SHF_WRITE 0x1
292#define SHF_ALLOC 0x2
293#define SHF_EXECINSTR 0x4
294#define SHF_RELA_LIVEPATCH 0x00100000
295#define SHF_RO_AFTER_INIT 0x00200000
296#define SHF_MASKPROC 0xf0000000
297
298/* special section indexes */
299#define SHN_UNDEF 0
300#define SHN_LORESERVE 0xff00
301#define SHN_LOPROC 0xff00
302#define SHN_HIPROC 0xff1f
303#define SHN_LIVEPATCH 0xff20
304#define SHN_ABS 0xfff1
305#define SHN_COMMON 0xfff2
306#define SHN_HIRESERVE 0xffff
307
308typedef struct elf32_shdr {
309 Elf32_Word sh_name;
310 Elf32_Word sh_type;
311 Elf32_Word sh_flags;
312 Elf32_Addr sh_addr;
313 Elf32_Off sh_offset;
314 Elf32_Word sh_size;
315 Elf32_Word sh_link;
316 Elf32_Word sh_info;
317 Elf32_Word sh_addralign;
318 Elf32_Word sh_entsize;
319} Elf32_Shdr;
320
321typedef struct elf64_shdr {
322 Elf64_Word sh_name; /* Section name, index in string tbl */
323 Elf64_Word sh_type; /* Type of section */
324 Elf64_Xword sh_flags; /* Miscellaneous section attributes */
325 Elf64_Addr sh_addr; /* Section virtual addr at execution */
326 Elf64_Off sh_offset; /* Section file offset */
327 Elf64_Xword sh_size; /* Size of section in bytes */
328 Elf64_Word sh_link; /* Index of another section */
329 Elf64_Word sh_info; /* Additional section information */
330 Elf64_Xword sh_addralign; /* Section alignment */
331 Elf64_Xword sh_entsize; /* Entry size if section holds table */
332} Elf64_Shdr;
333
334#define EI_MAG0 0 /* e_ident[] indexes */
335#define EI_MAG1 1
336#define EI_MAG2 2
337#define EI_MAG3 3
338#define EI_CLASS 4
339#define EI_DATA 5
340#define EI_VERSION 6
341#define EI_OSABI 7
342#define EI_PAD 8
343
344#define ELFMAG0 0x7f /* EI_MAG */
345#define ELFMAG1 'E'
346#define ELFMAG2 'L'
347#define ELFMAG3 'F'
348#define ELFMAG "\177ELF"
349#define SELFMAG 4
350
351#define ELFCLASSNONE 0 /* EI_CLASS */
352#define ELFCLASS32 1
353#define ELFCLASS64 2
354#define ELFCLASSNUM 3
355
356#define ELFDATANONE 0 /* e_ident[EI_DATA] */
357#define ELFDATA2LSB 1
358#define ELFDATA2MSB 2
359
360#define EV_NONE 0 /* e_version, EI_VERSION */
361#define EV_CURRENT 1
362#define EV_NUM 2
363
364#define ELFOSABI_NONE 0
365#define ELFOSABI_LINUX 3
366
367#ifndef ELF_OSABI
368#define ELF_OSABI ELFOSABI_NONE
369#endif
370
371/*
372 * Notes used in ET_CORE. Architectures export some of the arch register sets
373 * using the corresponding note types via the PTRACE_GETREGSET and
374 * PTRACE_SETREGSET requests.
375 * The note name for these types is "LINUX", except NT_PRFPREG that is named
376 * "CORE".
377 */
378#define NT_PRSTATUS 1
379#define NT_PRFPREG 2
380#define NT_PRPSINFO 3
381#define NT_TASKSTRUCT 4
382#define NT_AUXV 6
383/*
384 * Note to userspace developers: size of NT_SIGINFO note may increase
385 * in the future to accomodate more fields, don't assume it is fixed!
386 */
387#define NT_SIGINFO 0x53494749
388#define NT_FILE 0x46494c45
389#define NT_PRXFPREG 0x46e62b7f /* copied from gdb5.1/include/elf/common.h */
390#define NT_PPC_VMX 0x100 /* PowerPC Altivec/VMX registers */
391#define NT_PPC_SPE 0x101 /* PowerPC SPE/EVR registers */
392#define NT_PPC_VSX 0x102 /* PowerPC VSX registers */
393#define NT_PPC_TAR 0x103 /* Target Address Register */
394#define NT_PPC_PPR 0x104 /* Program Priority Register */
395#define NT_PPC_DSCR 0x105 /* Data Stream Control Register */
396#define NT_PPC_EBB 0x106 /* Event Based Branch Registers */
397#define NT_PPC_PMU 0x107 /* Performance Monitor Registers */
398#define NT_PPC_TM_CGPR 0x108 /* TM checkpointed GPR Registers */
399#define NT_PPC_TM_CFPR 0x109 /* TM checkpointed FPR Registers */
400#define NT_PPC_TM_CVMX 0x10a /* TM checkpointed VMX Registers */
401#define NT_PPC_TM_CVSX 0x10b /* TM checkpointed VSX Registers */
402#define NT_PPC_TM_SPR 0x10c /* TM Special Purpose Registers */
403#define NT_PPC_TM_CTAR 0x10d /* TM checkpointed Target Address Register */
404#define NT_PPC_TM_CPPR 0x10e /* TM checkpointed Program Priority Register */
405#define NT_PPC_TM_CDSCR 0x10f /* TM checkpointed Data Stream Control Register */
406#define NT_PPC_PKEY 0x110 /* Memory Protection Keys registers */
407#define NT_PPC_DEXCR 0x111 /* PowerPC DEXCR registers */
408#define NT_PPC_HASHKEYR 0x112 /* PowerPC HASHKEYR register */
409#define NT_386_TLS 0x200 /* i386 TLS slots (struct user_desc) */
410#define NT_386_IOPERM 0x201 /* x86 io permission bitmap (1=deny) */
411#define NT_X86_XSTATE 0x202 /* x86 extended state using xsave */
412/* Old binutils treats 0x203 as a CET state */
413#define NT_X86_SHSTK 0x204 /* x86 SHSTK state */
414#define NT_S390_HIGH_GPRS 0x300 /* s390 upper register halves */
415#define NT_S390_TIMER 0x301 /* s390 timer register */
416#define NT_S390_TODCMP 0x302 /* s390 TOD clock comparator register */
417#define NT_S390_TODPREG 0x303 /* s390 TOD programmable register */
418#define NT_S390_CTRS 0x304 /* s390 control registers */
419#define NT_S390_PREFIX 0x305 /* s390 prefix register */
420#define NT_S390_LAST_BREAK 0x306 /* s390 breaking event address */
421#define NT_S390_SYSTEM_CALL 0x307 /* s390 system call restart data */
422#define NT_S390_TDB 0x308 /* s390 transaction diagnostic block */
423#define NT_S390_VXRS_LOW 0x309 /* s390 vector registers 0-15 upper half */
424#define NT_S390_VXRS_HIGH 0x30a /* s390 vector registers 16-31 */
425#define NT_S390_GS_CB 0x30b /* s390 guarded storage registers */
426#define NT_S390_GS_BC 0x30c /* s390 guarded storage broadcast control block */
427#define NT_S390_RI_CB 0x30d /* s390 runtime instrumentation */
428#define NT_S390_PV_CPU_DATA 0x30e /* s390 protvirt cpu dump data */
429#define NT_ARM_VFP 0x400 /* ARM VFP/NEON registers */
430#define NT_ARM_TLS 0x401 /* ARM TLS register */
431#define NT_ARM_HW_BREAK 0x402 /* ARM hardware breakpoint registers */
432#define NT_ARM_HW_WATCH 0x403 /* ARM hardware watchpoint registers */
433#define NT_ARM_SYSTEM_CALL 0x404 /* ARM system call number */
434#define NT_ARM_SVE 0x405 /* ARM Scalable Vector Extension registers */
435#define NT_ARM_PAC_MASK 0x406 /* ARM pointer authentication code masks */
436#define NT_ARM_PACA_KEYS 0x407 /* ARM pointer authentication address keys */
437#define NT_ARM_PACG_KEYS 0x408 /* ARM pointer authentication generic key */
438#define NT_ARM_TAGGED_ADDR_CTRL 0x409 /* arm64 tagged address control (prctl()) */
439#define NT_ARM_PAC_ENABLED_KEYS 0x40a /* arm64 ptr auth enabled keys (prctl()) */
440#define NT_ARM_SSVE 0x40b /* ARM Streaming SVE registers */
441#define NT_ARM_ZA 0x40c /* ARM SME ZA registers */
442#define NT_ARM_ZT 0x40d /* ARM SME ZT registers */
443#define NT_ARC_V2 0x600 /* ARCv2 accumulator/extra registers */
444#define NT_VMCOREDD 0x700 /* Vmcore Device Dump Note */
445#define NT_MIPS_DSP 0x800 /* MIPS DSP ASE registers */
446#define NT_MIPS_FP_MODE 0x801 /* MIPS floating-point mode */
447#define NT_MIPS_MSA 0x802 /* MIPS SIMD registers */
448#define NT_RISCV_CSR 0x900 /* RISC-V Control and Status Registers */
449#define NT_RISCV_VECTOR 0x901 /* RISC-V vector registers */
450#define NT_LOONGARCH_CPUCFG 0xa00 /* LoongArch CPU config registers */
451#define NT_LOONGARCH_CSR 0xa01 /* LoongArch control and status registers */
452#define NT_LOONGARCH_LSX 0xa02 /* LoongArch Loongson SIMD Extension registers */
453#define NT_LOONGARCH_LASX 0xa03 /* LoongArch Loongson Advanced SIMD Extension registers */
454#define NT_LOONGARCH_LBT 0xa04 /* LoongArch Loongson Binary Translation registers */
455#define NT_LOONGARCH_HW_BREAK 0xa05 /* LoongArch hardware breakpoint registers */
456#define NT_LOONGARCH_HW_WATCH 0xa06 /* LoongArch hardware watchpoint registers */
457
458/* Note types with note name "GNU" */
459#define NT_GNU_PROPERTY_TYPE_0 5
460
461/* Note header in a PT_NOTE section */
462typedef struct elf32_note {
463 Elf32_Word n_namesz; /* Name size */
464 Elf32_Word n_descsz; /* Content size */
465 Elf32_Word n_type; /* Content type */
466} Elf32_Nhdr;
467
468/* Note header in a PT_NOTE section */
469typedef struct elf64_note {
470 Elf64_Word n_namesz; /* Name size */
471 Elf64_Word n_descsz; /* Content size */
472 Elf64_Word n_type; /* Content type */
473} Elf64_Nhdr;
474
475/* .note.gnu.property types for EM_AARCH64: */
476#define GNU_PROPERTY_AARCH64_FEATURE_1_AND 0xc0000000
477
478/* Bits for GNU_PROPERTY_AARCH64_FEATURE_1_BTI */
479#define GNU_PROPERTY_AARCH64_FEATURE_1_BTI (1U << 0)
480
481#endif /* _UAPI_LINUX_ELF_H */
482

source code of linux/include/uapi/linux/elf.h