1 //===- llvm/BinaryFormat/ELF.h - ELF constants and structures ---*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This header contains common, non-processor-specific data structures and
10 // constants for the ELF file format.
11 //
12 // The details of the ELF32 bits in this file are largely based on the Tool
13 // Interface Standard (TIS) Executable and Linking Format (ELF) Specification
14 // Version 1.2, May 1995. The ELF64 stuff is based on ELF-64 Object File Format
15 // Version 1.5, Draft 2, May 1998 as well as OpenBSD header files.
16 //
17 //===----------------------------------------------------------------------===//
18
19 #ifndef LLVM_BINARYFORMAT_ELF_H
20 #define LLVM_BINARYFORMAT_ELF_H
21
22 #include "llvm/ADT/StringRef.h"
23 #include "llvm/Support/Compiler.h"
24 #include "llvm/TargetParser/Triple.h"
25 #include <cstdint>
26 #include <cstring>
27 #include <type_traits>
28
29 namespace llvm {
30 namespace ELF {
31
32 using Elf32_Addr = uint32_t; // Program address
33 using Elf32_Off = uint32_t; // File offset
34 using Elf32_Half = uint16_t;
35 using Elf32_Word = uint32_t;
36 using Elf32_Sword = int32_t;
37
38 using Elf64_Addr = uint64_t;
39 using Elf64_Off = uint64_t;
40 using Elf64_Half = uint16_t;
41 using Elf64_Word = uint32_t;
42 using Elf64_Sword = int32_t;
43 using Elf64_Xword = uint64_t;
44 using Elf64_Sxword = int64_t;
45
46 // Object file magic string.
47 static const char ElfMagic[] = {0x7f, 'E', 'L', 'F', '\0'};
48
49 // e_ident size and indices.
50 enum {
51 EI_MAG0 = 0, // File identification index.
52 EI_MAG1 = 1, // File identification index.
53 EI_MAG2 = 2, // File identification index.
54 EI_MAG3 = 3, // File identification index.
55 EI_CLASS = 4, // File class.
56 EI_DATA = 5, // Data encoding.
57 EI_VERSION = 6, // File version.
58 EI_OSABI = 7, // OS/ABI identification.
59 EI_ABIVERSION = 8, // ABI version.
60 EI_PAD = 9, // Start of padding bytes.
61 EI_NIDENT = 16 // Number of bytes in e_ident.
62 };
63
64 struct Elf32_Ehdr {
65 unsigned char e_ident[EI_NIDENT]; // ELF Identification bytes
66 Elf32_Half e_type; // Type of file (see ET_* below)
67 Elf32_Half e_machine; // Required architecture for this file (see EM_*)
68 Elf32_Word e_version; // Must be equal to 1
69 Elf32_Addr e_entry; // Address to jump to in order to start program
70 Elf32_Off e_phoff; // Program header table's file offset, in bytes
71 Elf32_Off e_shoff; // Section header table's file offset, in bytes
72 Elf32_Word e_flags; // Processor-specific flags
73 Elf32_Half e_ehsize; // Size of ELF header, in bytes
74 Elf32_Half e_phentsize; // Size of an entry in the program header table
75 Elf32_Half e_phnum; // Number of entries in the program header table
76 Elf32_Half e_shentsize; // Size of an entry in the section header table
77 Elf32_Half e_shnum; // Number of entries in the section header table
78 Elf32_Half e_shstrndx; // Sect hdr table index of sect name string table
79
checkMagicElf32_Ehdr80 bool checkMagic() const {
81 return (memcmp(e_ident, ElfMagic, strlen(ElfMagic))) == 0;
82 }
83
getFileClassElf32_Ehdr84 unsigned char getFileClass() const { return e_ident[EI_CLASS]; }
getDataEncodingElf32_Ehdr85 unsigned char getDataEncoding() const { return e_ident[EI_DATA]; }
86 };
87
88 // 64-bit ELF header. Fields are the same as for ELF32, but with different
89 // types (see above).
90 struct Elf64_Ehdr {
91 unsigned char e_ident[EI_NIDENT];
92 Elf64_Half e_type;
93 Elf64_Half e_machine;
94 Elf64_Word e_version;
95 Elf64_Addr e_entry;
96 Elf64_Off e_phoff;
97 Elf64_Off e_shoff;
98 Elf64_Word e_flags;
99 Elf64_Half e_ehsize;
100 Elf64_Half e_phentsize;
101 Elf64_Half e_phnum;
102 Elf64_Half e_shentsize;
103 Elf64_Half e_shnum;
104 Elf64_Half e_shstrndx;
105
checkMagicElf64_Ehdr106 bool checkMagic() const {
107 return (memcmp(e_ident, ElfMagic, strlen(ElfMagic))) == 0;
108 }
109
getFileClassElf64_Ehdr110 unsigned char getFileClass() const { return e_ident[EI_CLASS]; }
getDataEncodingElf64_Ehdr111 unsigned char getDataEncoding() const { return e_ident[EI_DATA]; }
112 };
113
114 // File types.
115 // See current registered ELF types at:
116 // http://www.sco.com/developers/gabi/latest/ch4.eheader.html
117 enum {
118 ET_NONE = 0, // No file type
119 ET_REL = 1, // Relocatable file
120 ET_EXEC = 2, // Executable file
121 ET_DYN = 3, // Shared object file
122 ET_CORE = 4, // Core file
123 ET_LOOS = 0xfe00, // Beginning of operating system-specific codes
124 ET_HIOS = 0xfeff, // Operating system-specific
125 ET_LOPROC = 0xff00, // Beginning of processor-specific codes
126 ET_HIPROC = 0xffff // Processor-specific
127 };
128
129 // Versioning
130 enum { EV_NONE = 0, EV_CURRENT = 1 };
131
132 // Machine architectures.
133 // At the time of writing, the list of registered machine architectures is
134 // at https://groups.google.com/g/generic-abi/c/0kORSDcyhTE/m/ZRf_PvcHAAAJ
135 // Please refer to https://groups.google.com/g/generic-abi for any further
136 // updates.
137 enum {
138 EM_NONE = 0, // No machine
139 EM_M32 = 1, // AT&T WE 32100
140 EM_SPARC = 2, // SPARC
141 EM_386 = 3, // Intel 386
142 EM_68K = 4, // Motorola 68000
143 EM_88K = 5, // Motorola 88000
144 EM_IAMCU = 6, // Intel MCU
145 EM_860 = 7, // Intel 80860
146 EM_MIPS = 8, // MIPS R3000
147 EM_S370 = 9, // IBM System/370
148 EM_MIPS_RS3_LE = 10, // MIPS RS3000 Little-endian
149 EM_PARISC = 15, // Hewlett-Packard PA-RISC
150 EM_VPP500 = 17, // Fujitsu VPP500
151 EM_SPARC32PLUS = 18, // Enhanced instruction set SPARC
152 EM_960 = 19, // Intel 80960
153 EM_PPC = 20, // PowerPC
154 EM_PPC64 = 21, // PowerPC64
155 EM_S390 = 22, // IBM System/390
156 EM_SPU = 23, // IBM SPU/SPC
157 EM_V800 = 36, // NEC V800
158 EM_FR20 = 37, // Fujitsu FR20
159 EM_RH32 = 38, // TRW RH-32
160 EM_RCE = 39, // Motorola RCE
161 EM_ARM = 40, // ARM
162 EM_ALPHA = 41, // DEC Alpha
163 EM_SH = 42, // Hitachi SH
164 EM_SPARCV9 = 43, // SPARC V9
165 EM_TRICORE = 44, // Siemens TriCore
166 EM_ARC = 45, // Argonaut RISC Core
167 EM_H8_300 = 46, // Hitachi H8/300
168 EM_H8_300H = 47, // Hitachi H8/300H
169 EM_H8S = 48, // Hitachi H8S
170 EM_H8_500 = 49, // Hitachi H8/500
171 EM_IA_64 = 50, // Intel IA-64 processor architecture
172 EM_MIPS_X = 51, // Stanford MIPS-X
173 EM_COLDFIRE = 52, // Motorola ColdFire
174 EM_68HC12 = 53, // Motorola M68HC12
175 EM_MMA = 54, // Fujitsu MMA Multimedia Accelerator
176 EM_PCP = 55, // Siemens PCP
177 EM_NCPU = 56, // Sony nCPU embedded RISC processor
178 EM_NDR1 = 57, // Denso NDR1 microprocessor
179 EM_STARCORE = 58, // Motorola Star*Core processor
180 EM_ME16 = 59, // Toyota ME16 processor
181 EM_ST100 = 60, // STMicroelectronics ST100 processor
182 EM_TINYJ = 61, // Advanced Logic Corp. TinyJ embedded processor family
183 EM_X86_64 = 62, // AMD x86-64 architecture
184 EM_PDSP = 63, // Sony DSP Processor
185 EM_PDP10 = 64, // Digital Equipment Corp. PDP-10
186 EM_PDP11 = 65, // Digital Equipment Corp. PDP-11
187 EM_FX66 = 66, // Siemens FX66 microcontroller
188 EM_ST9PLUS = 67, // STMicroelectronics ST9+ 8/16 bit microcontroller
189 EM_ST7 = 68, // STMicroelectronics ST7 8-bit microcontroller
190 EM_68HC16 = 69, // Motorola MC68HC16 Microcontroller
191 EM_68HC11 = 70, // Motorola MC68HC11 Microcontroller
192 EM_68HC08 = 71, // Motorola MC68HC08 Microcontroller
193 EM_68HC05 = 72, // Motorola MC68HC05 Microcontroller
194 EM_SVX = 73, // Silicon Graphics SVx
195 EM_ST19 = 74, // STMicroelectronics ST19 8-bit microcontroller
196 EM_VAX = 75, // Digital VAX
197 EM_CRIS = 76, // Axis Communications 32-bit embedded processor
198 EM_JAVELIN = 77, // Infineon Technologies 32-bit embedded processor
199 EM_FIREPATH = 78, // Element 14 64-bit DSP Processor
200 EM_ZSP = 79, // LSI Logic 16-bit DSP Processor
201 EM_MMIX = 80, // Donald Knuth's educational 64-bit processor
202 EM_HUANY = 81, // Harvard University machine-independent object files
203 EM_PRISM = 82, // SiTera Prism
204 EM_AVR = 83, // Atmel AVR 8-bit microcontroller
205 EM_FR30 = 84, // Fujitsu FR30
206 EM_D10V = 85, // Mitsubishi D10V
207 EM_D30V = 86, // Mitsubishi D30V
208 EM_V850 = 87, // NEC v850
209 EM_M32R = 88, // Mitsubishi M32R
210 EM_MN10300 = 89, // Matsushita MN10300
211 EM_MN10200 = 90, // Matsushita MN10200
212 EM_PJ = 91, // picoJava
213 EM_OPENRISC = 92, // OpenRISC 32-bit embedded processor
214 EM_ARC_COMPACT = 93, // ARC International ARCompact processor (old
215 // spelling/synonym: EM_ARC_A5)
216 EM_XTENSA = 94, // Tensilica Xtensa Architecture
217 EM_VIDEOCORE = 95, // Alphamosaic VideoCore processor
218 EM_TMM_GPP = 96, // Thompson Multimedia General Purpose Processor
219 EM_NS32K = 97, // National Semiconductor 32000 series
220 EM_TPC = 98, // Tenor Network TPC processor
221 EM_SNP1K = 99, // Trebia SNP 1000 processor
222 EM_ST200 = 100, // STMicroelectronics (www.st.com) ST200
223 EM_IP2K = 101, // Ubicom IP2xxx microcontroller family
224 EM_MAX = 102, // MAX Processor
225 EM_CR = 103, // National Semiconductor CompactRISC microprocessor
226 EM_F2MC16 = 104, // Fujitsu F2MC16
227 EM_MSP430 = 105, // Texas Instruments embedded microcontroller msp430
228 EM_BLACKFIN = 106, // Analog Devices Blackfin (DSP) processor
229 EM_SE_C33 = 107, // S1C33 Family of Seiko Epson processors
230 EM_SEP = 108, // Sharp embedded microprocessor
231 EM_ARCA = 109, // Arca RISC Microprocessor
232 EM_UNICORE = 110, // Microprocessor series from PKU-Unity Ltd. and MPRC
233 // of Peking University
234 EM_EXCESS = 111, // eXcess: 16/32/64-bit configurable embedded CPU
235 EM_DXP = 112, // Icera Semiconductor Inc. Deep Execution Processor
236 EM_ALTERA_NIOS2 = 113, // Altera Nios II soft-core processor
237 EM_CRX = 114, // National Semiconductor CompactRISC CRX
238 EM_XGATE = 115, // Motorola XGATE embedded processor
239 EM_C166 = 116, // Infineon C16x/XC16x processor
240 EM_M16C = 117, // Renesas M16C series microprocessors
241 EM_DSPIC30F = 118, // Microchip Technology dsPIC30F Digital Signal
242 // Controller
243 EM_CE = 119, // Freescale Communication Engine RISC core
244 EM_M32C = 120, // Renesas M32C series microprocessors
245 EM_TSK3000 = 131, // Altium TSK3000 core
246 EM_RS08 = 132, // Freescale RS08 embedded processor
247 EM_SHARC = 133, // Analog Devices SHARC family of 32-bit DSP
248 // processors
249 EM_ECOG2 = 134, // Cyan Technology eCOG2 microprocessor
250 EM_SCORE7 = 135, // Sunplus S+core7 RISC processor
251 EM_DSP24 = 136, // New Japan Radio (NJR) 24-bit DSP Processor
252 EM_VIDEOCORE3 = 137, // Broadcom VideoCore III processor
253 EM_LATTICEMICO32 = 138, // RISC processor for Lattice FPGA architecture
254 EM_SE_C17 = 139, // Seiko Epson C17 family
255 EM_TI_C6000 = 140, // The Texas Instruments TMS320C6000 DSP family
256 EM_TI_C2000 = 141, // The Texas Instruments TMS320C2000 DSP family
257 EM_TI_C5500 = 142, // The Texas Instruments TMS320C55x DSP family
258 EM_MMDSP_PLUS = 160, // STMicroelectronics 64bit VLIW Data Signal Processor
259 EM_CYPRESS_M8C = 161, // Cypress M8C microprocessor
260 EM_R32C = 162, // Renesas R32C series microprocessors
261 EM_TRIMEDIA = 163, // NXP Semiconductors TriMedia architecture family
262 EM_HEXAGON = 164, // Qualcomm Hexagon processor
263 EM_8051 = 165, // Intel 8051 and variants
264 EM_STXP7X = 166, // STMicroelectronics STxP7x family of configurable
265 // and extensible RISC processors
266 EM_NDS32 = 167, // Andes Technology compact code size embedded RISC
267 // processor family
268 EM_ECOG1 = 168, // Cyan Technology eCOG1X family
269 EM_ECOG1X = 168, // Cyan Technology eCOG1X family
270 EM_MAXQ30 = 169, // Dallas Semiconductor MAXQ30 Core Micro-controllers
271 EM_XIMO16 = 170, // New Japan Radio (NJR) 16-bit DSP Processor
272 EM_MANIK = 171, // M2000 Reconfigurable RISC Microprocessor
273 EM_CRAYNV2 = 172, // Cray Inc. NV2 vector architecture
274 EM_RX = 173, // Renesas RX family
275 EM_METAG = 174, // Imagination Technologies META processor
276 // architecture
277 EM_MCST_ELBRUS = 175, // MCST Elbrus general purpose hardware architecture
278 EM_ECOG16 = 176, // Cyan Technology eCOG16 family
279 EM_CR16 = 177, // National Semiconductor CompactRISC CR16 16-bit
280 // microprocessor
281 EM_ETPU = 178, // Freescale Extended Time Processing Unit
282 EM_SLE9X = 179, // Infineon Technologies SLE9X core
283 EM_L10M = 180, // Intel L10M
284 EM_K10M = 181, // Intel K10M
285 EM_AARCH64 = 183, // ARM AArch64
286 EM_AVR32 = 185, // Atmel Corporation 32-bit microprocessor family
287 EM_STM8 = 186, // STMicroeletronics STM8 8-bit microcontroller
288 EM_TILE64 = 187, // Tilera TILE64 multicore architecture family
289 EM_TILEPRO = 188, // Tilera TILEPro multicore architecture family
290 EM_MICROBLAZE = 189, // Xilinx MicroBlaze 32-bit RISC soft processor core
291 EM_CUDA = 190, // NVIDIA CUDA architecture
292 EM_TILEGX = 191, // Tilera TILE-Gx multicore architecture family
293 EM_CLOUDSHIELD = 192, // CloudShield architecture family
294 EM_COREA_1ST = 193, // KIPO-KAIST Core-A 1st generation processor family
295 EM_COREA_2ND = 194, // KIPO-KAIST Core-A 2nd generation processor family
296 EM_ARC_COMPACT2 = 195, // Synopsys ARCompact V2
297 EM_OPEN8 = 196, // Open8 8-bit RISC soft processor core
298 EM_RL78 = 197, // Renesas RL78 family
299 EM_VIDEOCORE5 = 198, // Broadcom VideoCore V processor
300 EM_78KOR = 199, // Renesas 78KOR family
301 EM_56800EX = 200, // Freescale 56800EX Digital Signal Controller (DSC)
302 EM_BA1 = 201, // Beyond BA1 CPU architecture
303 EM_BA2 = 202, // Beyond BA2 CPU architecture
304 EM_XCORE = 203, // XMOS xCORE processor family
305 EM_MCHP_PIC = 204, // Microchip 8-bit PIC(r) family
306 EM_INTEL205 = 205, // Reserved by Intel
307 EM_INTEL206 = 206, // Reserved by Intel
308 EM_INTEL207 = 207, // Reserved by Intel
309 EM_INTEL208 = 208, // Reserved by Intel
310 EM_INTEL209 = 209, // Reserved by Intel
311 EM_KM32 = 210, // KM211 KM32 32-bit processor
312 EM_KMX32 = 211, // KM211 KMX32 32-bit processor
313 EM_KMX16 = 212, // KM211 KMX16 16-bit processor
314 EM_KMX8 = 213, // KM211 KMX8 8-bit processor
315 EM_KVARC = 214, // KM211 KVARC processor
316 EM_CDP = 215, // Paneve CDP architecture family
317 EM_COGE = 216, // Cognitive Smart Memory Processor
318 EM_COOL = 217, // iCelero CoolEngine
319 EM_NORC = 218, // Nanoradio Optimized RISC
320 EM_CSR_KALIMBA = 219, // CSR Kalimba architecture family
321 EM_AMDGPU = 224, // AMD GPU architecture
322 EM_RISCV = 243, // RISC-V
323 EM_LANAI = 244, // Lanai 32-bit processor
324 EM_BPF = 247, // Linux kernel bpf virtual machine
325 EM_VE = 251, // NEC SX-Aurora VE
326 EM_CSKY = 252, // C-SKY 32-bit processor
327 EM_LOONGARCH = 258, // LoongArch
328 };
329
330 // Object file classes.
331 enum {
332 ELFCLASSNONE = 0,
333 ELFCLASS32 = 1, // 32-bit object file
334 ELFCLASS64 = 2 // 64-bit object file
335 };
336
337 // Object file byte orderings.
338 enum {
339 ELFDATANONE = 0, // Invalid data encoding.
340 ELFDATA2LSB = 1, // Little-endian object file
341 ELFDATA2MSB = 2 // Big-endian object file
342 };
343
344 // OS ABI identification.
345 enum {
346 ELFOSABI_NONE = 0, // UNIX System V ABI
347 ELFOSABI_HPUX = 1, // HP-UX operating system
348 ELFOSABI_NETBSD = 2, // NetBSD
349 ELFOSABI_GNU = 3, // GNU/Linux
350 ELFOSABI_LINUX = 3, // Historical alias for ELFOSABI_GNU.
351 ELFOSABI_HURD = 4, // GNU/Hurd
352 ELFOSABI_SOLARIS = 6, // Solaris
353 ELFOSABI_AIX = 7, // AIX
354 ELFOSABI_IRIX = 8, // IRIX
355 ELFOSABI_FREEBSD = 9, // FreeBSD
356 ELFOSABI_TRU64 = 10, // TRU64 UNIX
357 ELFOSABI_MODESTO = 11, // Novell Modesto
358 ELFOSABI_OPENBSD = 12, // OpenBSD
359 ELFOSABI_OPENVMS = 13, // OpenVMS
360 ELFOSABI_NSK = 14, // Hewlett-Packard Non-Stop Kernel
361 ELFOSABI_AROS = 15, // AROS
362 ELFOSABI_FENIXOS = 16, // FenixOS
363 ELFOSABI_CLOUDABI = 17, // Nuxi CloudABI
364 ELFOSABI_CUDA = 51, // NVIDIA CUDA architecture.
365 ELFOSABI_CUDA_V2 = 41, // NVIDIA CUDA architecture.
366 ELFOSABI_FIRST_ARCH = 64, // First architecture-specific OS ABI
367 ELFOSABI_AMDGPU_HSA = 64, // AMD HSA runtime
368 ELFOSABI_AMDGPU_PAL = 65, // AMD PAL runtime
369 ELFOSABI_AMDGPU_MESA3D = 66, // AMD GCN GPUs (GFX6+) for MESA runtime
370 ELFOSABI_ARM = 97, // ARM
371 ELFOSABI_ARM_FDPIC = 65, // ARM FDPIC
372 ELFOSABI_C6000_ELFABI = 64, // Bare-metal TMS320C6000
373 ELFOSABI_C6000_LINUX = 65, // Linux TMS320C6000
374 ELFOSABI_STANDALONE = 255, // Standalone (embedded) application
375 ELFOSABI_LAST_ARCH = 255 // Last Architecture-specific OS ABI
376 };
377
378 // AMDGPU OS ABI Version identification.
379 enum {
380 // ELFABIVERSION_AMDGPU_HSA_V1 does not exist because OS ABI identification
381 // was never defined for V1.
382 ELFABIVERSION_AMDGPU_HSA_V2 = 0,
383 ELFABIVERSION_AMDGPU_HSA_V3 = 1,
384 ELFABIVERSION_AMDGPU_HSA_V4 = 2,
385 ELFABIVERSION_AMDGPU_HSA_V5 = 3,
386 ELFABIVERSION_AMDGPU_HSA_V6 = 4,
387 };
388
389 // CUDA OS ABI Version identification.
390 enum {
391 ELFABIVERSION_CUDA_V1 = 7,
392 ELFABIVERSION_CUDA_V2 = 8,
393 };
394
395 #define ELF_RELOC(name, value) name = value,
396
397 // X86_64 relocations.
398 enum {
399 #include "ELFRelocs/x86_64.def"
400 };
401
402 // i386 relocations.
403 enum {
404 #include "ELFRelocs/i386.def"
405 };
406
407 // ELF Relocation types for PPC32
408 enum {
409 #include "ELFRelocs/PowerPC.def"
410 };
411
412 // Specific e_flags for PPC64
413 enum {
414 // e_flags bits specifying ABI:
415 // 1 for original ABI using function descriptors,
416 // 2 for revised ABI without function descriptors,
417 // 0 for unspecified or not using any features affected by the differences.
418 EF_PPC64_ABI = 3
419 };
420
421 // Special values for the st_other field in the symbol table entry for PPC64.
422 enum {
423 STO_PPC64_LOCAL_BIT = 5,
424 STO_PPC64_LOCAL_MASK = (7 << STO_PPC64_LOCAL_BIT)
425 };
decodePPC64LocalEntryOffset(unsigned Other)426 static inline int64_t decodePPC64LocalEntryOffset(unsigned Other) {
427 unsigned Val = (Other & STO_PPC64_LOCAL_MASK) >> STO_PPC64_LOCAL_BIT;
428 return ((1 << Val) >> 2) << 2;
429 }
430
431 // ELF Relocation types for PPC64
432 enum {
433 #include "ELFRelocs/PowerPC64.def"
434 };
435
436 // ELF Relocation types for AArch64
437 enum {
438 #include "ELFRelocs/AArch64.def"
439 };
440
441 // Special values for the st_other field in the symbol table entry for AArch64.
442 enum {
443 // Symbol may follow different calling convention than base PCS.
444 STO_AARCH64_VARIANT_PCS = 0x80
445 };
446
447 // ARM Specific e_flags
448 enum : unsigned {
449 EF_ARM_SOFT_FLOAT = 0x00000200U, // Legacy pre EABI_VER5
450 EF_ARM_ABI_FLOAT_SOFT = 0x00000200U, // EABI_VER5
451 EF_ARM_VFP_FLOAT = 0x00000400U, // Legacy pre EABI_VER5
452 EF_ARM_ABI_FLOAT_HARD = 0x00000400U, // EABI_VER5
453 EF_ARM_BE8 = 0x00800000U,
454 EF_ARM_EABI_UNKNOWN = 0x00000000U,
455 EF_ARM_EABI_VER1 = 0x01000000U,
456 EF_ARM_EABI_VER2 = 0x02000000U,
457 EF_ARM_EABI_VER3 = 0x03000000U,
458 EF_ARM_EABI_VER4 = 0x04000000U,
459 EF_ARM_EABI_VER5 = 0x05000000U,
460 EF_ARM_EABIMASK = 0xFF000000U
461 };
462
463 // ELF Relocation types for ARM
464 enum {
465 #include "ELFRelocs/ARM.def"
466 };
467
468 // ARC Specific e_flags
469 enum : unsigned {
470 EF_ARC_MACH_MSK = 0x000000ff,
471 EF_ARC_OSABI_MSK = 0x00000f00,
472 E_ARC_MACH_ARC600 = 0x00000002,
473 E_ARC_MACH_ARC601 = 0x00000004,
474 E_ARC_MACH_ARC700 = 0x00000003,
475 EF_ARC_CPU_ARCV2EM = 0x00000005,
476 EF_ARC_CPU_ARCV2HS = 0x00000006,
477 E_ARC_OSABI_ORIG = 0x00000000,
478 E_ARC_OSABI_V2 = 0x00000200,
479 E_ARC_OSABI_V3 = 0x00000300,
480 E_ARC_OSABI_V4 = 0x00000400,
481 EF_ARC_PIC = 0x00000100
482 };
483
484 // ELF Relocation types for ARC
485 enum {
486 #include "ELFRelocs/ARC.def"
487 };
488
489 // AVR specific e_flags
490 enum : unsigned {
491 EF_AVR_ARCH_AVR1 = 1,
492 EF_AVR_ARCH_AVR2 = 2,
493 EF_AVR_ARCH_AVR25 = 25,
494 EF_AVR_ARCH_AVR3 = 3,
495 EF_AVR_ARCH_AVR31 = 31,
496 EF_AVR_ARCH_AVR35 = 35,
497 EF_AVR_ARCH_AVR4 = 4,
498 EF_AVR_ARCH_AVR5 = 5,
499 EF_AVR_ARCH_AVR51 = 51,
500 EF_AVR_ARCH_AVR6 = 6,
501 EF_AVR_ARCH_AVRTINY = 100,
502 EF_AVR_ARCH_XMEGA1 = 101,
503 EF_AVR_ARCH_XMEGA2 = 102,
504 EF_AVR_ARCH_XMEGA3 = 103,
505 EF_AVR_ARCH_XMEGA4 = 104,
506 EF_AVR_ARCH_XMEGA5 = 105,
507 EF_AVR_ARCH_XMEGA6 = 106,
508 EF_AVR_ARCH_XMEGA7 = 107,
509
510 EF_AVR_ARCH_MASK = 0x7f, // EF_AVR_ARCH_xxx selection mask
511
512 EF_AVR_LINKRELAX_PREPARED = 0x80, // The file is prepared for linker
513 // relaxation to be applied
514 };
515
516 // ELF Relocation types for AVR
517 enum {
518 #include "ELFRelocs/AVR.def"
519 };
520
521 // Mips Specific e_flags
522 enum : unsigned {
523 EF_MIPS_NOREORDER = 0x00000001, // Don't reorder instructions
524 EF_MIPS_PIC = 0x00000002, // Position independent code
525 EF_MIPS_CPIC = 0x00000004, // Call object with Position independent code
526 EF_MIPS_ABI2 = 0x00000020, // File uses N32 ABI
527 EF_MIPS_32BITMODE = 0x00000100, // Code compiled for a 64-bit machine
528 // in 32-bit mode
529 EF_MIPS_FP64 = 0x00000200, // Code compiled for a 32-bit machine
530 // but uses 64-bit FP registers
531 EF_MIPS_NAN2008 = 0x00000400, // Uses IEE 754-2008 NaN encoding
532
533 // ABI flags
534 EF_MIPS_ABI_O32 = 0x00001000, // This file follows the first MIPS 32 bit ABI
535 EF_MIPS_ABI_O64 = 0x00002000, // O32 ABI extended for 64-bit architecture.
536 EF_MIPS_ABI_EABI32 = 0x00003000, // EABI in 32 bit mode.
537 EF_MIPS_ABI_EABI64 = 0x00004000, // EABI in 64 bit mode.
538 EF_MIPS_ABI = 0x0000f000, // Mask for selecting EF_MIPS_ABI_ variant.
539
540 // MIPS machine variant
541 EF_MIPS_MACH_NONE = 0x00000000, // A standard MIPS implementation.
542 EF_MIPS_MACH_3900 = 0x00810000, // Toshiba R3900
543 EF_MIPS_MACH_4010 = 0x00820000, // LSI R4010
544 EF_MIPS_MACH_4100 = 0x00830000, // NEC VR4100
545 EF_MIPS_MACH_4650 = 0x00850000, // MIPS R4650
546 EF_MIPS_MACH_4120 = 0x00870000, // NEC VR4120
547 EF_MIPS_MACH_4111 = 0x00880000, // NEC VR4111/VR4181
548 EF_MIPS_MACH_SB1 = 0x008a0000, // Broadcom SB-1
549 EF_MIPS_MACH_OCTEON = 0x008b0000, // Cavium Networks Octeon
550 EF_MIPS_MACH_XLR = 0x008c0000, // RMI Xlr
551 EF_MIPS_MACH_OCTEON2 = 0x008d0000, // Cavium Networks Octeon2
552 EF_MIPS_MACH_OCTEON3 = 0x008e0000, // Cavium Networks Octeon3
553 EF_MIPS_MACH_5400 = 0x00910000, // NEC VR5400
554 EF_MIPS_MACH_5900 = 0x00920000, // MIPS R5900
555 EF_MIPS_MACH_5500 = 0x00980000, // NEC VR5500
556 EF_MIPS_MACH_9000 = 0x00990000, // Unknown
557 EF_MIPS_MACH_LS2E = 0x00a00000, // ST Microelectronics Loongson 2E
558 EF_MIPS_MACH_LS2F = 0x00a10000, // ST Microelectronics Loongson 2F
559 EF_MIPS_MACH_LS3A = 0x00a20000, // Loongson 3A
560 EF_MIPS_MACH = 0x00ff0000, // EF_MIPS_MACH_xxx selection mask
561
562 // ARCH_ASE
563 EF_MIPS_MICROMIPS = 0x02000000, // microMIPS
564 EF_MIPS_ARCH_ASE_M16 = 0x04000000, // Has Mips-16 ISA extensions
565 EF_MIPS_ARCH_ASE_MDMX = 0x08000000, // Has MDMX multimedia extensions
566 EF_MIPS_ARCH_ASE = 0x0f000000, // Mask for EF_MIPS_ARCH_ASE_xxx flags
567
568 // ARCH
569 EF_MIPS_ARCH_1 = 0x00000000, // MIPS1 instruction set
570 EF_MIPS_ARCH_2 = 0x10000000, // MIPS2 instruction set
571 EF_MIPS_ARCH_3 = 0x20000000, // MIPS3 instruction set
572 EF_MIPS_ARCH_4 = 0x30000000, // MIPS4 instruction set
573 EF_MIPS_ARCH_5 = 0x40000000, // MIPS5 instruction set
574 EF_MIPS_ARCH_32 = 0x50000000, // MIPS32 instruction set per linux not elf.h
575 EF_MIPS_ARCH_64 = 0x60000000, // MIPS64 instruction set per linux not elf.h
576 EF_MIPS_ARCH_32R2 = 0x70000000, // mips32r2, mips32r3, mips32r5
577 EF_MIPS_ARCH_64R2 = 0x80000000, // mips64r2, mips64r3, mips64r5
578 EF_MIPS_ARCH_32R6 = 0x90000000, // mips32r6
579 EF_MIPS_ARCH_64R6 = 0xa0000000, // mips64r6
580 EF_MIPS_ARCH = 0xf0000000 // Mask for applying EF_MIPS_ARCH_ variant
581 };
582
583 // MIPS-specific section indexes
584 enum {
585 SHN_MIPS_ACOMMON = 0xff00, // Common symbols which are defined and allocated
586 SHN_MIPS_TEXT = 0xff01, // Not ABI compliant
587 SHN_MIPS_DATA = 0xff02, // Not ABI compliant
588 SHN_MIPS_SCOMMON = 0xff03, // Common symbols for global data area
589 SHN_MIPS_SUNDEFINED = 0xff04 // Undefined symbols for global data area
590 };
591
592 // ELF Relocation types for Mips
593 enum {
594 #include "ELFRelocs/Mips.def"
595 };
596
597 // Special values for the st_other field in the symbol table entry for MIPS.
598 enum {
599 STO_MIPS_OPTIONAL = 0x04, // Symbol whose definition is optional
600 STO_MIPS_PLT = 0x08, // PLT entry related dynamic table record
601 STO_MIPS_PIC = 0x20, // PIC func in an object mixes PIC/non-PIC
602 STO_MIPS_MICROMIPS = 0x80, // MIPS Specific ISA for MicroMips
603 STO_MIPS_MIPS16 = 0xf0 // MIPS Specific ISA for Mips16
604 };
605
606 // .MIPS.options section descriptor kinds
607 enum {
608 ODK_NULL = 0, // Undefined
609 ODK_REGINFO = 1, // Register usage information
610 ODK_EXCEPTIONS = 2, // Exception processing options
611 ODK_PAD = 3, // Section padding options
612 ODK_HWPATCH = 4, // Hardware patches applied
613 ODK_FILL = 5, // Linker fill value
614 ODK_TAGS = 6, // Space for tool identification
615 ODK_HWAND = 7, // Hardware AND patches applied
616 ODK_HWOR = 8, // Hardware OR patches applied
617 ODK_GP_GROUP = 9, // GP group to use for text/data sections
618 ODK_IDENT = 10, // ID information
619 ODK_PAGESIZE = 11 // Page size information
620 };
621
622 // Hexagon-specific e_flags
623 enum {
624 // Hexagon ISA version, bits[11:0]
625 EF_HEXAGON_ISA_MACH = 0x00000000, // Same as specified in bits[11:0]
626 // of e_flags
627 EF_HEXAGON_ISA_V2 = 0x00000010, // Hexagon V2 ISA
628 EF_HEXAGON_ISA_V3 = 0x00000020, // Hexagon V3 ISA
629 EF_HEXAGON_ISA_V4 = 0x00000030, // Hexagon V4 ISA
630 EF_HEXAGON_ISA_V5 = 0x00000040, // Hexagon V5 ISA
631 EF_HEXAGON_ISA_V55 = 0x00000050, // Hexagon V55 ISA
632 EF_HEXAGON_ISA_V60 = 0x00000060, // Hexagon V60 ISA
633 EF_HEXAGON_ISA_V61 = 0x00000061, // Hexagon V61 ISA
634 EF_HEXAGON_ISA_V62 = 0x00000062, // Hexagon V62 ISA
635 EF_HEXAGON_ISA_V65 = 0x00000065, // Hexagon V65 ISA
636 EF_HEXAGON_ISA_V66 = 0x00000066, // Hexagon V66 ISA
637 EF_HEXAGON_ISA_V67 = 0x00000067, // Hexagon V67 ISA
638 EF_HEXAGON_ISA_V68 = 0x00000068, // Hexagon V68 ISA
639 EF_HEXAGON_ISA_V69 = 0x00000069, // Hexagon V69 ISA
640 EF_HEXAGON_ISA_V71 = 0x00000071, // Hexagon V71 ISA
641 EF_HEXAGON_ISA_V73 = 0x00000073, // Hexagon V73 ISA
642 EF_HEXAGON_ISA_V75 = 0x00000075, // Hexagon V75 ISA
643 EF_HEXAGON_ISA_V77 = 0x00000077, // Hexagon V77 ISA
644 EF_HEXAGON_ISA_V79 = 0x00000079, // Hexagon V79 ISA
645 EF_HEXAGON_ISA_V81 = 0x00000081, // Hexagon V81 ISA
646 EF_HEXAGON_ISA_V83 = 0x00000083, // Hexagon V83 ISA
647 EF_HEXAGON_ISA_V85 = 0x00000085, // Hexagon V85 ISA
648 EF_HEXAGON_ISA_V87 = 0x00000087, // Hexagon V87 ISA
649 EF_HEXAGON_ISA_V89 = 0x00000089, // Hexagon V89 ISA
650 EF_HEXAGON_ISA = 0x000003ff, // Hexagon V.. ISA
651
652 // Tiny core flag, bit[15]
653 EF_HEXAGON_TINY_CORE = 0x00008000, // Hexagon Tiny Core
654
655 // Hexagon processor version, bits[15:0]
656 EF_HEXAGON_MACH_V2 = 0x00000001, // Hexagon V2
657 EF_HEXAGON_MACH_V3 = 0x00000002, // Hexagon V3
658 EF_HEXAGON_MACH_V4 = 0x00000003, // Hexagon V4
659 EF_HEXAGON_MACH_V5 = 0x00000004, // Hexagon V5
660 EF_HEXAGON_MACH_V55 = 0x00000005, // Hexagon V55
661 EF_HEXAGON_MACH_V60 = EF_HEXAGON_ISA_V60, // Hexagon V60
662 EF_HEXAGON_MACH_V61 = EF_HEXAGON_ISA_V61, // Hexagon V61
663 EF_HEXAGON_MACH_V62 = EF_HEXAGON_ISA_V62, // Hexagon V62
664 EF_HEXAGON_MACH_V65 = EF_HEXAGON_ISA_V65, // Hexagon V65
665 EF_HEXAGON_MACH_V66 = EF_HEXAGON_ISA_V66, // Hexagon V66
666 EF_HEXAGON_MACH_V67 = EF_HEXAGON_ISA_V67, // Hexagon V67
667 EF_HEXAGON_MACH_V67T =
668 EF_HEXAGON_ISA_V67 | EF_HEXAGON_TINY_CORE, // Hexagon V67T
669 EF_HEXAGON_MACH_V68 = EF_HEXAGON_ISA_V68, // Hexagon V68
670 EF_HEXAGON_MACH_V69 = EF_HEXAGON_ISA_V69, // Hexagon V69
671 EF_HEXAGON_MACH_V71 = EF_HEXAGON_ISA_V71, // Hexagon V71
672 EF_HEXAGON_MACH_V71T =
673 EF_HEXAGON_ISA_V71 | EF_HEXAGON_TINY_CORE, // Hexagon V71T
674 EF_HEXAGON_MACH_V73 = EF_HEXAGON_ISA_V73, // Hexagon V73
675 EF_HEXAGON_MACH_V75 = EF_HEXAGON_ISA_V75, // Hexagon V75
676 EF_HEXAGON_MACH_V77 = EF_HEXAGON_ISA_V77, // Hexagon V77
677 EF_HEXAGON_MACH_V79 = EF_HEXAGON_ISA_V79, // Hexagon V79
678 EF_HEXAGON_MACH_V81 = EF_HEXAGON_ISA_V81, // Hexagon V81
679 EF_HEXAGON_MACH_V83 = EF_HEXAGON_ISA_V83, // Hexagon V83
680 EF_HEXAGON_MACH_V85 = EF_HEXAGON_ISA_V85, // Hexagon V85
681 EF_HEXAGON_MACH_V87 = EF_HEXAGON_ISA_V87, // Hexagon V87
682 EF_HEXAGON_MACH_V89 = EF_HEXAGON_ISA_V89, // Hexagon V89
683
684 EF_HEXAGON_MACH = 0x0000ffff, // Hexagon V..
685 };
686
687 // Hexagon-specific section indexes for common small data
688 enum {
689 SHN_HEXAGON_SCOMMON = 0xff00, // Other access sizes
690 SHN_HEXAGON_SCOMMON_1 = 0xff01, // Byte-sized access
691 SHN_HEXAGON_SCOMMON_2 = 0xff02, // Half-word-sized access
692 SHN_HEXAGON_SCOMMON_4 = 0xff03, // Word-sized access
693 SHN_HEXAGON_SCOMMON_8 = 0xff04 // Double-word-size access
694 };
695
696 // ELF Relocation types for Hexagon
697 enum {
698 #include "ELFRelocs/Hexagon.def"
699 };
700
701 // ELF Relocation type for Lanai.
702 enum {
703 #include "ELFRelocs/Lanai.def"
704 };
705
706 // RISCV Specific e_flags
707 enum : unsigned {
708 EF_RISCV_RVC = 0x0001,
709 EF_RISCV_FLOAT_ABI = 0x0006,
710 EF_RISCV_FLOAT_ABI_SOFT = 0x0000,
711 EF_RISCV_FLOAT_ABI_SINGLE = 0x0002,
712 EF_RISCV_FLOAT_ABI_DOUBLE = 0x0004,
713 EF_RISCV_FLOAT_ABI_QUAD = 0x0006,
714 EF_RISCV_RVE = 0x0008,
715 EF_RISCV_TSO = 0x0010,
716 };
717
718 // ELF Relocation types for RISC-V
719 enum {
720 #include "ELFRelocs/RISCV.def"
721 #define ELF_RISCV_NONSTANDARD_RELOC(_vendor, name, value) name = value,
722 #include "ELFRelocs/RISCV_nonstandard.def"
723 #undef ELF_RISCV_NONSTANDARD_RELOC
724 };
725
726 enum {
727 // Symbol may follow different calling convention than the standard calling
728 // convention.
729 STO_RISCV_VARIANT_CC = 0x80
730 };
731
732 // ELF Relocation types for S390/zSeries
733 enum {
734 #include "ELFRelocs/SystemZ.def"
735 };
736
737 // SPARC Specific e_flags
738 enum : unsigned {
739 // ELF extension mask.
740 // All values are available for EM_SPARC32PLUS & EM_SPARCV9 objects, except
741 // EF_SPARC_32PLUS which is a EM_SPARC32PLUS-only flag.
742 //
743 // Note that those features are not mutually exclusive (one can set more than
744 // one flag in this group).
745 EF_SPARC_EXT_MASK = 0xffff00,
746 EF_SPARC_32PLUS = 0x000100,
747 EF_SPARC_SUN_US1 = 0x000200,
748 EF_SPARC_HAL_R1 = 0x000400,
749 EF_SPARC_SUN_US3 = 0x000800,
750
751 // Memory model selection mask for EM_SPARCV9 objects.
752 EF_SPARCV9_MM = 0x3,
753 EF_SPARCV9_TSO = 0x0,
754 EF_SPARCV9_PSO = 0x1,
755 EF_SPARCV9_RMO = 0x2,
756 };
757
758 // ELF Relocation type for Sparc.
759 enum {
760 #include "ELFRelocs/Sparc.def"
761 };
762
763 // AMDGPU specific e_flags.
764 enum : unsigned {
765 // Processor selection mask for EF_AMDGPU_MACH_* values.
766 EF_AMDGPU_MACH = 0x0ff,
767
768 // Not specified processor.
769 EF_AMDGPU_MACH_NONE = 0x000,
770
771 // R600-based processors.
772
773 // Radeon HD 2000/3000 Series (R600).
774 EF_AMDGPU_MACH_R600_R600 = 0x001,
775 EF_AMDGPU_MACH_R600_R630 = 0x002,
776 EF_AMDGPU_MACH_R600_RS880 = 0x003,
777 EF_AMDGPU_MACH_R600_RV670 = 0x004,
778 // Radeon HD 4000 Series (R700).
779 EF_AMDGPU_MACH_R600_RV710 = 0x005,
780 EF_AMDGPU_MACH_R600_RV730 = 0x006,
781 EF_AMDGPU_MACH_R600_RV770 = 0x007,
782 // Radeon HD 5000 Series (Evergreen).
783 EF_AMDGPU_MACH_R600_CEDAR = 0x008,
784 EF_AMDGPU_MACH_R600_CYPRESS = 0x009,
785 EF_AMDGPU_MACH_R600_JUNIPER = 0x00a,
786 EF_AMDGPU_MACH_R600_REDWOOD = 0x00b,
787 EF_AMDGPU_MACH_R600_SUMO = 0x00c,
788 // Radeon HD 6000 Series (Northern Islands).
789 EF_AMDGPU_MACH_R600_BARTS = 0x00d,
790 EF_AMDGPU_MACH_R600_CAICOS = 0x00e,
791 EF_AMDGPU_MACH_R600_CAYMAN = 0x00f,
792 EF_AMDGPU_MACH_R600_TURKS = 0x010,
793
794 // Reserved for R600-based processors.
795 EF_AMDGPU_MACH_R600_RESERVED_FIRST = 0x011,
796 EF_AMDGPU_MACH_R600_RESERVED_LAST = 0x01f,
797
798 // First/last R600-based processors.
799 EF_AMDGPU_MACH_R600_FIRST = EF_AMDGPU_MACH_R600_R600,
800 EF_AMDGPU_MACH_R600_LAST = EF_AMDGPU_MACH_R600_TURKS,
801
802 // AMDGCN-based processors.
803 // clang-format off
804 EF_AMDGPU_MACH_AMDGCN_GFX600 = 0x020,
805 EF_AMDGPU_MACH_AMDGCN_GFX601 = 0x021,
806 EF_AMDGPU_MACH_AMDGCN_GFX700 = 0x022,
807 EF_AMDGPU_MACH_AMDGCN_GFX701 = 0x023,
808 EF_AMDGPU_MACH_AMDGCN_GFX702 = 0x024,
809 EF_AMDGPU_MACH_AMDGCN_GFX703 = 0x025,
810 EF_AMDGPU_MACH_AMDGCN_GFX704 = 0x026,
811 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X27 = 0x027,
812 EF_AMDGPU_MACH_AMDGCN_GFX801 = 0x028,
813 EF_AMDGPU_MACH_AMDGCN_GFX802 = 0x029,
814 EF_AMDGPU_MACH_AMDGCN_GFX803 = 0x02a,
815 EF_AMDGPU_MACH_AMDGCN_GFX810 = 0x02b,
816 EF_AMDGPU_MACH_AMDGCN_GFX900 = 0x02c,
817 EF_AMDGPU_MACH_AMDGCN_GFX902 = 0x02d,
818 EF_AMDGPU_MACH_AMDGCN_GFX904 = 0x02e,
819 EF_AMDGPU_MACH_AMDGCN_GFX906 = 0x02f,
820 EF_AMDGPU_MACH_AMDGCN_GFX908 = 0x030,
821 EF_AMDGPU_MACH_AMDGCN_GFX909 = 0x031,
822 EF_AMDGPU_MACH_AMDGCN_GFX90C = 0x032,
823 EF_AMDGPU_MACH_AMDGCN_GFX1010 = 0x033,
824 EF_AMDGPU_MACH_AMDGCN_GFX1011 = 0x034,
825 EF_AMDGPU_MACH_AMDGCN_GFX1012 = 0x035,
826 EF_AMDGPU_MACH_AMDGCN_GFX1030 = 0x036,
827 EF_AMDGPU_MACH_AMDGCN_GFX1031 = 0x037,
828 EF_AMDGPU_MACH_AMDGCN_GFX1032 = 0x038,
829 EF_AMDGPU_MACH_AMDGCN_GFX1033 = 0x039,
830 EF_AMDGPU_MACH_AMDGCN_GFX602 = 0x03a,
831 EF_AMDGPU_MACH_AMDGCN_GFX705 = 0x03b,
832 EF_AMDGPU_MACH_AMDGCN_GFX805 = 0x03c,
833 EF_AMDGPU_MACH_AMDGCN_GFX1035 = 0x03d,
834 EF_AMDGPU_MACH_AMDGCN_GFX1034 = 0x03e,
835 EF_AMDGPU_MACH_AMDGCN_GFX90A = 0x03f,
836 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X40 = 0x040,
837 EF_AMDGPU_MACH_AMDGCN_GFX1100 = 0x041,
838 EF_AMDGPU_MACH_AMDGCN_GFX1013 = 0x042,
839 EF_AMDGPU_MACH_AMDGCN_GFX1150 = 0x043,
840 EF_AMDGPU_MACH_AMDGCN_GFX1103 = 0x044,
841 EF_AMDGPU_MACH_AMDGCN_GFX1036 = 0x045,
842 EF_AMDGPU_MACH_AMDGCN_GFX1101 = 0x046,
843 EF_AMDGPU_MACH_AMDGCN_GFX1102 = 0x047,
844 EF_AMDGPU_MACH_AMDGCN_GFX1200 = 0x048,
845 EF_AMDGPU_MACH_AMDGCN_GFX1250 = 0x049,
846 EF_AMDGPU_MACH_AMDGCN_GFX1151 = 0x04a,
847 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X4B = 0x04b,
848 EF_AMDGPU_MACH_AMDGCN_GFX942 = 0x04c,
849 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X4D = 0x04d,
850 EF_AMDGPU_MACH_AMDGCN_GFX1201 = 0x04e,
851 EF_AMDGPU_MACH_AMDGCN_GFX950 = 0x04f,
852 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X50 = 0x050,
853 EF_AMDGPU_MACH_AMDGCN_GFX9_GENERIC = 0x051,
854 EF_AMDGPU_MACH_AMDGCN_GFX10_1_GENERIC = 0x052,
855 EF_AMDGPU_MACH_AMDGCN_GFX10_3_GENERIC = 0x053,
856 EF_AMDGPU_MACH_AMDGCN_GFX11_GENERIC = 0x054,
857 EF_AMDGPU_MACH_AMDGCN_GFX1152 = 0x055,
858 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X56 = 0x056,
859 EF_AMDGPU_MACH_AMDGCN_RESERVED_0X57 = 0x057,
860 EF_AMDGPU_MACH_AMDGCN_GFX1153 = 0x058,
861 EF_AMDGPU_MACH_AMDGCN_GFX12_GENERIC = 0x059,
862 EF_AMDGPU_MACH_AMDGCN_GFX9_4_GENERIC = 0x05f,
863 // clang-format on
864
865 // First/last AMDGCN-based processors.
866 EF_AMDGPU_MACH_AMDGCN_FIRST = EF_AMDGPU_MACH_AMDGCN_GFX600,
867 EF_AMDGPU_MACH_AMDGCN_LAST = EF_AMDGPU_MACH_AMDGCN_GFX9_4_GENERIC,
868
869 // Indicates if the "xnack" target feature is enabled for all code contained
870 // in the object.
871 //
872 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V2.
873 EF_AMDGPU_FEATURE_XNACK_V2 = 0x01,
874 // Indicates if the trap handler is enabled for all code contained
875 // in the object.
876 //
877 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V2.
878 EF_AMDGPU_FEATURE_TRAP_HANDLER_V2 = 0x02,
879
880 // Indicates if the "xnack" target feature is enabled for all code contained
881 // in the object.
882 //
883 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V3.
884 EF_AMDGPU_FEATURE_XNACK_V3 = 0x100,
885 // Indicates if the "sramecc" target feature is enabled for all code
886 // contained in the object.
887 //
888 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V3.
889 EF_AMDGPU_FEATURE_SRAMECC_V3 = 0x200,
890
891 // XNACK selection mask for EF_AMDGPU_FEATURE_XNACK_* values.
892 //
893 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V4.
894 EF_AMDGPU_FEATURE_XNACK_V4 = 0x300,
895 // XNACK is not supported.
896 EF_AMDGPU_FEATURE_XNACK_UNSUPPORTED_V4 = 0x000,
897 // XNACK is any/default/unspecified.
898 EF_AMDGPU_FEATURE_XNACK_ANY_V4 = 0x100,
899 // XNACK is off.
900 EF_AMDGPU_FEATURE_XNACK_OFF_V4 = 0x200,
901 // XNACK is on.
902 EF_AMDGPU_FEATURE_XNACK_ON_V4 = 0x300,
903
904 // SRAMECC selection mask for EF_AMDGPU_FEATURE_SRAMECC_* values.
905 //
906 // Only valid for ELFOSABI_AMDGPU_HSA and ELFABIVERSION_AMDGPU_HSA_V4.
907 EF_AMDGPU_FEATURE_SRAMECC_V4 = 0xc00,
908 // SRAMECC is not supported.
909 EF_AMDGPU_FEATURE_SRAMECC_UNSUPPORTED_V4 = 0x000,
910 // SRAMECC is any/default/unspecified.
911 EF_AMDGPU_FEATURE_SRAMECC_ANY_V4 = 0x400,
912 // SRAMECC is off.
913 EF_AMDGPU_FEATURE_SRAMECC_OFF_V4 = 0x800,
914 // SRAMECC is on.
915 EF_AMDGPU_FEATURE_SRAMECC_ON_V4 = 0xc00,
916
917 // Generic target versioning. This is contained in the list byte of EFLAGS.
918 EF_AMDGPU_GENERIC_VERSION = 0xff000000,
919 EF_AMDGPU_GENERIC_VERSION_OFFSET = 24,
920 EF_AMDGPU_GENERIC_VERSION_MIN = 1,
921 EF_AMDGPU_GENERIC_VERSION_MAX = 0xff,
922 };
923
924 // ELF Relocation types for AMDGPU
925 enum {
926 #include "ELFRelocs/AMDGPU.def"
927 };
928
929 // NVPTX specific e_flags.
930 enum : unsigned {
931 // Processor selection mask for EF_CUDA_SM* values prior to blackwell.
932 EF_CUDA_SM = 0xff,
933
934 // Processor selection mask for EF_CUDA_SM* values following blackwell.
935 EF_CUDA_SM_MASK = 0xff00,
936
937 // Processor selection mask for EF_CUDA_SM* values following blackwell.
938 EF_CUDA_SM_OFFSET = 8,
939
940 // SM based processor values.
941 EF_CUDA_SM20 = 0x14,
942 EF_CUDA_SM21 = 0x15,
943 EF_CUDA_SM30 = 0x1e,
944 EF_CUDA_SM32 = 0x20,
945 EF_CUDA_SM35 = 0x23,
946 EF_CUDA_SM37 = 0x25,
947 EF_CUDA_SM50 = 0x32,
948 EF_CUDA_SM52 = 0x34,
949 EF_CUDA_SM53 = 0x35,
950 EF_CUDA_SM60 = 0x3c,
951 EF_CUDA_SM61 = 0x3d,
952 EF_CUDA_SM62 = 0x3e,
953 EF_CUDA_SM70 = 0x46,
954 EF_CUDA_SM72 = 0x48,
955 EF_CUDA_SM75 = 0x4b,
956 EF_CUDA_SM80 = 0x50,
957 EF_CUDA_SM86 = 0x56,
958 EF_CUDA_SM87 = 0x57,
959 EF_CUDA_SM88 = 0x58,
960 EF_CUDA_SM89 = 0x59,
961 EF_CUDA_SM90 = 0x5a,
962 EF_CUDA_SM100 = 0x64,
963 EF_CUDA_SM101 = 0x65,
964 EF_CUDA_SM103 = 0x67,
965 EF_CUDA_SM110 = 0x6e,
966 EF_CUDA_SM120 = 0x78,
967 EF_CUDA_SM121 = 0x79,
968
969 // Unified texture binding is enabled.
970 EF_CUDA_TEXMODE_UNIFIED = 0x100,
971 // Independent texture binding is enabled.
972 EF_CUDA_TEXMODE_INDEPENDANT = 0x200,
973 // The target is using 64-bit addressing.
974 EF_CUDA_64BIT_ADDRESS = 0x400,
975 // Set when using the sm_90a processor.
976 EF_CUDA_ACCELERATORS_V1 = 0x800,
977 // Undocumented software feature.
978 EF_CUDA_SW_FLAG_V2 = 0x1000,
979
980 // Virtual processor selection mask for EF_CUDA_VIRTUAL_SM* values.
981 EF_CUDA_VIRTUAL_SM = 0xff0000,
982
983 // Set when using an accelerator variant like sm_100a.
984 EF_CUDA_ACCELERATORS = 0x8,
985 };
986
987 // ELF Relocation types for BPF
988 enum {
989 #include "ELFRelocs/BPF.def"
990 };
991
992 // ELF Relocation types for M68k
993 enum {
994 #include "ELFRelocs/M68k.def"
995 };
996
997 // MSP430 specific e_flags
998 enum : unsigned {
999 EF_MSP430_MACH_MSP430x11 = 11,
1000 EF_MSP430_MACH_MSP430x11x1 = 110,
1001 EF_MSP430_MACH_MSP430x12 = 12,
1002 EF_MSP430_MACH_MSP430x13 = 13,
1003 EF_MSP430_MACH_MSP430x14 = 14,
1004 EF_MSP430_MACH_MSP430x15 = 15,
1005 EF_MSP430_MACH_MSP430x16 = 16,
1006 EF_MSP430_MACH_MSP430x20 = 20,
1007 EF_MSP430_MACH_MSP430x22 = 22,
1008 EF_MSP430_MACH_MSP430x23 = 23,
1009 EF_MSP430_MACH_MSP430x24 = 24,
1010 EF_MSP430_MACH_MSP430x26 = 26,
1011 EF_MSP430_MACH_MSP430x31 = 31,
1012 EF_MSP430_MACH_MSP430x32 = 32,
1013 EF_MSP430_MACH_MSP430x33 = 33,
1014 EF_MSP430_MACH_MSP430x41 = 41,
1015 EF_MSP430_MACH_MSP430x42 = 42,
1016 EF_MSP430_MACH_MSP430x43 = 43,
1017 EF_MSP430_MACH_MSP430x44 = 44,
1018 EF_MSP430_MACH_MSP430X = 45,
1019 EF_MSP430_MACH_MSP430x46 = 46,
1020 EF_MSP430_MACH_MSP430x47 = 47,
1021 EF_MSP430_MACH_MSP430x54 = 54,
1022 };
1023
1024 // ELF Relocation types for MSP430
1025 enum {
1026 #include "ELFRelocs/MSP430.def"
1027 };
1028
1029 // ELF Relocation type for VE.
1030 enum {
1031 #include "ELFRelocs/VE.def"
1032 };
1033
1034 // CSKY Specific e_flags
1035 enum : unsigned {
1036 EF_CSKY_801 = 0xa,
1037 EF_CSKY_802 = 0x10,
1038 EF_CSKY_803 = 0x9,
1039 EF_CSKY_805 = 0x11,
1040 EF_CSKY_807 = 0x6,
1041 EF_CSKY_810 = 0x8,
1042 EF_CSKY_860 = 0xb,
1043 EF_CSKY_800 = 0x1f,
1044 EF_CSKY_FLOAT = 0x2000,
1045 EF_CSKY_DSP = 0x4000,
1046 EF_CSKY_ABIV2 = 0x20000000,
1047 EF_CSKY_EFV1 = 0x1000000,
1048 EF_CSKY_EFV2 = 0x2000000,
1049 EF_CSKY_EFV3 = 0x3000000
1050 };
1051
1052 // ELF Relocation types for CSKY
1053 enum {
1054 #include "ELFRelocs/CSKY.def"
1055 };
1056
1057 // LoongArch Specific e_flags
1058 enum : unsigned {
1059 // Definitions from LoongArch ELF psABI v2.01.
1060 // Reference: https://github.com/loongson/LoongArch-Documentation
1061 // (commit hash 296de4def055c871809068e0816325a4ac04eb12)
1062
1063 // Base ABI Modifiers
1064 EF_LOONGARCH_ABI_SOFT_FLOAT = 0x1,
1065 EF_LOONGARCH_ABI_SINGLE_FLOAT = 0x2,
1066 EF_LOONGARCH_ABI_DOUBLE_FLOAT = 0x3,
1067 EF_LOONGARCH_ABI_MODIFIER_MASK = 0x7,
1068
1069 // Object file ABI versions
1070 EF_LOONGARCH_OBJABI_V0 = 0x0,
1071 EF_LOONGARCH_OBJABI_V1 = 0x40,
1072 EF_LOONGARCH_OBJABI_MASK = 0xC0,
1073 };
1074
1075 // ELF Relocation types for LoongArch
1076 enum {
1077 #include "ELFRelocs/LoongArch.def"
1078 };
1079
1080 // Xtensa specific e_flags
1081 enum : unsigned {
1082 // Four-bit Xtensa machine type mask.
1083 EF_XTENSA_MACH = 0x0000000f,
1084 // Various CPU types.
1085 EF_XTENSA_MACH_NONE = 0x00000000, // A base Xtensa implementation
1086 EF_XTENSA_XT_INSN = 0x00000100,
1087 EF_XTENSA_XT_LIT = 0x00000200,
1088 };
1089
1090 // ELF Relocation types for Xtensa
1091 enum {
1092 #include "ELFRelocs/Xtensa.def"
1093 };
1094
1095 #undef ELF_RELOC
1096
1097 // Section header.
1098 struct Elf32_Shdr {
1099 Elf32_Word sh_name; // Section name (index into string table)
1100 Elf32_Word sh_type; // Section type (SHT_*)
1101 Elf32_Word sh_flags; // Section flags (SHF_*)
1102 Elf32_Addr sh_addr; // Address where section is to be loaded
1103 Elf32_Off sh_offset; // File offset of section data, in bytes
1104 Elf32_Word sh_size; // Size of section, in bytes
1105 Elf32_Word sh_link; // Section type-specific header table index link
1106 Elf32_Word sh_info; // Section type-specific extra information
1107 Elf32_Word sh_addralign; // Section address alignment
1108 Elf32_Word sh_entsize; // Size of records contained within the section
1109 };
1110
1111 // Section header for ELF64 - same fields as ELF32, different types.
1112 struct Elf64_Shdr {
1113 Elf64_Word sh_name;
1114 Elf64_Word sh_type;
1115 Elf64_Xword sh_flags;
1116 Elf64_Addr sh_addr;
1117 Elf64_Off sh_offset;
1118 Elf64_Xword sh_size;
1119 Elf64_Word sh_link;
1120 Elf64_Word sh_info;
1121 Elf64_Xword sh_addralign;
1122 Elf64_Xword sh_entsize;
1123 };
1124
1125 // Special section indices.
1126 enum {
1127 SHN_UNDEF = 0, // Undefined, missing, irrelevant, or meaningless
1128 SHN_LORESERVE = 0xff00, // Lowest reserved index
1129 SHN_LOPROC = 0xff00, // Lowest processor-specific index
1130 SHN_HIPROC = 0xff1f, // Highest processor-specific index
1131 SHN_LOOS = 0xff20, // Lowest operating system-specific index
1132 SHN_HIOS = 0xff3f, // Highest operating system-specific index
1133 SHN_ABS = 0xfff1, // Symbol has absolute value; does not need relocation
1134 SHN_COMMON = 0xfff2, // FORTRAN COMMON or C external global variables
1135 SHN_XINDEX = 0xffff, // Mark that the index is >= SHN_LORESERVE
1136 SHN_HIRESERVE = 0xffff // Highest reserved index
1137 };
1138
1139 // Section types.
1140 enum : unsigned {
1141 SHT_NULL = 0, // No associated section (inactive entry).
1142 SHT_PROGBITS = 1, // Program-defined contents.
1143 SHT_SYMTAB = 2, // Symbol table.
1144 SHT_STRTAB = 3, // String table.
1145 SHT_RELA = 4, // Relocation entries; explicit addends.
1146 SHT_HASH = 5, // Symbol hash table.
1147 SHT_DYNAMIC = 6, // Information for dynamic linking.
1148 SHT_NOTE = 7, // Information about the file.
1149 SHT_NOBITS = 8, // Data occupies no space in the file.
1150 SHT_REL = 9, // Relocation entries; no explicit addends.
1151 SHT_SHLIB = 10, // Reserved.
1152 SHT_DYNSYM = 11, // Symbol table.
1153 SHT_INIT_ARRAY = 14, // Pointers to initialization functions.
1154 SHT_FINI_ARRAY = 15, // Pointers to termination functions.
1155 SHT_PREINIT_ARRAY = 16, // Pointers to pre-init functions.
1156 SHT_GROUP = 17, // Section group.
1157 SHT_SYMTAB_SHNDX = 18, // Indices for SHN_XINDEX entries.
1158 // Experimental support for SHT_RELR sections. For details, see proposal
1159 // at https://groups.google.com/forum/#!topic/generic-abi/bX460iggiKg
1160 SHT_RELR = 19, // Relocation entries; only offsets.
1161 // TODO: Experimental CREL relocations. LLVM will change the value and
1162 // break compatibility in the future.
1163 SHT_CREL = 0x40000014,
1164 SHT_LOOS = 0x60000000, // Lowest operating system-specific type.
1165 // Android packed relocation section types.
1166 // https://android.googlesource.com/platform/bionic/+/6f12bfece5dcc01325e0abba56a46b1bcf991c69/tools/relocation_packer/src/elf_file.cc#37
1167 SHT_ANDROID_REL = 0x60000001,
1168 SHT_ANDROID_RELA = 0x60000002,
1169 SHT_LLVM_ODRTAB = 0x6fff4c00, // LLVM ODR table.
1170 SHT_LLVM_LINKER_OPTIONS = 0x6fff4c01, // LLVM Linker Options.
1171 SHT_LLVM_ADDRSIG = 0x6fff4c03, // List of address-significant symbols
1172 // for safe ICF.
1173 SHT_LLVM_DEPENDENT_LIBRARIES =
1174 0x6fff4c04, // LLVM Dependent Library Specifiers.
1175 SHT_LLVM_SYMPART = 0x6fff4c05, // Symbol partition specification.
1176 SHT_LLVM_PART_EHDR = 0x6fff4c06, // ELF header for loadable partition.
1177 SHT_LLVM_PART_PHDR = 0x6fff4c07, // Phdrs for loadable partition.
1178 // SHT_LLVM_BB_ADDR_MAP_V0 = 0x6fff4c08, // Do not use.
1179 SHT_LLVM_CALL_GRAPH_PROFILE = 0x6fff4c09, // LLVM Call Graph Profile.
1180 SHT_LLVM_BB_ADDR_MAP = 0x6fff4c0a, // LLVM Basic Block Address Map.
1181 SHT_LLVM_OFFLOADING = 0x6fff4c0b, // LLVM device offloading data.
1182 SHT_LLVM_LTO = 0x6fff4c0c, // .llvm.lto for fat LTO.
1183 SHT_LLVM_JT_SIZES = 0x6fff4c0d, // LLVM jump tables sizes.
1184 // Android's experimental support for SHT_RELR sections.
1185 // https://android.googlesource.com/platform/bionic/+/b7feec74547f84559a1467aca02708ff61346d2a/libc/include/elf.h#512
1186 SHT_ANDROID_RELR = 0x6fffff00, // Relocation entries; only offsets.
1187 SHT_GNU_ATTRIBUTES = 0x6ffffff5, // Object attributes.
1188 SHT_GNU_HASH = 0x6ffffff6, // GNU-style hash table.
1189 SHT_GNU_verdef = 0x6ffffffd, // GNU version definitions.
1190 SHT_GNU_verneed = 0x6ffffffe, // GNU version references.
1191 SHT_GNU_versym = 0x6fffffff, // GNU symbol versions table.
1192 SHT_HIOS = 0x6fffffff, // Highest operating system-specific type.
1193 SHT_LOPROC = 0x70000000, // Lowest processor arch-specific type.
1194 // Fixme: All this is duplicated in MCSectionELF. Why??
1195 // Exception Index table
1196 SHT_ARM_EXIDX = 0x70000001U,
1197 // BPABI DLL dynamic linking pre-emption map
1198 SHT_ARM_PREEMPTMAP = 0x70000002U,
1199 // Object file compatibility attributes
1200 SHT_ARM_ATTRIBUTES = 0x70000003U,
1201 SHT_ARM_DEBUGOVERLAY = 0x70000004U,
1202 SHT_ARM_OVERLAYSECTION = 0x70000005U,
1203 // Support for AArch64 build attributes
1204 SHT_AARCH64_ATTRIBUTES = 0x70000003U,
1205 // Special aarch64-specific section for MTE support, as described in:
1206 // https://github.com/ARM-software/abi-aa/blob/main/pauthabielf64/pauthabielf64.rst#section-types
1207 SHT_AARCH64_AUTH_RELR = 0x70000004U,
1208 // Special aarch64-specific sections for MTE support, as described in:
1209 // https://github.com/ARM-software/abi-aa/blob/main/memtagabielf64/memtagabielf64.rst#7section-types
1210 SHT_AARCH64_MEMTAG_GLOBALS_STATIC = 0x70000007U,
1211 SHT_AARCH64_MEMTAG_GLOBALS_DYNAMIC = 0x70000008U,
1212 SHT_HEX_ORDERED = 0x70000000, // Link editor is to sort the entries in
1213 // this section based on their sizes
1214 SHT_X86_64_UNWIND = 0x70000001, // Unwind information
1215
1216 SHT_MIPS_REGINFO = 0x70000006, // Register usage information
1217 SHT_MIPS_OPTIONS = 0x7000000d, // General options
1218 SHT_MIPS_DWARF = 0x7000001e, // DWARF debugging section.
1219 SHT_MIPS_ABIFLAGS = 0x7000002a, // ABI information.
1220
1221 SHT_MSP430_ATTRIBUTES = 0x70000003U,
1222
1223 SHT_RISCV_ATTRIBUTES = 0x70000003U,
1224
1225 SHT_CSKY_ATTRIBUTES = 0x70000001U,
1226
1227 SHT_HEXAGON_ATTRIBUTES = 0x70000003U,
1228
1229 SHT_HIPROC = 0x7fffffff, // Highest processor arch-specific type.
1230 SHT_LOUSER = 0x80000000, // Lowest type reserved for applications.
1231 SHT_HIUSER = 0xffffffff // Highest type reserved for applications.
1232 };
1233
1234 // Section flags.
1235 enum : unsigned {
1236 // Section data should be writable during execution.
1237 SHF_WRITE = 0x1,
1238
1239 // Section occupies memory during program execution.
1240 SHF_ALLOC = 0x2,
1241
1242 // Section contains executable machine instructions.
1243 SHF_EXECINSTR = 0x4,
1244
1245 // The data in this section may be merged.
1246 SHF_MERGE = 0x10,
1247
1248 // The data in this section is null-terminated strings.
1249 SHF_STRINGS = 0x20,
1250
1251 // A field in this section holds a section header table index.
1252 SHF_INFO_LINK = 0x40U,
1253
1254 // Adds special ordering requirements for link editors.
1255 SHF_LINK_ORDER = 0x80U,
1256
1257 // This section requires special OS-specific processing to avoid incorrect
1258 // behavior.
1259 SHF_OS_NONCONFORMING = 0x100U,
1260
1261 // This section is a member of a section group.
1262 SHF_GROUP = 0x200U,
1263
1264 // This section holds Thread-Local Storage.
1265 SHF_TLS = 0x400U,
1266
1267 // Identifies a section containing compressed data.
1268 SHF_COMPRESSED = 0x800U,
1269
1270 // This section should not be garbage collected by the linker.
1271 SHF_GNU_RETAIN = 0x200000,
1272
1273 // This section is excluded from the final executable or shared library.
1274 SHF_EXCLUDE = 0x80000000U,
1275
1276 // Start of target-specific flags.
1277
1278 SHF_MASKOS = 0x0ff00000,
1279
1280 // Solaris equivalent of SHF_GNU_RETAIN.
1281 SHF_SUNW_NODISCARD = 0x00100000,
1282
1283 // Bits indicating processor-specific flags.
1284 SHF_MASKPROC = 0xf0000000,
1285
1286 /// All sections with the "d" flag are grouped together by the linker to form
1287 /// the data section and the dp register is set to the start of the section by
1288 /// the boot code.
1289 XCORE_SHF_DP_SECTION = 0x10000000,
1290
1291 /// All sections with the "c" flag are grouped together by the linker to form
1292 /// the constant pool and the cp register is set to the start of the constant
1293 /// pool by the boot code.
1294 XCORE_SHF_CP_SECTION = 0x20000000,
1295
1296 // If an object file section does not have this flag set, then it may not hold
1297 // more than 2GB and can be freely referred to in objects using smaller code
1298 // models. Otherwise, only objects using larger code models can refer to them.
1299 // For example, a medium code model object can refer to data in a section that
1300 // sets this flag besides being able to refer to data in a section that does
1301 // not set it; likewise, a small code model object can refer only to code in a
1302 // section that does not set this flag.
1303 SHF_X86_64_LARGE = 0x10000000,
1304
1305 // All sections with the GPREL flag are grouped into a global data area
1306 // for faster accesses
1307 SHF_HEX_GPREL = 0x10000000,
1308
1309 // Section contains text/data which may be replicated in other sections.
1310 // Linker must retain only one copy.
1311 SHF_MIPS_NODUPES = 0x01000000,
1312
1313 // Linker must generate implicit hidden weak names.
1314 SHF_MIPS_NAMES = 0x02000000,
1315
1316 // Section data local to process.
1317 SHF_MIPS_LOCAL = 0x04000000,
1318
1319 // Do not strip this section.
1320 SHF_MIPS_NOSTRIP = 0x08000000,
1321
1322 // Section must be part of global data area.
1323 SHF_MIPS_GPREL = 0x10000000,
1324
1325 // This section should be merged.
1326 SHF_MIPS_MERGE = 0x20000000,
1327
1328 // Address size to be inferred from section entry size.
1329 SHF_MIPS_ADDR = 0x40000000,
1330
1331 // Section data is string data by default.
1332 SHF_MIPS_STRING = 0x80000000,
1333
1334 // Section contains only program instructions and no program data.
1335 SHF_ARM_PURECODE = 0x20000000,
1336
1337 // Section contains only program instructions and no program data.
1338 SHF_AARCH64_PURECODE = 0x20000000
1339 };
1340
1341 // Section Group Flags
1342 enum : unsigned {
1343 GRP_COMDAT = 0x1,
1344 GRP_MASKOS = 0x0ff00000,
1345 GRP_MASKPROC = 0xf0000000
1346 };
1347
1348 // Symbol table entries for ELF32.
1349 struct Elf32_Sym {
1350 Elf32_Word st_name; // Symbol name (index into string table)
1351 Elf32_Addr st_value; // Value or address associated with the symbol
1352 Elf32_Word st_size; // Size of the symbol
1353 unsigned char st_info; // Symbol's type and binding attributes
1354 unsigned char st_other; // Must be zero; reserved
1355 Elf32_Half st_shndx; // Which section (header table index) it's defined in
1356
1357 // These accessors and mutators correspond to the ELF32_ST_BIND,
1358 // ELF32_ST_TYPE, and ELF32_ST_INFO macros defined in the ELF specification:
getBindingElf32_Sym1359 unsigned char getBinding() const { return st_info >> 4; }
getTypeElf32_Sym1360 unsigned char getType() const { return st_info & 0x0f; }
setBindingElf32_Sym1361 void setBinding(unsigned char b) { setBindingAndType(b, getType()); }
setTypeElf32_Sym1362 void setType(unsigned char t) { setBindingAndType(getBinding(), t); }
setBindingAndTypeElf32_Sym1363 void setBindingAndType(unsigned char b, unsigned char t) {
1364 st_info = (b << 4) + (t & 0x0f);
1365 }
1366 };
1367
1368 // Symbol table entries for ELF64.
1369 struct Elf64_Sym {
1370 Elf64_Word st_name; // Symbol name (index into string table)
1371 unsigned char st_info; // Symbol's type and binding attributes
1372 unsigned char st_other; // Must be zero; reserved
1373 Elf64_Half st_shndx; // Which section (header tbl index) it's defined in
1374 Elf64_Addr st_value; // Value or address associated with the symbol
1375 Elf64_Xword st_size; // Size of the symbol
1376
1377 // These accessors and mutators are identical to those defined for ELF32
1378 // symbol table entries.
getBindingElf64_Sym1379 unsigned char getBinding() const { return st_info >> 4; }
getTypeElf64_Sym1380 unsigned char getType() const { return st_info & 0x0f; }
setBindingElf64_Sym1381 void setBinding(unsigned char b) { setBindingAndType(b, getType()); }
setTypeElf64_Sym1382 void setType(unsigned char t) { setBindingAndType(getBinding(), t); }
setBindingAndTypeElf64_Sym1383 void setBindingAndType(unsigned char b, unsigned char t) {
1384 st_info = (b << 4) + (t & 0x0f);
1385 }
1386 };
1387
1388 // The size (in bytes) of symbol table entries.
1389 enum {
1390 SYMENTRY_SIZE32 = 16, // 32-bit symbol entry size
1391 SYMENTRY_SIZE64 = 24 // 64-bit symbol entry size.
1392 };
1393
1394 // Symbol bindings.
1395 enum {
1396 STB_LOCAL = 0, // Local symbol, not visible outside obj file containing def
1397 STB_GLOBAL = 1, // Global symbol, visible to all object files being combined
1398 STB_WEAK = 2, // Weak symbol, like global but lower-precedence
1399 STB_GNU_UNIQUE = 10,
1400 STB_LOOS = 10, // Lowest operating system-specific binding type
1401 STB_HIOS = 12, // Highest operating system-specific binding type
1402 STB_LOPROC = 13, // Lowest processor-specific binding type
1403 STB_HIPROC = 15 // Highest processor-specific binding type
1404 };
1405
1406 // Symbol types.
1407 enum {
1408 STT_NOTYPE = 0, // Symbol's type is not specified
1409 STT_OBJECT = 1, // Symbol is a data object (variable, array, etc.)
1410 STT_FUNC = 2, // Symbol is executable code (function, etc.)
1411 STT_SECTION = 3, // Symbol refers to a section
1412 STT_FILE = 4, // Local, absolute symbol that refers to a file
1413 STT_COMMON = 5, // An uninitialized common block
1414 STT_TLS = 6, // Thread local data object
1415 STT_GNU_IFUNC = 10, // GNU indirect function
1416 STT_LOOS = 10, // Lowest operating system-specific symbol type
1417 STT_HIOS = 12, // Highest operating system-specific symbol type
1418 STT_LOPROC = 13, // Lowest processor-specific symbol type
1419 STT_HIPROC = 15, // Highest processor-specific symbol type
1420
1421 // AMDGPU symbol types
1422 STT_AMDGPU_HSA_KERNEL = 10
1423 };
1424
1425 enum {
1426 STV_DEFAULT = 0, // Visibility is specified by binding type
1427 STV_INTERNAL = 1, // Defined by processor supplements
1428 STV_HIDDEN = 2, // Not visible to other components
1429 STV_PROTECTED = 3 // Visible in other components but not preemptable
1430 };
1431
1432 // Symbol number.
1433 enum { STN_UNDEF = 0 };
1434
1435 // Special relocation symbols used in the MIPS64 ELF relocation entries
1436 enum {
1437 RSS_UNDEF = 0, // None
1438 RSS_GP = 1, // Value of gp
1439 RSS_GP0 = 2, // Value of gp used to create object being relocated
1440 RSS_LOC = 3 // Address of location being relocated
1441 };
1442
1443 // Relocation entry, without explicit addend.
1444 struct Elf32_Rel {
1445 Elf32_Addr r_offset; // Location (file byte offset, or program virtual addr)
1446 Elf32_Word r_info; // Symbol table index and type of relocation to apply
1447
1448 // These accessors and mutators correspond to the ELF32_R_SYM, ELF32_R_TYPE,
1449 // and ELF32_R_INFO macros defined in the ELF specification:
getSymbolElf32_Rel1450 Elf32_Word getSymbol() const { return (r_info >> 8); }
getTypeElf32_Rel1451 unsigned char getType() const { return (unsigned char)(r_info & 0x0ff); }
setSymbolElf32_Rel1452 void setSymbol(Elf32_Word s) { setSymbolAndType(s, getType()); }
setTypeElf32_Rel1453 void setType(unsigned char t) { setSymbolAndType(getSymbol(), t); }
setSymbolAndTypeElf32_Rel1454 void setSymbolAndType(Elf32_Word s, unsigned char t) {
1455 r_info = (s << 8) + t;
1456 }
1457 };
1458
1459 // Relocation entry with explicit addend.
1460 struct Elf32_Rela {
1461 Elf32_Addr r_offset; // Location (file byte offset, or program virtual addr)
1462 Elf32_Word r_info; // Symbol table index and type of relocation to apply
1463 Elf32_Sword r_addend; // Compute value for relocatable field by adding this
1464
1465 // These accessors and mutators correspond to the ELF32_R_SYM, ELF32_R_TYPE,
1466 // and ELF32_R_INFO macros defined in the ELF specification:
getSymbolElf32_Rela1467 Elf32_Word getSymbol() const { return (r_info >> 8); }
getTypeElf32_Rela1468 unsigned char getType() const { return (unsigned char)(r_info & 0x0ff); }
setSymbolElf32_Rela1469 void setSymbol(Elf32_Word s) { setSymbolAndType(s, getType()); }
setTypeElf32_Rela1470 void setType(unsigned char t) { setSymbolAndType(getSymbol(), t); }
setSymbolAndTypeElf32_Rela1471 void setSymbolAndType(Elf32_Word s, unsigned char t) {
1472 r_info = (s << 8) + t;
1473 }
1474 };
1475
1476 // Relocation entry without explicit addend or info (relative relocations only).
1477 typedef Elf32_Word Elf32_Relr; // offset/bitmap for relative relocations
1478
1479 // Relocation entry, without explicit addend.
1480 struct Elf64_Rel {
1481 Elf64_Addr r_offset; // Location (file byte offset, or program virtual addr).
1482 Elf64_Xword r_info; // Symbol table index and type of relocation to apply.
1483
1484 // These accessors and mutators correspond to the ELF64_R_SYM, ELF64_R_TYPE,
1485 // and ELF64_R_INFO macros defined in the ELF specification:
getSymbolElf64_Rel1486 Elf64_Word getSymbol() const { return (r_info >> 32); }
getTypeElf64_Rel1487 Elf64_Word getType() const { return (Elf64_Word)(r_info & 0xffffffffL); }
setSymbolElf64_Rel1488 void setSymbol(Elf64_Word s) { setSymbolAndType(s, getType()); }
setTypeElf64_Rel1489 void setType(Elf64_Word t) { setSymbolAndType(getSymbol(), t); }
setSymbolAndTypeElf64_Rel1490 void setSymbolAndType(Elf64_Word s, Elf64_Word t) {
1491 r_info = ((Elf64_Xword)s << 32) + (t & 0xffffffffL);
1492 }
1493 };
1494
1495 // Relocation entry with explicit addend.
1496 struct Elf64_Rela {
1497 Elf64_Addr r_offset; // Location (file byte offset, or program virtual addr).
1498 Elf64_Xword r_info; // Symbol table index and type of relocation to apply.
1499 Elf64_Sxword r_addend; // Compute value for relocatable field by adding this.
1500
1501 // These accessors and mutators correspond to the ELF64_R_SYM, ELF64_R_TYPE,
1502 // and ELF64_R_INFO macros defined in the ELF specification:
getSymbolElf64_Rela1503 Elf64_Word getSymbol() const { return (r_info >> 32); }
getTypeElf64_Rela1504 Elf64_Word getType() const { return (Elf64_Word)(r_info & 0xffffffffL); }
setSymbolElf64_Rela1505 void setSymbol(Elf64_Word s) { setSymbolAndType(s, getType()); }
setTypeElf64_Rela1506 void setType(Elf64_Word t) { setSymbolAndType(getSymbol(), t); }
setSymbolAndTypeElf64_Rela1507 void setSymbolAndType(Elf64_Word s, Elf64_Word t) {
1508 r_info = ((Elf64_Xword)s << 32) + (t & 0xffffffffL);
1509 }
1510 };
1511
1512 // In-memory representation of CREL. The serialized representation uses LEB128.
1513 template <bool Is64> struct Elf_Crel {
1514 std::conditional_t<Is64, uint64_t, uint32_t> r_offset;
1515 uint32_t r_symidx;
1516 uint32_t r_type;
1517 std::conditional_t<Is64, int64_t, int32_t> r_addend;
1518 };
1519
1520 // Relocation entry without explicit addend or info (relative relocations only).
1521 typedef Elf64_Xword Elf64_Relr; // offset/bitmap for relative relocations
1522
1523 // Program header for ELF32.
1524 struct Elf32_Phdr {
1525 Elf32_Word p_type; // Type of segment
1526 Elf32_Off p_offset; // File offset where segment is located, in bytes
1527 Elf32_Addr p_vaddr; // Virtual address of beginning of segment
1528 Elf32_Addr p_paddr; // Physical address of beginning of segment (OS-specific)
1529 Elf32_Word p_filesz; // Num. of bytes in file image of segment (may be zero)
1530 Elf32_Word p_memsz; // Num. of bytes in mem image of segment (may be zero)
1531 Elf32_Word p_flags; // Segment flags
1532 Elf32_Word p_align; // Segment alignment constraint
1533 };
1534
1535 // Program header for ELF64.
1536 struct Elf64_Phdr {
1537 Elf64_Word p_type; // Type of segment
1538 Elf64_Word p_flags; // Segment flags
1539 Elf64_Off p_offset; // File offset where segment is located, in bytes
1540 Elf64_Addr p_vaddr; // Virtual address of beginning of segment
1541 Elf64_Addr p_paddr; // Physical addr of beginning of segment (OS-specific)
1542 Elf64_Xword p_filesz; // Num. of bytes in file image of segment (may be zero)
1543 Elf64_Xword p_memsz; // Num. of bytes in mem image of segment (may be zero)
1544 Elf64_Xword p_align; // Segment alignment constraint
1545 };
1546
1547 // Segment types.
1548 enum {
1549 PT_NULL = 0, // Unused segment.
1550 PT_LOAD = 1, // Loadable segment.
1551 PT_DYNAMIC = 2, // Dynamic linking information.
1552 PT_INTERP = 3, // Interpreter pathname.
1553 PT_NOTE = 4, // Auxiliary information.
1554 PT_SHLIB = 5, // Reserved.
1555 PT_PHDR = 6, // The program header table itself.
1556 PT_TLS = 7, // The thread-local storage template.
1557 PT_LOOS = 0x60000000, // Lowest operating system-specific pt entry type.
1558 PT_HIOS = 0x6fffffff, // Highest operating system-specific pt entry type.
1559 PT_LOPROC = 0x70000000, // Lowest processor-specific program hdr entry type.
1560 PT_HIPROC = 0x7fffffff, // Highest processor-specific program hdr entry type.
1561
1562 // x86-64 program header types.
1563 // These all contain stack unwind tables.
1564 PT_GNU_EH_FRAME = 0x6474e550,
1565 PT_SUNW_EH_FRAME = 0x6474e550,
1566 PT_SUNW_UNWIND = 0x6464e550,
1567
1568 PT_GNU_STACK = 0x6474e551, // Indicates stack executability.
1569 PT_GNU_RELRO = 0x6474e552, // Read-only after relocation.
1570 PT_GNU_PROPERTY = 0x6474e553, // .note.gnu.property notes sections.
1571
1572 PT_OPENBSD_MUTABLE = 0x65a3dbe5, // Like bss, but not immutable.
1573 PT_OPENBSD_RANDOMIZE = 0x65a3dbe6, // Fill with random data.
1574 PT_OPENBSD_WXNEEDED = 0x65a3dbe7, // Program does W^X violations.
1575 PT_OPENBSD_NOBTCFI = 0x65a3dbe8, // Do not enforce branch target CFI.
1576 PT_OPENBSD_SYSCALLS = 0x65a3dbe9, // System call sites.
1577 PT_OPENBSD_BOOTDATA = 0x65a41be6, // Section for boot arguments.
1578
1579 // ARM program header types.
1580 PT_ARM_ARCHEXT = 0x70000000, // Platform architecture compatibility info
1581 // These all contain stack unwind tables.
1582 PT_ARM_EXIDX = 0x70000001,
1583 PT_ARM_UNWIND = 0x70000001,
1584 // MTE memory tag segment type
1585 PT_AARCH64_MEMTAG_MTE = 0x70000002,
1586
1587 // MIPS program header types.
1588 PT_MIPS_REGINFO = 0x70000000, // Register usage information.
1589 PT_MIPS_RTPROC = 0x70000001, // Runtime procedure table.
1590 PT_MIPS_OPTIONS = 0x70000002, // Options segment.
1591 PT_MIPS_ABIFLAGS = 0x70000003, // Abiflags segment.
1592
1593 // RISCV program header types.
1594 PT_RISCV_ATTRIBUTES = 0x70000003,
1595 };
1596
1597 // Segment flag bits.
1598 enum : unsigned {
1599 PF_X = 1, // Execute
1600 PF_W = 2, // Write
1601 PF_R = 4, // Read
1602 PF_MASKOS = 0x0ff00000, // Bits for operating system-specific semantics.
1603 PF_MASKPROC = 0xf0000000 // Bits for processor-specific semantics.
1604 };
1605
1606 // Dynamic table entry for ELF32.
1607 struct Elf32_Dyn {
1608 Elf32_Sword d_tag; // Type of dynamic table entry.
1609 union {
1610 Elf32_Word d_val; // Integer value of entry.
1611 Elf32_Addr d_ptr; // Pointer value of entry.
1612 } d_un;
1613 };
1614
1615 // Dynamic table entry for ELF64.
1616 struct Elf64_Dyn {
1617 Elf64_Sxword d_tag; // Type of dynamic table entry.
1618 union {
1619 Elf64_Xword d_val; // Integer value of entry.
1620 Elf64_Addr d_ptr; // Pointer value of entry.
1621 } d_un;
1622 };
1623
1624 // Dynamic table entry tags.
1625 enum {
1626 #define DYNAMIC_TAG(name, value) DT_##name = value,
1627 #include "DynamicTags.def"
1628 #undef DYNAMIC_TAG
1629 };
1630
1631 // DT_FLAGS values.
1632 enum {
1633 DF_ORIGIN = 0x01, // The object may reference $ORIGIN.
1634 DF_SYMBOLIC = 0x02, // Search the shared lib before searching the exe.
1635 DF_TEXTREL = 0x04, // Relocations may modify a non-writable segment.
1636 DF_BIND_NOW = 0x08, // Process all relocations on load.
1637 DF_STATIC_TLS = 0x10 // Reject attempts to load dynamically.
1638 };
1639
1640 // State flags selectable in the `d_un.d_val' element of the DT_FLAGS_1 entry.
1641 enum {
1642 DF_1_NOW = 0x00000001, // Set RTLD_NOW for this object.
1643 DF_1_GLOBAL = 0x00000002, // Set RTLD_GLOBAL for this object.
1644 DF_1_GROUP = 0x00000004, // Set RTLD_GROUP for this object.
1645 DF_1_NODELETE = 0x00000008, // Set RTLD_NODELETE for this object.
1646 DF_1_LOADFLTR = 0x00000010, // Trigger filtee loading at runtime.
1647 DF_1_INITFIRST = 0x00000020, // Set RTLD_INITFIRST for this object.
1648 DF_1_NOOPEN = 0x00000040, // Set RTLD_NOOPEN for this object.
1649 DF_1_ORIGIN = 0x00000080, // $ORIGIN must be handled.
1650 DF_1_DIRECT = 0x00000100, // Direct binding enabled.
1651 DF_1_TRANS = 0x00000200,
1652 DF_1_INTERPOSE = 0x00000400, // Object is used to interpose.
1653 DF_1_NODEFLIB = 0x00000800, // Ignore default lib search path.
1654 DF_1_NODUMP = 0x00001000, // Object can't be dldump'ed.
1655 DF_1_CONFALT = 0x00002000, // Configuration alternative created.
1656 DF_1_ENDFILTEE = 0x00004000, // Filtee terminates filters search.
1657 DF_1_DISPRELDNE = 0x00008000, // Disp reloc applied at build time.
1658 DF_1_DISPRELPND = 0x00010000, // Disp reloc applied at run-time.
1659 DF_1_NODIRECT = 0x00020000, // Object has no-direct binding.
1660 DF_1_IGNMULDEF = 0x00040000,
1661 DF_1_NOKSYMS = 0x00080000,
1662 DF_1_NOHDR = 0x00100000,
1663 DF_1_EDITED = 0x00200000, // Object is modified after built.
1664 DF_1_NORELOC = 0x00400000,
1665 DF_1_SYMINTPOSE = 0x00800000, // Object has individual interposers.
1666 DF_1_GLOBAUDIT = 0x01000000, // Global auditing required.
1667 DF_1_SINGLETON = 0x02000000, // Singleton symbols are used.
1668 DF_1_PIE = 0x08000000, // Object is a position-independent executable.
1669 };
1670
1671 // DT_MIPS_FLAGS values.
1672 enum {
1673 RHF_NONE = 0x00000000, // No flags.
1674 RHF_QUICKSTART = 0x00000001, // Uses shortcut pointers.
1675 RHF_NOTPOT = 0x00000002, // Hash size is not a power of two.
1676 RHS_NO_LIBRARY_REPLACEMENT = 0x00000004, // Ignore LD_LIBRARY_PATH.
1677 RHF_NO_MOVE = 0x00000008, // DSO address may not be relocated.
1678 RHF_SGI_ONLY = 0x00000010, // SGI specific features.
1679 RHF_GUARANTEE_INIT = 0x00000020, // Guarantee that .init will finish
1680 // executing before any non-init
1681 // code in DSO is called.
1682 RHF_DELTA_C_PLUS_PLUS = 0x00000040, // Contains Delta C++ code.
1683 RHF_GUARANTEE_START_INIT = 0x00000080, // Guarantee that .init will start
1684 // executing before any non-init
1685 // code in DSO is called.
1686 RHF_PIXIE = 0x00000100, // Generated by pixie.
1687 RHF_DEFAULT_DELAY_LOAD = 0x00000200, // Delay-load DSO by default.
1688 RHF_REQUICKSTART = 0x00000400, // Object may be requickstarted
1689 RHF_REQUICKSTARTED = 0x00000800, // Object has been requickstarted
1690 RHF_CORD = 0x00001000, // Generated by cord.
1691 RHF_NO_UNRES_UNDEF = 0x00002000, // Object contains no unresolved
1692 // undef symbols.
1693 RHF_RLD_ORDER_SAFE = 0x00004000 // Symbol table is in a safe order.
1694 };
1695
1696 // ElfXX_VerDef structure version (GNU versioning)
1697 enum { VER_DEF_NONE = 0, VER_DEF_CURRENT = 1 };
1698
1699 // VerDef Flags (ElfXX_VerDef::vd_flags)
1700 enum { VER_FLG_BASE = 0x1, VER_FLG_WEAK = 0x2, VER_FLG_INFO = 0x4 };
1701
1702 // Special constants for the version table. (SHT_GNU_versym/.gnu.version)
1703 enum {
1704 VER_NDX_LOCAL = 0, // Unversioned local symbol
1705 VER_NDX_GLOBAL = 1, // Unversioned global symbol
1706 VERSYM_VERSION = 0x7fff, // Version Index mask
1707 VERSYM_HIDDEN = 0x8000 // Hidden bit (non-default version)
1708 };
1709
1710 // ElfXX_VerNeed structure version (GNU versioning)
1711 enum { VER_NEED_NONE = 0, VER_NEED_CURRENT = 1 };
1712
1713 // SHT_NOTE section types.
1714
1715 // Generic note types.
1716 enum : unsigned {
1717 NT_VERSION = 1,
1718 NT_ARCH = 2,
1719 NT_GNU_BUILD_ATTRIBUTE_OPEN = 0x100,
1720 NT_GNU_BUILD_ATTRIBUTE_FUNC = 0x101,
1721 };
1722
1723 // Core note types.
1724 enum : unsigned {
1725 NT_PRSTATUS = 1,
1726 NT_FPREGSET = 2,
1727 NT_PRPSINFO = 3,
1728 NT_TASKSTRUCT = 4,
1729 NT_AUXV = 6,
1730 NT_PSTATUS = 10,
1731 NT_FPREGS = 12,
1732 NT_PSINFO = 13,
1733 NT_LWPSTATUS = 16,
1734 NT_LWPSINFO = 17,
1735 NT_WIN32PSTATUS = 18,
1736
1737 NT_PPC_VMX = 0x100,
1738 NT_PPC_VSX = 0x102,
1739 NT_PPC_TAR = 0x103,
1740 NT_PPC_PPR = 0x104,
1741 NT_PPC_DSCR = 0x105,
1742 NT_PPC_EBB = 0x106,
1743 NT_PPC_PMU = 0x107,
1744 NT_PPC_TM_CGPR = 0x108,
1745 NT_PPC_TM_CFPR = 0x109,
1746 NT_PPC_TM_CVMX = 0x10a,
1747 NT_PPC_TM_CVSX = 0x10b,
1748 NT_PPC_TM_SPR = 0x10c,
1749 NT_PPC_TM_CTAR = 0x10d,
1750 NT_PPC_TM_CPPR = 0x10e,
1751 NT_PPC_TM_CDSCR = 0x10f,
1752
1753 NT_386_TLS = 0x200,
1754 NT_386_IOPERM = 0x201,
1755 NT_X86_XSTATE = 0x202,
1756
1757 NT_S390_HIGH_GPRS = 0x300,
1758 NT_S390_TIMER = 0x301,
1759 NT_S390_TODCMP = 0x302,
1760 NT_S390_TODPREG = 0x303,
1761 NT_S390_CTRS = 0x304,
1762 NT_S390_PREFIX = 0x305,
1763 NT_S390_LAST_BREAK = 0x306,
1764 NT_S390_SYSTEM_CALL = 0x307,
1765 NT_S390_TDB = 0x308,
1766 NT_S390_VXRS_LOW = 0x309,
1767 NT_S390_VXRS_HIGH = 0x30a,
1768 NT_S390_GS_CB = 0x30b,
1769 NT_S390_GS_BC = 0x30c,
1770
1771 NT_ARM_VFP = 0x400,
1772 NT_ARM_TLS = 0x401,
1773 NT_ARM_HW_BREAK = 0x402,
1774 NT_ARM_HW_WATCH = 0x403,
1775 NT_ARM_SVE = 0x405,
1776 NT_ARM_PAC_MASK = 0x406,
1777 NT_ARM_TAGGED_ADDR_CTRL = 0x409,
1778 NT_ARM_SSVE = 0x40b,
1779 NT_ARM_ZA = 0x40c,
1780 NT_ARM_ZT = 0x40d,
1781 NT_ARM_FPMR = 0x40e,
1782 NT_ARM_GCS = 0x410,
1783
1784 NT_FILE = 0x46494c45,
1785 NT_PRXFPREG = 0x46e62b7f,
1786 NT_SIGINFO = 0x53494749,
1787 };
1788
1789 // LLVM-specific notes.
1790 enum {
1791 NT_LLVM_HWASAN_GLOBALS = 3,
1792 };
1793
1794 // GNU note types.
1795 enum {
1796 NT_GNU_ABI_TAG = 1,
1797 NT_GNU_HWCAP = 2,
1798 NT_GNU_BUILD_ID = 3,
1799 NT_GNU_GOLD_VERSION = 4,
1800 NT_GNU_PROPERTY_TYPE_0 = 5,
1801 FDO_PACKAGING_METADATA = 0xcafe1a7e,
1802 };
1803
1804 // Android note types.
1805 enum {
1806 NT_ANDROID_TYPE_IDENT = 1,
1807 NT_ANDROID_TYPE_KUSER = 3,
1808 NT_ANDROID_TYPE_MEMTAG = 4,
1809 };
1810
1811 // Memory tagging values used in NT_ANDROID_TYPE_MEMTAG notes.
1812 enum {
1813 // Enumeration to determine the tagging mode. In Android-land, 'SYNC' means
1814 // running all threads in MTE Synchronous mode, and 'ASYNC' means to use the
1815 // kernels auto-upgrade feature to allow for either MTE Asynchronous,
1816 // Asymmetric, or Synchronous mode. This allows silicon vendors to specify, on
1817 // a per-cpu basis what 'ASYNC' should mean. Generally, the expectation is
1818 // "pick the most precise mode that's very fast".
1819 NT_MEMTAG_LEVEL_NONE = 0,
1820 NT_MEMTAG_LEVEL_ASYNC = 1,
1821 NT_MEMTAG_LEVEL_SYNC = 2,
1822 NT_MEMTAG_LEVEL_MASK = 3,
1823 // Bits indicating whether the loader should prepare for MTE to be enabled on
1824 // the heap and/or stack.
1825 NT_MEMTAG_HEAP = 4,
1826 NT_MEMTAG_STACK = 8,
1827 };
1828
1829 // Property types used in GNU_PROPERTY_TYPE_0 notes.
1830 enum : unsigned {
1831 GNU_PROPERTY_STACK_SIZE = 1,
1832 GNU_PROPERTY_NO_COPY_ON_PROTECTED = 2,
1833 GNU_PROPERTY_AARCH64_FEATURE_1_AND = 0xc0000000,
1834 GNU_PROPERTY_AARCH64_FEATURE_PAUTH = 0xc0000001,
1835 GNU_PROPERTY_X86_FEATURE_1_AND = 0xc0000002,
1836 GNU_PROPERTY_RISCV_FEATURE_1_AND = 0xc0000000,
1837
1838 GNU_PROPERTY_X86_UINT32_OR_LO = 0xc0008000,
1839 GNU_PROPERTY_X86_FEATURE_2_NEEDED = GNU_PROPERTY_X86_UINT32_OR_LO + 1,
1840 GNU_PROPERTY_X86_ISA_1_NEEDED = GNU_PROPERTY_X86_UINT32_OR_LO + 2,
1841
1842 GNU_PROPERTY_X86_UINT32_OR_AND_LO = 0xc0010000,
1843 GNU_PROPERTY_X86_FEATURE_2_USED = GNU_PROPERTY_X86_UINT32_OR_AND_LO + 1,
1844 GNU_PROPERTY_X86_ISA_1_USED = GNU_PROPERTY_X86_UINT32_OR_AND_LO + 2,
1845 };
1846
1847 // aarch64 processor feature bits.
1848 enum : unsigned {
1849 GNU_PROPERTY_AARCH64_FEATURE_1_BTI = 1 << 0,
1850 GNU_PROPERTY_AARCH64_FEATURE_1_PAC = 1 << 1,
1851 GNU_PROPERTY_AARCH64_FEATURE_1_GCS = 1 << 2,
1852 };
1853
1854 // aarch64 PAuth platforms.
1855 enum : unsigned {
1856 AARCH64_PAUTH_PLATFORM_INVALID = 0x0,
1857 AARCH64_PAUTH_PLATFORM_BAREMETAL = 0x1,
1858 AARCH64_PAUTH_PLATFORM_LLVM_LINUX = 0x10000002,
1859 };
1860
1861 // Bit positions of version flags for AARCH64_PAUTH_PLATFORM_LLVM_LINUX.
1862 enum : unsigned {
1863 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_INTRINSICS = 0,
1864 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_CALLS = 1,
1865 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_RETURNS = 2,
1866 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_AUTHTRAPS = 3,
1867 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_VPTRADDRDISCR = 4,
1868 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_VPTRTYPEDISCR = 5,
1869 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_INITFINI = 6,
1870 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_INITFINIADDRDISC = 7,
1871 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_GOT = 8,
1872 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_GOTOS = 9,
1873 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_TYPEINFOVPTRDISCR = 10,
1874 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_FPTRTYPEDISCR = 11,
1875 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_LAST =
1876 AARCH64_PAUTH_PLATFORM_LLVM_LINUX_VERSION_FPTRTYPEDISCR,
1877 };
1878
1879 // x86 processor feature bits.
1880 enum : unsigned {
1881 GNU_PROPERTY_X86_FEATURE_1_IBT = 1 << 0,
1882 GNU_PROPERTY_X86_FEATURE_1_SHSTK = 1 << 1,
1883
1884 GNU_PROPERTY_X86_FEATURE_2_X86 = 1 << 0,
1885 GNU_PROPERTY_X86_FEATURE_2_X87 = 1 << 1,
1886 GNU_PROPERTY_X86_FEATURE_2_MMX = 1 << 2,
1887 GNU_PROPERTY_X86_FEATURE_2_XMM = 1 << 3,
1888 GNU_PROPERTY_X86_FEATURE_2_YMM = 1 << 4,
1889 GNU_PROPERTY_X86_FEATURE_2_ZMM = 1 << 5,
1890 GNU_PROPERTY_X86_FEATURE_2_FXSR = 1 << 6,
1891 GNU_PROPERTY_X86_FEATURE_2_XSAVE = 1 << 7,
1892 GNU_PROPERTY_X86_FEATURE_2_XSAVEOPT = 1 << 8,
1893 GNU_PROPERTY_X86_FEATURE_2_XSAVEC = 1 << 9,
1894
1895 GNU_PROPERTY_X86_ISA_1_BASELINE = 1 << 0,
1896 GNU_PROPERTY_X86_ISA_1_V2 = 1 << 1,
1897 GNU_PROPERTY_X86_ISA_1_V3 = 1 << 2,
1898 GNU_PROPERTY_X86_ISA_1_V4 = 1 << 3,
1899 };
1900
1901 // RISC-V processor feature bits.
1902 enum : unsigned {
1903 GNU_PROPERTY_RISCV_FEATURE_1_CFI_LP_UNLABELED = 1 << 0,
1904 GNU_PROPERTY_RISCV_FEATURE_1_CFI_SS = 1 << 1,
1905 GNU_PROPERTY_RISCV_FEATURE_1_CFI_LP_FUNC_SIG = 1 << 2,
1906 };
1907
1908 // FreeBSD note types.
1909 enum {
1910 NT_FREEBSD_ABI_TAG = 1,
1911 NT_FREEBSD_NOINIT_TAG = 2,
1912 NT_FREEBSD_ARCH_TAG = 3,
1913 NT_FREEBSD_FEATURE_CTL = 4,
1914 };
1915
1916 // NT_FREEBSD_FEATURE_CTL values (see FreeBSD's sys/sys/elf_common.h).
1917 enum {
1918 NT_FREEBSD_FCTL_ASLR_DISABLE = 0x00000001,
1919 NT_FREEBSD_FCTL_PROTMAX_DISABLE = 0x00000002,
1920 NT_FREEBSD_FCTL_STKGAP_DISABLE = 0x00000004,
1921 NT_FREEBSD_FCTL_WXNEEDED = 0x00000008,
1922 NT_FREEBSD_FCTL_LA48 = 0x00000010,
1923 NT_FREEBSD_FCTL_ASG_DISABLE = 0x00000020,
1924 };
1925
1926 // FreeBSD core note types.
1927 enum {
1928 NT_FREEBSD_THRMISC = 7,
1929 NT_FREEBSD_PROCSTAT_PROC = 8,
1930 NT_FREEBSD_PROCSTAT_FILES = 9,
1931 NT_FREEBSD_PROCSTAT_VMMAP = 10,
1932 NT_FREEBSD_PROCSTAT_GROUPS = 11,
1933 NT_FREEBSD_PROCSTAT_UMASK = 12,
1934 NT_FREEBSD_PROCSTAT_RLIMIT = 13,
1935 NT_FREEBSD_PROCSTAT_OSREL = 14,
1936 NT_FREEBSD_PROCSTAT_PSSTRINGS = 15,
1937 NT_FREEBSD_PROCSTAT_AUXV = 16,
1938 };
1939
1940 // NetBSD core note types.
1941 enum {
1942 NT_NETBSDCORE_PROCINFO = 1,
1943 NT_NETBSDCORE_AUXV = 2,
1944 NT_NETBSDCORE_LWPSTATUS = 24,
1945 };
1946
1947 // OpenBSD core note types.
1948 enum {
1949 NT_OPENBSD_PROCINFO = 10,
1950 NT_OPENBSD_AUXV = 11,
1951 NT_OPENBSD_REGS = 20,
1952 NT_OPENBSD_FPREGS = 21,
1953 NT_OPENBSD_XFPREGS = 22,
1954 NT_OPENBSD_WCOOKIE = 23,
1955 };
1956
1957 // AMDGPU-specific section indices.
1958 enum {
1959 SHN_AMDGPU_LDS = 0xff00, // Variable in LDS; symbol encoded like SHN_COMMON
1960 };
1961
1962 // AMD vendor specific notes. (Code Object V2)
1963 enum {
1964 NT_AMD_HSA_CODE_OBJECT_VERSION = 1,
1965 NT_AMD_HSA_HSAIL = 2,
1966 NT_AMD_HSA_ISA_VERSION = 3,
1967 // Note types with values between 4 and 9 (inclusive) are reserved.
1968 NT_AMD_HSA_METADATA = 10,
1969 NT_AMD_HSA_ISA_NAME = 11,
1970 NT_AMD_PAL_METADATA = 12
1971 };
1972
1973 // AMDGPU vendor specific notes. (Code Object V3)
1974 enum {
1975 // Note types with values between 0 and 31 (inclusive) are reserved.
1976 NT_AMDGPU_METADATA = 32
1977 };
1978
1979 // LLVMOMPOFFLOAD specific notes.
1980 enum : unsigned {
1981 NT_LLVM_OPENMP_OFFLOAD_VERSION = 1,
1982 NT_LLVM_OPENMP_OFFLOAD_PRODUCER = 2,
1983 NT_LLVM_OPENMP_OFFLOAD_PRODUCER_VERSION = 3
1984 };
1985
1986 enum {
1987 GNU_ABI_TAG_LINUX = 0,
1988 GNU_ABI_TAG_HURD = 1,
1989 GNU_ABI_TAG_SOLARIS = 2,
1990 GNU_ABI_TAG_FREEBSD = 3,
1991 GNU_ABI_TAG_NETBSD = 4,
1992 GNU_ABI_TAG_SYLLABLE = 5,
1993 GNU_ABI_TAG_NACL = 6,
1994 };
1995
1996 constexpr const char *ELF_NOTE_GNU = "GNU";
1997
1998 // Android packed relocation group flags.
1999 enum {
2000 RELOCATION_GROUPED_BY_INFO_FLAG = 1,
2001 RELOCATION_GROUPED_BY_OFFSET_DELTA_FLAG = 2,
2002 RELOCATION_GROUPED_BY_ADDEND_FLAG = 4,
2003 RELOCATION_GROUP_HAS_ADDEND_FLAG = 8,
2004 };
2005
2006 // Compressed section header for ELF32.
2007 struct Elf32_Chdr {
2008 Elf32_Word ch_type;
2009 Elf32_Word ch_size;
2010 Elf32_Word ch_addralign;
2011 };
2012
2013 // Compressed section header for ELF64.
2014 struct Elf64_Chdr {
2015 Elf64_Word ch_type;
2016 Elf64_Word ch_reserved;
2017 Elf64_Xword ch_size;
2018 Elf64_Xword ch_addralign;
2019 };
2020
2021 // Note header for ELF32.
2022 struct Elf32_Nhdr {
2023 Elf32_Word n_namesz;
2024 Elf32_Word n_descsz;
2025 Elf32_Word n_type;
2026 };
2027
2028 // Note header for ELF64.
2029 struct Elf64_Nhdr {
2030 Elf64_Word n_namesz;
2031 Elf64_Word n_descsz;
2032 Elf64_Word n_type;
2033 };
2034
2035 // Legal values for ch_type field of compressed section header.
2036 enum {
2037 ELFCOMPRESS_ZLIB = 1, // ZLIB/DEFLATE algorithm.
2038 ELFCOMPRESS_ZSTD = 2, // Zstandard algorithm
2039 ELFCOMPRESS_LOOS = 0x60000000, // Start of OS-specific.
2040 ELFCOMPRESS_HIOS = 0x6fffffff, // End of OS-specific.
2041 ELFCOMPRESS_LOPROC = 0x70000000, // Start of processor-specific.
2042 ELFCOMPRESS_HIPROC = 0x7fffffff // End of processor-specific.
2043 };
2044
2045 constexpr unsigned CREL_HDR_ADDEND = 4;
2046
2047 /// Convert an architecture name into ELF's e_machine value.
2048 LLVM_ABI uint16_t convertArchNameToEMachine(StringRef Arch);
2049
2050 /// Convert an ELF's e_machine value into an architecture name.
2051 LLVM_ABI StringRef convertEMachineToArchName(uint16_t EMachine);
2052
2053 // Convert a triple's architecture to ELF's e_machine value.
2054 LLVM_ABI uint16_t convertTripleArchTypeToEMachine(Triple::ArchType ArchType);
2055
2056 // Convert a lowercase string identifier into an OSABI value.
2057 LLVM_ABI uint8_t convertNameToOSABI(StringRef Name);
2058
2059 // Convert an OSABI value into a string that identifies the OS- or ABI-
2060 // specific ELF extension.
2061 LLVM_ABI StringRef convertOSABIToName(uint8_t OSABI);
2062
2063 } // end namespace ELF
2064 } // end namespace llvm
2065
2066 #endif // LLVM_BINARYFORMAT_ELF_H
2067