elf.h 15 KB

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