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_ARM_FPMR 0x40e /* ARM floating point mode register */ 444#define NT_ARC_V2 0x600 /* ARCv2 accumulator/extra registers */ 445#define NT_VMCOREDD 0x700 /* Vmcore Device Dump Note */ 446#define NT_MIPS_DSP 0x800 /* MIPS DSP ASE registers */ 447#define NT_MIPS_FP_MODE 0x801 /* MIPS floating-point mode */ 448#define NT_MIPS_MSA 0x802 /* MIPS SIMD registers */ 449#define NT_RISCV_CSR 0x900 /* RISC-V Control and Status Registers */ 450#define NT_RISCV_VECTOR 0x901 /* RISC-V vector registers */ 451#define NT_LOONGARCH_CPUCFG 0xa00 /* LoongArch CPU config registers */ 452#define NT_LOONGARCH_CSR 0xa01 /* LoongArch control and status registers */ 453#define NT_LOONGARCH_LSX 0xa02 /* LoongArch Loongson SIMD Extension registers */ 454#define NT_LOONGARCH_LASX 0xa03 /* LoongArch Loongson Advanced SIMD Extension registers */ 455#define NT_LOONGARCH_LBT 0xa04 /* LoongArch Loongson Binary Translation registers */ 456#define NT_LOONGARCH_HW_BREAK 0xa05 /* LoongArch hardware breakpoint registers */ 457#define NT_LOONGARCH_HW_WATCH 0xa06 /* LoongArch hardware watchpoint registers */ 458 459/* Note types with note name "GNU" */ 460#define NT_GNU_PROPERTY_TYPE_0 5 461 462/* Note header in a PT_NOTE section */ 463typedef struct elf32_note { 464 Elf32_Word n_namesz; /* Name size */ 465 Elf32_Word n_descsz; /* Content size */ 466 Elf32_Word n_type; /* Content type */ 467} Elf32_Nhdr; 468 469/* Note header in a PT_NOTE section */ 470typedef struct elf64_note { 471 Elf64_Word n_namesz; /* Name size */ 472 Elf64_Word n_descsz; /* Content size */ 473 Elf64_Word n_type; /* Content type */ 474} Elf64_Nhdr; 475 476/* .note.gnu.property types for EM_AARCH64: */ 477#define GNU_PROPERTY_AARCH64_FEATURE_1_AND 0xc0000000 478 479/* Bits for GNU_PROPERTY_AARCH64_FEATURE_1_BTI */ 480#define GNU_PROPERTY_AARCH64_FEATURE_1_BTI (1U << 0) 481 482#endif /* _UAPI_LINUX_ELF_H */ 483