blob: b88e6cf4032b5f1b6ec109633d945872432def67 [file] [log] [blame]
Tom Rini10e47792018-05-06 17:58:06 -04001/* SPDX-License-Identifier: BSD-3-Clause */
wdenka2cecab2002-09-30 20:45:01 +00002/*
3 * Copyright (c) 1995, 1996, 2001, 2002
4 * Erik Theisen. All rights reserved.
wdenka2cecab2002-09-30 20:45:01 +00005 */
6
Bin Meng4d216972018-04-11 22:02:12 -07007/* This is the ELF ABI header file formerly known as "elf_abi.h" */
wdenka2cecab2002-09-30 20:45:01 +00008
9#ifndef _ELF_H
10#define _ELF_H
11
Simon Glass559f1a82020-05-10 11:40:12 -060012#ifndef __ASSEMBLY__
Mike Frysinger4ad8e9f2009-07-02 19:23:25 -040013#include "compiler.h"
wdenka2cecab2002-09-30 20:45:01 +000014
Maxim Moskaletse4170b82024-06-05 21:43:34 +030015/* Flag param bits for bootelf() function */
16typedef struct {
17 unsigned phdr : 1; /* load via program (not section) headers */
18 unsigned autostart : 1; /* Start ELF after loading */
19} Bootelf_flags;
20
Bin Meng4d216972018-04-11 22:02:12 -070021/* This version doesn't work for 64-bit ABIs - Erik */
wdenka2cecab2002-09-30 20:45:01 +000022
Bin Meng4d216972018-04-11 22:02:12 -070023/* These typedefs need to be handled better */
wdenka2cecab2002-09-30 20:45:01 +000024typedef uint32_t Elf32_Addr; /* Unsigned program address */
25typedef uint32_t Elf32_Off; /* Unsigned file offset */
26typedef int32_t Elf32_Sword; /* Signed large integer */
27typedef uint32_t Elf32_Word; /* Unsigned large integer */
28typedef uint16_t Elf32_Half; /* Unsigned medium integer */
29
Bin Meng4d216972018-04-11 22:02:12 -070030/* 64-bit ELF base types */
Simon Glass3ed7dda2015-07-31 09:31:21 -060031typedef uint64_t Elf64_Addr;
32typedef uint16_t Elf64_Half;
33typedef int16_t Elf64_SHalf;
34typedef uint64_t Elf64_Off;
35typedef int32_t Elf64_Sword;
36typedef uint32_t Elf64_Word;
37typedef uint64_t Elf64_Xword;
38typedef int64_t Elf64_Sxword;
39
wdenka2cecab2002-09-30 20:45:01 +000040/* e_ident[] identification indexes */
41#define EI_MAG0 0 /* file ID */
42#define EI_MAG1 1 /* file ID */
43#define EI_MAG2 2 /* file ID */
44#define EI_MAG3 3 /* file ID */
45#define EI_CLASS 4 /* file class */
46#define EI_DATA 5 /* data encoding */
47#define EI_VERSION 6 /* ELF header version */
48#define EI_OSABI 7 /* OS/ABI specific ELF extensions */
49#define EI_ABIVERSION 8 /* ABI target version */
50#define EI_PAD 9 /* start of pad bytes */
51#define EI_NIDENT 16 /* Size of e_ident[] */
52
53/* e_ident[] magic number */
54#define ELFMAG0 0x7f /* e_ident[EI_MAG0] */
55#define ELFMAG1 'E' /* e_ident[EI_MAG1] */
56#define ELFMAG2 'L' /* e_ident[EI_MAG2] */
57#define ELFMAG3 'F' /* e_ident[EI_MAG3] */
58#define ELFMAG "\177ELF" /* magic */
59#define SELFMAG 4 /* size of magic */
60
61/* e_ident[] file class */
62#define ELFCLASSNONE 0 /* invalid */
63#define ELFCLASS32 1 /* 32-bit objs */
64#define ELFCLASS64 2 /* 64-bit objs */
65#define ELFCLASSNUM 3 /* number of classes */
66
67/* e_ident[] data encoding */
68#define ELFDATANONE 0 /* invalid */
69#define ELFDATA2LSB 1 /* Little-Endian */
70#define ELFDATA2MSB 2 /* Big-Endian */
71#define ELFDATANUM 3 /* number of data encode defines */
72
73/* e_ident[] OS/ABI specific ELF extensions */
74#define ELFOSABI_NONE 0 /* No extension specified */
75#define ELFOSABI_HPUX 1 /* Hewlett-Packard HP-UX */
76#define ELFOSABI_NETBSD 2 /* NetBSD */
77#define ELFOSABI_LINUX 3 /* Linux */
78#define ELFOSABI_SOLARIS 6 /* Sun Solaris */
79#define ELFOSABI_AIX 7 /* AIX */
80#define ELFOSABI_IRIX 8 /* IRIX */
81#define ELFOSABI_FREEBSD 9 /* FreeBSD */
82#define ELFOSABI_TRU64 10 /* Compaq TRU64 UNIX */
83#define ELFOSABI_MODESTO 11 /* Novell Modesto */
84#define ELFOSABI_OPENBSD 12 /* OpenBSD */
85/* 64-255 Architecture-specific value range */
86
87/* e_ident[] ABI Version */
88#define ELFABIVERSION 0
89
90/* e_ident */
91#define IS_ELF(ehdr) ((ehdr).e_ident[EI_MAG0] == ELFMAG0 && \
wdenk57b2d802003-06-27 21:31:46 +000092 (ehdr).e_ident[EI_MAG1] == ELFMAG1 && \
93 (ehdr).e_ident[EI_MAG2] == ELFMAG2 && \
94 (ehdr).e_ident[EI_MAG3] == ELFMAG3)
wdenka2cecab2002-09-30 20:45:01 +000095
96/* ELF Header */
Bin Meng4d216972018-04-11 22:02:12 -070097typedef struct {
wdenka2cecab2002-09-30 20:45:01 +000098 unsigned char e_ident[EI_NIDENT]; /* ELF Identification */
99 Elf32_Half e_type; /* object file type */
100 Elf32_Half e_machine; /* machine */
101 Elf32_Word e_version; /* object file version */
102 Elf32_Addr e_entry; /* virtual entry point */
103 Elf32_Off e_phoff; /* program header table offset */
104 Elf32_Off e_shoff; /* section header table offset */
105 Elf32_Word e_flags; /* processor-specific flags */
106 Elf32_Half e_ehsize; /* ELF header size */
107 Elf32_Half e_phentsize; /* program header entry size */
108 Elf32_Half e_phnum; /* number of program header entries */
109 Elf32_Half e_shentsize; /* section header entry size */
110 Elf32_Half e_shnum; /* number of section header entries */
111 Elf32_Half e_shstrndx; /* section header table's "section
112 header string table" entry offset */
113} Elf32_Ehdr;
114
Bin Meng6291ba12018-04-11 22:02:13 -0700115typedef struct {
116 unsigned char e_ident[EI_NIDENT]; /* ELF Identification */
117 Elf64_Half e_type; /* object file type */
118 Elf64_Half e_machine; /* machine */
119 Elf64_Word e_version; /* object file version */
120 Elf64_Addr e_entry; /* virtual entry point */
121 Elf64_Off e_phoff; /* program header table offset */
122 Elf64_Off e_shoff; /* section header table offset */
123 Elf64_Word e_flags; /* processor-specific flags */
124 Elf64_Half e_ehsize; /* ELF header size */
125 Elf64_Half e_phentsize; /* program header entry size */
126 Elf64_Half e_phnum; /* number of program header entries */
127 Elf64_Half e_shentsize; /* section header entry size */
128 Elf64_Half e_shnum; /* number of section header entries */
129 Elf64_Half e_shstrndx; /* section header table's "section
130 header string table" entry offset */
131} Elf64_Ehdr;
132
wdenka2cecab2002-09-30 20:45:01 +0000133/* e_type */
134#define ET_NONE 0 /* No file type */
135#define ET_REL 1 /* relocatable file */
136#define ET_EXEC 2 /* executable file */
137#define ET_DYN 3 /* shared object file */
138#define ET_CORE 4 /* core file */
139#define ET_NUM 5 /* number of types */
140#define ET_LOOS 0xfe00 /* reserved range for operating */
Bin Meng4d216972018-04-11 22:02:12 -0700141#define ET_HIOS 0xfeff /* system specific e_type */
wdenka2cecab2002-09-30 20:45:01 +0000142#define ET_LOPROC 0xff00 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700143#define ET_HIPROC 0xffff /* specific e_type */
wdenka2cecab2002-09-30 20:45:01 +0000144
145/* e_machine */
146#define EM_NONE 0 /* No Machine */
147#define EM_M32 1 /* AT&T WE 32100 */
148#define EM_SPARC 2 /* SPARC */
149#define EM_386 3 /* Intel 80386 */
150#define EM_68K 4 /* Motorola 68000 */
151#define EM_88K 5 /* Motorola 88000 */
152#if 0
153#define EM_486 6 /* RESERVED - was Intel 80486 */
154#endif
155#define EM_860 7 /* Intel 80860 */
156#define EM_MIPS 8 /* MIPS R3000 Big-Endian only */
157#define EM_S370 9 /* IBM System/370 Processor */
158#define EM_MIPS_RS4_BE 10 /* MIPS R4000 Big-Endian */
159#if 0
160#define EM_SPARC64 11 /* RESERVED - was SPARC v9
161 64-bit unoffical */
162#endif
163/* RESERVED 11-14 for future use */
164#define EM_PARISC 15 /* HPPA */
165/* RESERVED 16 for future use */
166#define EM_VPP500 17 /* Fujitsu VPP500 */
167#define EM_SPARC32PLUS 18 /* Enhanced instruction set SPARC */
168#define EM_960 19 /* Intel 80960 */
169#define EM_PPC 20 /* PowerPC */
170#define EM_PPC64 21 /* 64-bit PowerPC */
171#define EM_S390 22 /* IBM System/390 Processor */
172/* RESERVED 23-35 for future use */
173#define EM_V800 36 /* NEC V800 */
174#define EM_FR20 37 /* Fujitsu FR20 */
175#define EM_RH32 38 /* TRW RH-32 */
176#define EM_RCE 39 /* Motorola RCE */
177#define EM_ARM 40 /* Advanced Risc Machines ARM */
178#define EM_ALPHA 41 /* Digital Alpha */
179#define EM_SH 42 /* Hitachi SH */
180#define EM_SPARCV9 43 /* SPARC Version 9 */
181#define EM_TRICORE 44 /* Siemens TriCore embedded processor */
182#define EM_ARC 45 /* Argonaut RISC Core */
183#define EM_H8_300 46 /* Hitachi H8/300 */
184#define EM_H8_300H 47 /* Hitachi H8/300H */
185#define EM_H8S 48 /* Hitachi H8S */
186#define EM_H8_500 49 /* Hitachi H8/500 */
187#define EM_IA_64 50 /* Intel Merced */
188#define EM_MIPS_X 51 /* Stanford MIPS-X */
189#define EM_COLDFIRE 52 /* Motorola Coldfire */
190#define EM_68HC12 53 /* Motorola M68HC12 */
191#define EM_MMA 54 /* Fujitsu MMA Multimedia Accelerator*/
192#define EM_PCP 55 /* Siemens PCP */
193#define EM_NCPU 56 /* Sony nCPU embeeded RISC */
194#define EM_NDR1 57 /* Denso NDR1 microprocessor */
195#define EM_STARCORE 58 /* Motorola Start*Core processor */
196#define EM_ME16 59 /* Toyota ME16 processor */
Patrick Delaunaya6b185e2022-05-20 18:38:10 +0200197#define EM_ST100 60 /* STMicroelectronics ST100 processor */
wdenka2cecab2002-09-30 20:45:01 +0000198#define EM_TINYJ 61 /* Advanced Logic Corp. Tinyj emb.fam*/
199#define EM_X86_64 62 /* AMD x86-64 */
200#define EM_PDSP 63 /* Sony DSP Processor */
201/* RESERVED 64,65 for future use */
202#define EM_FX66 66 /* Siemens FX66 microcontroller */
203#define EM_ST9PLUS 67 /* STMicroelectronics ST9+ 8/16 mc */
Patrick Delaunaya6b185e2022-05-20 18:38:10 +0200204#define EM_ST7 68 /* STMicroelectronics ST7 8 bit mc */
wdenka2cecab2002-09-30 20:45:01 +0000205#define EM_68HC16 69 /* Motorola MC68HC16 microcontroller */
206#define EM_68HC11 70 /* Motorola MC68HC11 microcontroller */
207#define EM_68HC08 71 /* Motorola MC68HC08 microcontroller */
208#define EM_68HC05 72 /* Motorola MC68HC05 microcontroller */
209#define EM_SVX 73 /* Silicon Graphics SVx */
210#define EM_ST19 74 /* STMicroelectronics ST19 8 bit mc */
211#define EM_VAX 75 /* Digital VAX */
212#define EM_CHRIS 76 /* Axis Communications embedded proc. */
213#define EM_JAVELIN 77 /* Infineon Technologies emb. proc. */
214#define EM_FIREPATH 78 /* Element 14 64-bit DSP Processor */
215#define EM_ZSP 79 /* LSI Logic 16-bit DSP Processor */
216#define EM_MMIX 80 /* Donald Knuth's edu 64-bit proc. */
217#define EM_HUANY 81 /* Harvard University mach-indep objs */
218#define EM_PRISM 82 /* SiTera Prism */
219#define EM_AVR 83 /* Atmel AVR 8-bit microcontroller */
220#define EM_FR30 84 /* Fujitsu FR30 */
221#define EM_D10V 85 /* Mitsubishi DV10V */
222#define EM_D30V 86 /* Mitsubishi DV30V */
223#define EM_V850 87 /* NEC v850 */
224#define EM_M32R 88 /* Mitsubishi M32R */
225#define EM_MN10300 89 /* Matsushita MN10200 */
226#define EM_MN10200 90 /* Matsushita MN10200 */
227#define EM_PJ 91 /* picoJava */
228#define EM_NUM 92 /* number of machine types */
229
230/* Version */
231#define EV_NONE 0 /* Invalid */
232#define EV_CURRENT 1 /* Current */
233#define EV_NUM 2 /* number of versions */
234
235/* Section Header */
236typedef struct {
237 Elf32_Word sh_name; /* name - index into section header
238 string table section */
239 Elf32_Word sh_type; /* type */
240 Elf32_Word sh_flags; /* flags */
241 Elf32_Addr sh_addr; /* address */
242 Elf32_Off sh_offset; /* file offset */
243 Elf32_Word sh_size; /* section size */
244 Elf32_Word sh_link; /* section header table index link */
245 Elf32_Word sh_info; /* extra information */
246 Elf32_Word sh_addralign; /* address alignment */
247 Elf32_Word sh_entsize; /* section entry size */
248} Elf32_Shdr;
249
Bin Meng6291ba12018-04-11 22:02:13 -0700250typedef struct {
251 Elf64_Word sh_name; /* name - index into section header
252 string table section */
253 Elf64_Word sh_type; /* type */
254 Elf64_Xword sh_flags; /* flags */
255 Elf64_Addr sh_addr; /* address */
256 Elf64_Off sh_offset; /* file offset */
257 Elf64_Xword sh_size; /* section size */
258 Elf64_Word sh_link; /* section header table index link */
259 Elf64_Word sh_info; /* extra information */
260 Elf64_Xword sh_addralign; /* address alignment */
261 Elf64_Xword sh_entsize; /* section entry size */
262} Elf64_Shdr;
263
wdenka2cecab2002-09-30 20:45:01 +0000264/* Special Section Indexes */
265#define SHN_UNDEF 0 /* undefined */
266#define SHN_LORESERVE 0xff00 /* lower bounds of reserved indexes */
267#define SHN_LOPROC 0xff00 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700268#define SHN_HIPROC 0xff1f /* specific section indexes */
wdenka2cecab2002-09-30 20:45:01 +0000269#define SHN_LOOS 0xff20 /* reserved range for operating */
Bin Meng4d216972018-04-11 22:02:12 -0700270#define SHN_HIOS 0xff3f /* specific semantics */
wdenka2cecab2002-09-30 20:45:01 +0000271#define SHN_ABS 0xfff1 /* absolute value */
272#define SHN_COMMON 0xfff2 /* common symbol */
273#define SHN_XINDEX 0xffff /* Index is an extra table */
274#define SHN_HIRESERVE 0xffff /* upper bounds of reserved indexes */
275
276/* sh_type */
277#define SHT_NULL 0 /* inactive */
278#define SHT_PROGBITS 1 /* program defined information */
279#define SHT_SYMTAB 2 /* symbol table section */
280#define SHT_STRTAB 3 /* string table section */
281#define SHT_RELA 4 /* relocation section with addends*/
282#define SHT_HASH 5 /* symbol hash table section */
283#define SHT_DYNAMIC 6 /* dynamic section */
284#define SHT_NOTE 7 /* note section */
285#define SHT_NOBITS 8 /* no space section */
286#define SHT_REL 9 /* relation section without addends */
287#define SHT_SHLIB 10 /* reserved - purpose unknown */
288#define SHT_DYNSYM 11 /* dynamic symbol table section */
289#define SHT_INIT_ARRAY 14 /* Array of constructors */
290#define SHT_FINI_ARRAY 15 /* Array of destructors */
291#define SHT_PREINIT_ARRAY 16 /* Array of pre-constructors */
292#define SHT_GROUP 17 /* Section group */
293#define SHT_SYMTAB_SHNDX 18 /* Extended section indeces */
294#define SHT_NUM 19 /* number of section types */
295#define SHT_LOOS 0x60000000 /* Start OS-specific */
296#define SHT_HIOS 0x6fffffff /* End OS-specific */
297#define SHT_LOPROC 0x70000000 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700298#define SHT_HIPROC 0x7fffffff /* specific section header types */
wdenka2cecab2002-09-30 20:45:01 +0000299#define SHT_LOUSER 0x80000000 /* reserved range for application */
Bin Meng4d216972018-04-11 22:02:12 -0700300#define SHT_HIUSER 0xffffffff /* specific indexes */
wdenka2cecab2002-09-30 20:45:01 +0000301
302/* Section names */
Bin Meng4d216972018-04-11 22:02:12 -0700303#define ELF_BSS ".bss" /* uninitialized data */
wdenka2cecab2002-09-30 20:45:01 +0000304#define ELF_COMMENT ".comment" /* version control information */
Bin Meng4d216972018-04-11 22:02:12 -0700305#define ELF_DATA ".data" /* initialized data */
306#define ELF_DATA1 ".data1" /* initialized data */
307#define ELF_DEBUG ".debug" /* debug */
308#define ELF_DYNAMIC ".dynamic" /* dynamic linking information */
309#define ELF_DYNSTR ".dynstr" /* dynamic string table */
310#define ELF_DYNSYM ".dynsym" /* dynamic symbol table */
311#define ELF_FINI ".fini" /* termination code */
wdenka2cecab2002-09-30 20:45:01 +0000312#define ELF_FINI_ARRAY ".fini_array" /* Array of destructors */
Bin Meng4d216972018-04-11 22:02:12 -0700313#define ELF_GOT ".got" /* global offset table */
314#define ELF_HASH ".hash" /* symbol hash table */
315#define ELF_INIT ".init" /* initialization code */
wdenka2cecab2002-09-30 20:45:01 +0000316#define ELF_INIT_ARRAY ".init_array" /* Array of constuctors */
317#define ELF_INTERP ".interp" /* Pathname of program interpreter */
318#define ELF_LINE ".line" /* Symbolic line numnber information */
319#define ELF_NOTE ".note" /* Contains note section */
320#define ELF_PLT ".plt" /* Procedure linkage table */
321#define ELF_PREINIT_ARRAY ".preinit_array" /* Array of pre-constructors */
Bin Meng4d216972018-04-11 22:02:12 -0700322#define ELF_REL_DATA ".rel.data" /* relocation data */
323#define ELF_REL_FINI ".rel.fini" /* relocation termination code */
324#define ELF_REL_INIT ".rel.init" /* relocation initialization code */
325#define ELF_REL_DYN ".rel.dyn" /* relocaltion dynamic link info */
326#define ELF_REL_RODATA ".rel.rodata" /* relocation read-only data */
327#define ELF_REL_TEXT ".rel.text" /* relocation code */
328#define ELF_RODATA ".rodata" /* read-only data */
329#define ELF_RODATA1 ".rodata1" /* read-only data */
330#define ELF_SHSTRTAB ".shstrtab" /* section header string table */
331#define ELF_STRTAB ".strtab" /* string table */
332#define ELF_SYMTAB ".symtab" /* symbol table */
wdenka2cecab2002-09-30 20:45:01 +0000333#define ELF_SYMTAB_SHNDX ".symtab_shndx"/* symbol table section index */
334#define ELF_TBSS ".tbss" /* thread local uninit data */
335#define ELF_TDATA ".tdata" /* thread local init data */
336#define ELF_TDATA1 ".tdata1" /* thread local init data */
Bin Meng4d216972018-04-11 22:02:12 -0700337#define ELF_TEXT ".text" /* code */
wdenka2cecab2002-09-30 20:45:01 +0000338
339/* Section Attribute Flags - sh_flags */
340#define SHF_WRITE 0x1 /* Writable */
341#define SHF_ALLOC 0x2 /* occupies memory */
342#define SHF_EXECINSTR 0x4 /* executable */
343#define SHF_MERGE 0x10 /* Might be merged */
344#define SHF_STRINGS 0x20 /* Contains NULL terminated strings */
345#define SHF_INFO_LINK 0x40 /* sh_info contains SHT index */
346#define SHF_LINK_ORDER 0x80 /* Preserve order after combining*/
347#define SHF_OS_NONCONFORMING 0x100 /* Non-standard OS specific handling */
348#define SHF_GROUP 0x200 /* Member of section group */
349#define SHF_TLS 0x400 /* Thread local storage */
350#define SHF_MASKOS 0x0ff00000 /* OS specific */
351#define SHF_MASKPROC 0xf0000000 /* reserved bits for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700352 /* specific section attributes */
wdenka2cecab2002-09-30 20:45:01 +0000353
354/* Section Group Flags */
355#define GRP_COMDAT 0x1 /* COMDAT group */
356#define GRP_MASKOS 0x0ff00000 /* Mask OS specific flags */
357#define GRP_MASKPROC 0xf0000000 /* Mask processor specific flags */
358
359/* Symbol Table Entry */
Bin Meng4d216972018-04-11 22:02:12 -0700360typedef struct {
wdenka2cecab2002-09-30 20:45:01 +0000361 Elf32_Word st_name; /* name - index into string table */
362 Elf32_Addr st_value; /* symbol value */
363 Elf32_Word st_size; /* symbol size */
364 unsigned char st_info; /* type and binding */
365 unsigned char st_other; /* 0 - no defined meaning */
366 Elf32_Half st_shndx; /* section header index */
367} Elf32_Sym;
368
KaDiWa5a627ad2023-01-22 20:04:53 +0100369typedef struct {
370 Elf64_Word st_name; /* name - index into string table */
371 unsigned char st_info; /* type and binding */
372 unsigned char st_other; /* 0 - no defined meaning */
373 Elf64_Half st_shndx; /* section header index */
374 Elf64_Addr st_value; /* symbol value */
375 Elf64_Xword st_size; /* symbol size */
376} Elf64_Sym;
377
wdenka2cecab2002-09-30 20:45:01 +0000378/* Symbol table index */
379#define STN_UNDEF 0 /* undefined */
380
381/* Extract symbol info - st_info */
382#define ELF32_ST_BIND(x) ((x) >> 4)
383#define ELF32_ST_TYPE(x) (((unsigned int) x) & 0xf)
384#define ELF32_ST_INFO(b,t) (((b) << 4) + ((t) & 0xf))
385#define ELF32_ST_VISIBILITY(x) ((x) & 0x3)
386
387/* Symbol Binding - ELF32_ST_BIND - st_info */
388#define STB_LOCAL 0 /* Local symbol */
389#define STB_GLOBAL 1 /* Global symbol */
390#define STB_WEAK 2 /* like global - lower precedence */
391#define STB_NUM 3 /* number of symbol bindings */
392#define STB_LOOS 10 /* reserved range for operating */
Bin Meng4d216972018-04-11 22:02:12 -0700393#define STB_HIOS 12 /* system specific symbol bindings */
wdenka2cecab2002-09-30 20:45:01 +0000394#define STB_LOPROC 13 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700395#define STB_HIPROC 15 /* specific symbol bindings */
wdenka2cecab2002-09-30 20:45:01 +0000396
397/* Symbol type - ELF32_ST_TYPE - st_info */
398#define STT_NOTYPE 0 /* not specified */
399#define STT_OBJECT 1 /* data object */
400#define STT_FUNC 2 /* function */
401#define STT_SECTION 3 /* section */
402#define STT_FILE 4 /* file */
403#define STT_NUM 5 /* number of symbol types */
404#define STT_TLS 6 /* Thread local storage symbol */
405#define STT_LOOS 10 /* reserved range for operating */
Bin Meng4d216972018-04-11 22:02:12 -0700406#define STT_HIOS 12 /* system specific symbol types */
wdenka2cecab2002-09-30 20:45:01 +0000407#define STT_LOPROC 13 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700408#define STT_HIPROC 15 /* specific symbol types */
wdenka2cecab2002-09-30 20:45:01 +0000409
410/* Symbol visibility - ELF32_ST_VISIBILITY - st_other */
411#define STV_DEFAULT 0 /* Normal visibility rules */
412#define STV_INTERNAL 1 /* Processor specific hidden class */
413#define STV_HIDDEN 2 /* Symbol unavailable in other mods */
414#define STV_PROTECTED 3 /* Not preemptible, not exported */
415
wdenka2cecab2002-09-30 20:45:01 +0000416/* Relocation entry with implicit addend */
Bin Meng4d216972018-04-11 22:02:12 -0700417typedef struct {
wdenka2cecab2002-09-30 20:45:01 +0000418 Elf32_Addr r_offset; /* offset of relocation */
419 Elf32_Word r_info; /* symbol table index and type */
420} Elf32_Rel;
421
422/* Relocation entry with explicit addend */
Bin Meng4d216972018-04-11 22:02:12 -0700423typedef struct {
wdenka2cecab2002-09-30 20:45:01 +0000424 Elf32_Addr r_offset; /* offset of relocation */
425 Elf32_Word r_info; /* symbol table index and type */
426 Elf32_Sword r_addend;
427} Elf32_Rela;
428
Simon Glass3ed7dda2015-07-31 09:31:21 -0600429typedef struct {
430 Elf64_Addr r_offset; /* Location at which to apply the action */
431 Elf64_Xword r_info; /* index and type of relocation */
432} Elf64_Rel;
433
Simon Glassd4efdff2016-09-25 21:33:09 -0600434typedef struct {
Bin Meng4d216972018-04-11 22:02:12 -0700435 Elf64_Addr r_offset; /* Location at which to apply the action */
436 Elf64_Xword r_info; /* index and type of relocation */
437 Elf64_Sxword r_addend; /* Constant addend used to compute value */
Simon Glassd4efdff2016-09-25 21:33:09 -0600438} Elf64_Rela;
439
wdenka2cecab2002-09-30 20:45:01 +0000440/* Extract relocation info - r_info */
441#define ELF32_R_SYM(i) ((i) >> 8)
442#define ELF32_R_TYPE(i) ((unsigned char) (i))
Wolfgang Denka1be4762008-05-20 16:00:29 +0200443#define ELF32_R_INFO(s,t) (((s) << 8) + (unsigned char)(t))
wdenka2cecab2002-09-30 20:45:01 +0000444
445/* Program Header */
446typedef struct {
447 Elf32_Word p_type; /* segment type */
448 Elf32_Off p_offset; /* segment offset */
449 Elf32_Addr p_vaddr; /* virtual address of segment */
Bin Meng4d216972018-04-11 22:02:12 -0700450 Elf32_Addr p_paddr; /* physical address of segment */
451 Elf32_Word p_filesz; /* number of bytes in file for seg */
452 Elf32_Word p_memsz; /* number of bytes in mem. for seg */
wdenka2cecab2002-09-30 20:45:01 +0000453 Elf32_Word p_flags; /* flags */
454 Elf32_Word p_align; /* memory alignment */
455} Elf32_Phdr;
456
Bin Meng6291ba12018-04-11 22:02:13 -0700457typedef struct {
458 Elf64_Word p_type; /* segment type */
459 Elf64_Word p_flags; /* flags */
460 Elf64_Off p_offset; /* segment offset */
461 Elf64_Addr p_vaddr; /* virtual address of segment */
462 Elf64_Addr p_paddr; /* physical address of segment */
463 Elf64_Xword p_filesz; /* number of bytes in file for seg */
464 Elf64_Xword p_memsz; /* number of bytes in mem. for seg */
465 Elf64_Xword p_align; /* memory alignment */
466} Elf64_Phdr;
467
wdenka2cecab2002-09-30 20:45:01 +0000468/* Segment types - p_type */
469#define PT_NULL 0 /* unused */
470#define PT_LOAD 1 /* loadable segment */
471#define PT_DYNAMIC 2 /* dynamic linking section */
472#define PT_INTERP 3 /* the RTLD */
473#define PT_NOTE 4 /* auxiliary information */
474#define PT_SHLIB 5 /* reserved - purpose undefined */
475#define PT_PHDR 6 /* program header */
476#define PT_TLS 7 /* Thread local storage template */
477#define PT_NUM 8 /* Number of segment types */
478#define PT_LOOS 0x60000000 /* reserved range for operating */
Bin Meng4d216972018-04-11 22:02:12 -0700479#define PT_HIOS 0x6fffffff /* system specific segment types */
wdenka2cecab2002-09-30 20:45:01 +0000480#define PT_LOPROC 0x70000000 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700481#define PT_HIPROC 0x7fffffff /* specific segment types */
wdenka2cecab2002-09-30 20:45:01 +0000482
483/* Segment flags - p_flags */
484#define PF_X 0x1 /* Executable */
485#define PF_W 0x2 /* Writable */
486#define PF_R 0x4 /* Readable */
487#define PF_MASKOS 0x0ff00000 /* OS specific segment flags */
488#define PF_MASKPROC 0xf0000000 /* reserved bits for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700489 /* specific segment flags */
wdenka2cecab2002-09-30 20:45:01 +0000490/* Dynamic structure */
Bin Meng4d216972018-04-11 22:02:12 -0700491typedef struct {
wdenka2cecab2002-09-30 20:45:01 +0000492 Elf32_Sword d_tag; /* controls meaning of d_val */
Bin Meng4d216972018-04-11 22:02:12 -0700493 union {
wdenka2cecab2002-09-30 20:45:01 +0000494 Elf32_Word d_val; /* Multiple meanings - see d_tag */
495 Elf32_Addr d_ptr; /* program virtual address */
496 } d_un;
497} Elf32_Dyn;
498
499extern Elf32_Dyn _DYNAMIC[];
500
Simon Glass3ed7dda2015-07-31 09:31:21 -0600501typedef struct {
502 Elf64_Sxword d_tag; /* entry tag value */
503 union {
504 Elf64_Xword d_val;
505 Elf64_Addr d_ptr;
506 } d_un;
507} Elf64_Dyn;
508
509#define ELF64_R_SYM(i) ((i) >> 32)
510#define ELF64_R_TYPE(i) ((i) & 0xffffffff)
511
wdenka2cecab2002-09-30 20:45:01 +0000512/* Dynamic Array Tags - d_tag */
513#define DT_NULL 0 /* marks end of _DYNAMIC array */
514#define DT_NEEDED 1 /* string table offset of needed lib */
515#define DT_PLTRELSZ 2 /* size of relocation entries in PLT */
516#define DT_PLTGOT 3 /* address PLT/GOT */
517#define DT_HASH 4 /* address of symbol hash table */
518#define DT_STRTAB 5 /* address of string table */
519#define DT_SYMTAB 6 /* address of symbol table */
520#define DT_RELA 7 /* address of relocation table */
521#define DT_RELASZ 8 /* size of relocation table */
522#define DT_RELAENT 9 /* size of relocation entry */
523#define DT_STRSZ 10 /* size of string table */
524#define DT_SYMENT 11 /* size of symbol table entry */
Bin Meng4d216972018-04-11 22:02:12 -0700525#define DT_INIT 12 /* address of initialization func */
wdenka2cecab2002-09-30 20:45:01 +0000526#define DT_FINI 13 /* address of termination function */
527#define DT_SONAME 14 /* string table offset of shared obj */
528#define DT_RPATH 15 /* string table offset of library
529 search path */
Bin Meng4d216972018-04-11 22:02:12 -0700530#define DT_SYMBOLIC 16 /* start sym search in shared obj */
wdenka2cecab2002-09-30 20:45:01 +0000531#define DT_REL 17 /* address of rel. tbl. w addends */
532#define DT_RELSZ 18 /* size of DT_REL relocation table */
533#define DT_RELENT 19 /* size of DT_REL relocation entry */
534#define DT_PLTREL 20 /* PLT referenced relocation entry */
535#define DT_DEBUG 21 /* bugger */
536#define DT_TEXTREL 22 /* Allow rel. mod. to unwritable seg */
537#define DT_JMPREL 23 /* add. of PLT's relocation entries */
538#define DT_BIND_NOW 24 /* Process relocations of object */
539#define DT_INIT_ARRAY 25 /* Array with addresses of init fct */
540#define DT_FINI_ARRAY 26 /* Array with addresses of fini fct */
541#define DT_INIT_ARRAYSZ 27 /* Size in bytes of DT_INIT_ARRAY */
542#define DT_FINI_ARRAYSZ 28 /* Size in bytes of DT_FINI_ARRAY */
543#define DT_RUNPATH 29 /* Library search path */
544#define DT_FLAGS 30 /* Flags for the object being loaded */
545#define DT_ENCODING 32 /* Start of encoded range */
546#define DT_PREINIT_ARRAY 32 /* Array with addresses of preinit fct*/
547#define DT_PREINIT_ARRAYSZ 33 /* size in bytes of DT_PREINIT_ARRAY */
Bin Meng4d216972018-04-11 22:02:12 -0700548#define DT_NUM 34 /* Number used */
wdenka2cecab2002-09-30 20:45:01 +0000549#define DT_LOOS 0x60000000 /* reserved range for OS */
Bin Meng4d216972018-04-11 22:02:12 -0700550#define DT_HIOS 0x6fffffff /* specific dynamic array tags */
wdenka2cecab2002-09-30 20:45:01 +0000551#define DT_LOPROC 0x70000000 /* reserved range for processor */
Bin Meng4d216972018-04-11 22:02:12 -0700552#define DT_HIPROC 0x7fffffff /* specific dynamic array tags */
wdenka2cecab2002-09-30 20:45:01 +0000553
554/* Dynamic Tag Flags - d_un.d_val */
555#define DF_ORIGIN 0x01 /* Object may use DF_ORIGIN */
556#define DF_SYMBOLIC 0x02 /* Symbol resolutions starts here */
557#define DF_TEXTREL 0x04 /* Object contains text relocations */
558#define DF_BIND_NOW 0x08 /* No lazy binding for this object */
559#define DF_STATIC_TLS 0x10 /* Static thread local storage */
560
561/* Standard ELF hashing function */
562unsigned long elf_hash(const unsigned char *name);
563
564#define ELF_TARG_VER 1 /* The ver for which this code is intended */
565
Simon Glass631c1a22016-11-07 08:47:09 -0700566#endif /* __ASSEMBLER */
567
Alexander Grafaf915bf2018-06-18 17:23:10 +0200568/* ELF register definitions */
569#define R_386_NONE 0
570#define R_386_32 1
571#define R_386_PC32 2
572#define R_386_GOT32 3
573#define R_386_PLT32 4
574#define R_386_COPY 5
575#define R_386_GLOB_DAT 6
576#define R_386_JMP_SLOT 7
577#define R_386_RELATIVE 8
578#define R_386_GOTOFF 9
579#define R_386_GOTPC 10
580#define R_386_NUM 11
581
582/* x86-64 relocation types */
583#define R_X86_64_NONE 0 /* No reloc */
584#define R_X86_64_64 1 /* Direct 64 bit */
585#define R_X86_64_PC32 2 /* PC relative 32 bit signed */
586#define R_X86_64_GOT32 3 /* 32 bit GOT entry */
587#define R_X86_64_PLT32 4 /* 32 bit PLT address */
588#define R_X86_64_COPY 5 /* Copy symbol at runtime */
589#define R_X86_64_GLOB_DAT 6 /* Create GOT entry */
590#define R_X86_64_JUMP_SLOT 7 /* Create PLT entry */
591#define R_X86_64_RELATIVE 8 /* Adjust by program base */
592/* 32 bit signed pc relative offset to GOT */
593#define R_X86_64_GOTPCREL 9
594#define R_X86_64_32 10 /* Direct 32 bit zero extended */
595#define R_X86_64_32S 11 /* Direct 32 bit sign extended */
596#define R_X86_64_16 12 /* Direct 16 bit zero extended */
597#define R_X86_64_PC16 13 /* 16 bit sign extended pc relative */
598#define R_X86_64_8 14 /* Direct 8 bit sign extended */
599#define R_X86_64_PC8 15 /* 8 bit sign extended pc relative */
600
601#define R_X86_64_NUM 16
602
wdenka2cecab2002-09-30 20:45:01 +0000603/*
604 * XXX - PowerPC defines really don't belong in here,
605 * but we'll put them in for simplicity.
606 */
607
Bin Meng4d216972018-04-11 22:02:12 -0700608/* Values for Elf32/64_Ehdr.e_flags */
609#define EF_PPC_EMB 0x80000000 /* PowerPC embedded flag */
wdenka2cecab2002-09-30 20:45:01 +0000610
Rob Bracero7c8b3252018-07-31 22:57:42 -0400611#define EF_PPC64_ELFV1_ABI 0x00000001
612#define EF_PPC64_ELFV2_ABI 0x00000002
613
wdenka2cecab2002-09-30 20:45:01 +0000614/* Cygnus local bits below */
Bin Meng4d216972018-04-11 22:02:12 -0700615#define EF_PPC_RELOCATABLE 0x00010000 /* PowerPC -mrelocatable flag*/
616#define EF_PPC_RELOCATABLE_LIB 0x00008000 /* PowerPC -mrelocatable-lib
wdenk57b2d802003-06-27 21:31:46 +0000617 flag */
wdenka2cecab2002-09-30 20:45:01 +0000618
619/* PowerPC relocations defined by the ABIs */
Bin Meng4d216972018-04-11 22:02:12 -0700620#define R_PPC_NONE 0
621#define R_PPC_ADDR32 1 /* 32bit absolute address */
622#define R_PPC_ADDR24 2 /* 26bit address, 2 bits ignored */
623#define R_PPC_ADDR16 3 /* 16bit absolute address */
624#define R_PPC_ADDR16_LO 4 /* lower 16bit of absolute address */
625#define R_PPC_ADDR16_HI 5 /* high 16bit of absolute address */
626#define R_PPC_ADDR16_HA 6 /* adjusted high 16bit */
627#define R_PPC_ADDR14 7 /* 16bit address, 2 bits ignored */
628#define R_PPC_ADDR14_BRTAKEN 8
629#define R_PPC_ADDR14_BRNTAKEN 9
630#define R_PPC_REL24 10 /* PC relative 26 bit */
631#define R_PPC_REL14 11 /* PC relative 16 bit */
632#define R_PPC_REL14_BRTAKEN 12
633#define R_PPC_REL14_BRNTAKEN 13
634#define R_PPC_GOT16 14
635#define R_PPC_GOT16_LO 15
636#define R_PPC_GOT16_HI 16
637#define R_PPC_GOT16_HA 17
638#define R_PPC_PLTREL24 18
639#define R_PPC_COPY 19
640#define R_PPC_GLOB_DAT 20
641#define R_PPC_JMP_SLOT 21
642#define R_PPC_RELATIVE 22
643#define R_PPC_LOCAL24PC 23
644#define R_PPC_UADDR32 24
645#define R_PPC_UADDR16 25
646#define R_PPC_REL32 26
647#define R_PPC_PLT32 27
648#define R_PPC_PLTREL32 28
649#define R_PPC_PLT16_LO 29
650#define R_PPC_PLT16_HI 30
651#define R_PPC_PLT16_HA 31
652#define R_PPC_SDAREL16 32
653#define R_PPC_SECTOFF 33
654#define R_PPC_SECTOFF_LO 34
655#define R_PPC_SECTOFF_HI 35
656#define R_PPC_SECTOFF_HA 36
657/* Keep this the last entry */
658#define R_PPC_NUM 37
wdenka2cecab2002-09-30 20:45:01 +0000659
Bin Meng4d216972018-04-11 22:02:12 -0700660/*
661 * The remaining relocs are from the Embedded ELF ABI, and are not
662 * in the SVR4 ELF ABI.
663 */
664#define R_PPC_EMB_NADDR32 101
665#define R_PPC_EMB_NADDR16 102
666#define R_PPC_EMB_NADDR16_LO 103
667#define R_PPC_EMB_NADDR16_HI 104
668#define R_PPC_EMB_NADDR16_HA 105
669#define R_PPC_EMB_SDAI16 106
670#define R_PPC_EMB_SDA2I16 107
671#define R_PPC_EMB_SDA2REL 108
672#define R_PPC_EMB_SDA21 109 /* 16 bit offset in SDA */
673#define R_PPC_EMB_MRKREF 110
674#define R_PPC_EMB_RELSEC16 111
675#define R_PPC_EMB_RELST_LO 112
676#define R_PPC_EMB_RELST_HI 113
677#define R_PPC_EMB_RELST_HA 114
678#define R_PPC_EMB_BIT_FLD 115
679#define R_PPC_EMB_RELSDA 116 /* 16 bit relative offset in SDA */
wdenka2cecab2002-09-30 20:45:01 +0000680
Bin Meng4d216972018-04-11 22:02:12 -0700681/* Diab tool relocations */
682#define R_PPC_DIAB_SDA21_LO 180 /* like EMB_SDA21, but lower 16 bit */
683#define R_PPC_DIAB_SDA21_HI 181 /* like EMB_SDA21, but high 16 bit */
684#define R_PPC_DIAB_SDA21_HA 182 /* like EMB_SDA21, adjusted high 16 */
685#define R_PPC_DIAB_RELSDA_LO 183 /* like EMB_RELSDA, but lower 16 bit */
686#define R_PPC_DIAB_RELSDA_HI 184 /* like EMB_RELSDA, but high 16 bit */
687#define R_PPC_DIAB_RELSDA_HA 185 /* like EMB_RELSDA, adjusted high 16 */
wdenka2cecab2002-09-30 20:45:01 +0000688
Bin Meng4d216972018-04-11 22:02:12 -0700689/*
690 * This is a phony reloc to handle any old fashioned TOC16 references
691 * that may still be in object files.
692 */
693#define R_PPC_TOC16 255
wdenka2cecab2002-09-30 20:45:01 +0000694
Simon Glass631c1a22016-11-07 08:47:09 -0700695 /* ARM relocs */
696#define R_ARM_NONE 0 /* No reloc */
697#define R_ARM_RELATIVE 23 /* Adjust by program base */
698
699/* AArch64 relocs */
Bin Meng4d216972018-04-11 22:02:12 -0700700#define R_AARCH64_NONE 0 /* No relocation */
701#define R_AARCH64_RELATIVE 1027 /* Adjust by program base */
Simon Glass631c1a22016-11-07 08:47:09 -0700702
Rick Chen3301bfc2017-12-26 13:55:58 +0800703/* RISC-V relocations */
704#define R_RISCV_32 1
705#define R_RISCV_64 2
706#define R_RISCV_RELATIVE 3
707
Simon Glass559f1a82020-05-10 11:40:12 -0600708#ifndef __ASSEMBLY__
Maxim Moskaletse4170b82024-06-05 21:43:34 +0300709unsigned long bootelf_exec(ulong (*entry)(int, char * const[]),
710 int argc, char *const argv[]);
711unsigned long bootelf(unsigned long addr, Bootelf_flags flags,
712 int argc, char *const argv[]);
Jeroen Hofsteeb57fb1b2014-10-08 22:58:01 +0200713int valid_elf_image(unsigned long addr);
Keerthy76f361a2020-02-12 13:55:03 +0530714unsigned long load_elf64_image_phdr(unsigned long addr);
715unsigned long load_elf64_image_shdr(unsigned long addr);
716unsigned long load_elf_image_phdr(unsigned long addr);
717unsigned long load_elf_image_shdr(unsigned long addr);
Simon Glass631c1a22016-11-07 08:47:09 -0700718#endif
Jeroen Hofsteeb57fb1b2014-10-08 22:58:01 +0200719
wdenka2cecab2002-09-30 20:45:01 +0000720#endif /* _ELF_H */