elf.h (15808B) - Raw
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2 #ifndef _LINUX_ELF_H 3 #define _LINUX_ELF_H 4 5 #include <linux/types.h> 6 #include <linux/elf-em.h> 7 8 /* 32-bit ELF base types. */ 9 typedef __u32 Elf32_Addr; 10 typedef __u16 Elf32_Half; 11 typedef __u32 Elf32_Off; 12 typedef __s32 Elf32_Sword; 13 typedef __u32 Elf32_Word; 14 15 /* 64-bit ELF base types. */ 16 typedef __u64 Elf64_Addr; 17 typedef __u16 Elf64_Half; 18 typedef __s16 Elf64_SHalf; 19 typedef __u64 Elf64_Off; 20 typedef __s32 Elf64_Sword; 21 typedef __u32 Elf64_Word; 22 typedef __u64 Elf64_Xword; 23 typedef __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 143 typedef 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 151 typedef 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 166 typedef struct elf32_rel { 167 Elf32_Addr r_offset; 168 Elf32_Word r_info; 169 } Elf32_Rel; 170 171 typedef 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 176 typedef struct elf32_rela { 177 Elf32_Addr r_offset; 178 Elf32_Word r_info; 179 Elf32_Sword r_addend; 180 } Elf32_Rela; 181 182 typedef 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 188 typedef 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 197 typedef 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 209 typedef 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 226 typedef 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 249 typedef 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 260 typedef 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 308 typedef 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 321 typedef 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_X86_XSAVE_LAYOUT 0x205 /* XSAVE layout description */ 415 #define NT_S390_HIGH_GPRS 0x300 /* s390 upper register halves */ 416 #define NT_S390_TIMER 0x301 /* s390 timer register */ 417 #define NT_S390_TODCMP 0x302 /* s390 TOD clock comparator register */ 418 #define NT_S390_TODPREG 0x303 /* s390 TOD programmable register */ 419 #define NT_S390_CTRS 0x304 /* s390 control registers */ 420 #define NT_S390_PREFIX 0x305 /* s390 prefix register */ 421 #define NT_S390_LAST_BREAK 0x306 /* s390 breaking event address */ 422 #define NT_S390_SYSTEM_CALL 0x307 /* s390 system call restart data */ 423 #define NT_S390_TDB 0x308 /* s390 transaction diagnostic block */ 424 #define NT_S390_VXRS_LOW 0x309 /* s390 vector registers 0-15 upper half */ 425 #define NT_S390_VXRS_HIGH 0x30a /* s390 vector registers 16-31 */ 426 #define NT_S390_GS_CB 0x30b /* s390 guarded storage registers */ 427 #define NT_S390_GS_BC 0x30c /* s390 guarded storage broadcast control block */ 428 #define NT_S390_RI_CB 0x30d /* s390 runtime instrumentation */ 429 #define NT_S390_PV_CPU_DATA 0x30e /* s390 protvirt cpu dump data */ 430 #define NT_ARM_VFP 0x400 /* ARM VFP/NEON registers */ 431 #define NT_ARM_TLS 0x401 /* ARM TLS register */ 432 #define NT_ARM_HW_BREAK 0x402 /* ARM hardware breakpoint registers */ 433 #define NT_ARM_HW_WATCH 0x403 /* ARM hardware watchpoint registers */ 434 #define NT_ARM_SYSTEM_CALL 0x404 /* ARM system call number */ 435 #define NT_ARM_SVE 0x405 /* ARM Scalable Vector Extension registers */ 436 #define NT_ARM_PAC_MASK 0x406 /* ARM pointer authentication code masks */ 437 #define NT_ARM_PACA_KEYS 0x407 /* ARM pointer authentication address keys */ 438 #define NT_ARM_PACG_KEYS 0x408 /* ARM pointer authentication generic key */ 439 #define NT_ARM_TAGGED_ADDR_CTRL 0x409 /* arm64 tagged address control (prctl()) */ 440 #define NT_ARM_PAC_ENABLED_KEYS 0x40a /* arm64 ptr auth enabled keys (prctl()) */ 441 #define NT_ARM_SSVE 0x40b /* ARM Streaming SVE registers */ 442 #define NT_ARM_ZA 0x40c /* ARM SME ZA registers */ 443 #define NT_ARM_ZT 0x40d /* ARM SME ZT registers */ 444 #define NT_ARM_FPMR 0x40e /* ARM floating point mode register */ 445 #define NT_ARM_POE 0x40f /* ARM POE registers */ 446 #define NT_ARM_GCS 0x410 /* ARM GCS state */ 447 #define NT_ARC_V2 0x600 /* ARCv2 accumulator/extra registers */ 448 #define NT_VMCOREDD 0x700 /* Vmcore Device Dump Note */ 449 #define NT_MIPS_DSP 0x800 /* MIPS DSP ASE registers */ 450 #define NT_MIPS_FP_MODE 0x801 /* MIPS floating-point mode */ 451 #define NT_MIPS_MSA 0x802 /* MIPS SIMD registers */ 452 #define NT_RISCV_CSR 0x900 /* RISC-V Control and Status Registers */ 453 #define NT_RISCV_VECTOR 0x901 /* RISC-V vector registers */ 454 #define NT_RISCV_TAGGED_ADDR_CTRL 0x902 /* RISC-V tagged address control (prctl()) */ 455 #define NT_LOONGARCH_CPUCFG 0xa00 /* LoongArch CPU config registers */ 456 #define NT_LOONGARCH_CSR 0xa01 /* LoongArch control and status registers */ 457 #define NT_LOONGARCH_LSX 0xa02 /* LoongArch Loongson SIMD Extension registers */ 458 #define NT_LOONGARCH_LASX 0xa03 /* LoongArch Loongson Advanced SIMD Extension registers */ 459 #define NT_LOONGARCH_LBT 0xa04 /* LoongArch Loongson Binary Translation registers */ 460 #define NT_LOONGARCH_HW_BREAK 0xa05 /* LoongArch hardware breakpoint registers */ 461 #define NT_LOONGARCH_HW_WATCH 0xa06 /* LoongArch hardware watchpoint registers */ 462 463 /* Note types with note name "GNU" */ 464 #define NT_GNU_PROPERTY_TYPE_0 5 465 466 /* Note header in a PT_NOTE section */ 467 typedef struct elf32_note { 468 Elf32_Word n_namesz; /* Name size */ 469 Elf32_Word n_descsz; /* Content size */ 470 Elf32_Word n_type; /* Content type */ 471 } Elf32_Nhdr; 472 473 /* Note header in a PT_NOTE section */ 474 typedef struct elf64_note { 475 Elf64_Word n_namesz; /* Name size */ 476 Elf64_Word n_descsz; /* Content size */ 477 Elf64_Word n_type; /* Content type */ 478 } Elf64_Nhdr; 479 480 /* .note.gnu.property types for EM_AARCH64: */ 481 #define GNU_PROPERTY_AARCH64_FEATURE_1_AND 0xc0000000 482 483 /* Bits for GNU_PROPERTY_AARCH64_FEATURE_1_BTI */ 484 #define GNU_PROPERTY_AARCH64_FEATURE_1_BTI (1U << 0) 485 486 #endif /* _LINUX_ELF_H */