2 EFI image format for PE32, PE32+ and TE. Please note some data structures are
3 different for PE32 and PE32+. EFI_IMAGE_NT_HEADERS32 is for PE32 and
4 EFI_IMAGE_NT_HEADERS64 is for PE32+.
6 This file is coded to the Visual Studio, Microsoft Portable Executable and
7 Common Object File Format Specification, Revision 8.3 - February 6, 2013.
8 This file also includes some definitions in PI Specification, Revision 1.0.
10 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
11 Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
12 Portions Copyright (c) 2016 - 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>
14 SPDX-License-Identifier: BSD-2-Clause-Patent
18 #ifndef __PE_IMAGE_H__
19 #define __PE_IMAGE_H__
22 // PE32+ Subsystem type for EFI images
24 #define EFI_IMAGE_SUBSYSTEM_EFI_APPLICATION 10
25 #define EFI_IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER 11
26 #define EFI_IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER 12
27 #define EFI_IMAGE_SUBSYSTEM_SAL_RUNTIME_DRIVER 13 ///< defined PI Specification, 1.0
31 // PE32+ Machine type for EFI images
33 #define IMAGE_FILE_MACHINE_I386 0x014c
34 #define IMAGE_FILE_MACHINE_IA64 0x0200
35 #define IMAGE_FILE_MACHINE_EBC 0x0EBC
36 #define IMAGE_FILE_MACHINE_X64 0x8664
37 #define IMAGE_FILE_MACHINE_ARMTHUMB_MIXED 0x01c2
38 #define IMAGE_FILE_MACHINE_ARM64 0xAA64
39 #define IMAGE_FILE_MACHINE_RISCV32 0x5032
40 #define IMAGE_FILE_MACHINE_RISCV64 0x5064
41 #define IMAGE_FILE_MACHINE_RISCV128 0x5128
46 #define EFI_IMAGE_DOS_SIGNATURE SIGNATURE_16('M', 'Z')
47 #define EFI_IMAGE_OS2_SIGNATURE SIGNATURE_16('N', 'E')
48 #define EFI_IMAGE_OS2_SIGNATURE_LE SIGNATURE_16('L', 'E')
49 #define EFI_IMAGE_NT_SIGNATURE SIGNATURE_32('P', 'E', '\0', '\0')
52 /// PE images can start with an optional DOS header, so if an image is run
53 /// under DOS it can print an error message.
56 UINT16 e_magic
; ///< Magic number.
57 UINT16 e_cblp
; ///< Bytes on last page of file.
58 UINT16 e_cp
; ///< Pages in file.
59 UINT16 e_crlc
; ///< Relocations.
60 UINT16 e_cparhdr
; ///< Size of header in paragraphs.
61 UINT16 e_minalloc
; ///< Minimum extra paragraphs needed.
62 UINT16 e_maxalloc
; ///< Maximum extra paragraphs needed.
63 UINT16 e_ss
; ///< Initial (relative) SS value.
64 UINT16 e_sp
; ///< Initial SP value.
65 UINT16 e_csum
; ///< Checksum.
66 UINT16 e_ip
; ///< Initial IP value.
67 UINT16 e_cs
; ///< Initial (relative) CS value.
68 UINT16 e_lfarlc
; ///< File address of relocation table.
69 UINT16 e_ovno
; ///< Overlay number.
70 UINT16 e_res
[4]; ///< Reserved words.
71 UINT16 e_oemid
; ///< OEM identifier (for e_oeminfo).
72 UINT16 e_oeminfo
; ///< OEM information; e_oemid specific.
73 UINT16 e_res2
[10]; ///< Reserved words.
74 UINT32 e_lfanew
; ///< File address of new exe header.
75 } EFI_IMAGE_DOS_HEADER
;
78 /// COFF File Header (Object and Image).
82 UINT16 NumberOfSections
;
84 UINT32 PointerToSymbolTable
;
85 UINT32 NumberOfSymbols
;
86 UINT16 SizeOfOptionalHeader
;
87 UINT16 Characteristics
;
88 } EFI_IMAGE_FILE_HEADER
;
91 /// Size of EFI_IMAGE_FILE_HEADER.
93 #define EFI_IMAGE_SIZEOF_FILE_HEADER 20
98 #define EFI_IMAGE_FILE_RELOCS_STRIPPED BIT0 ///< 0x0001 Relocation info stripped from file.
99 #define EFI_IMAGE_FILE_EXECUTABLE_IMAGE BIT1 ///< 0x0002 File is executable (i.e. no unresolved externel references).
100 #define EFI_IMAGE_FILE_LINE_NUMS_STRIPPED BIT2 ///< 0x0004 Line numbers stripped from file.
101 #define EFI_IMAGE_FILE_LOCAL_SYMS_STRIPPED BIT3 ///< 0x0008 Local symbols stripped from file.
102 #define EFI_IMAGE_FILE_BYTES_REVERSED_LO BIT7 ///< 0x0080 Bytes of machine word are reversed.
103 #define EFI_IMAGE_FILE_32BIT_MACHINE BIT8 ///< 0x0100 32 bit word machine.
104 #define EFI_IMAGE_FILE_DEBUG_STRIPPED BIT9 ///< 0x0200 Debugging info stripped from file in .DBG file.
105 #define EFI_IMAGE_FILE_SYSTEM BIT12 ///< 0x1000 System File.
106 #define EFI_IMAGE_FILE_DLL BIT13 ///< 0x2000 File is a DLL.
107 #define EFI_IMAGE_FILE_BYTES_REVERSED_HI BIT15 ///< 0x8000 Bytes of machine word are reversed.
110 /// Header Data Directories.
113 UINT32 VirtualAddress
;
115 } EFI_IMAGE_DATA_DIRECTORY
;
120 #define EFI_IMAGE_DIRECTORY_ENTRY_EXPORT 0
121 #define EFI_IMAGE_DIRECTORY_ENTRY_IMPORT 1
122 #define EFI_IMAGE_DIRECTORY_ENTRY_RESOURCE 2
123 #define EFI_IMAGE_DIRECTORY_ENTRY_EXCEPTION 3
124 #define EFI_IMAGE_DIRECTORY_ENTRY_SECURITY 4
125 #define EFI_IMAGE_DIRECTORY_ENTRY_BASERELOC 5
126 #define EFI_IMAGE_DIRECTORY_ENTRY_DEBUG 6
127 #define EFI_IMAGE_DIRECTORY_ENTRY_COPYRIGHT 7
128 #define EFI_IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8
129 #define EFI_IMAGE_DIRECTORY_ENTRY_TLS 9
130 #define EFI_IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10
132 #define EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES 16
136 /// EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC means PE32 and
137 /// EFI_IMAGE_OPTIONAL_HEADER32 must be used. The data structures only vary
138 /// after NT additional fields.
140 #define EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC 0x10b
143 /// Optional Header Standard Fields for PE32.
150 UINT8 MajorLinkerVersion
;
151 UINT8 MinorLinkerVersion
;
153 UINT32 SizeOfInitializedData
;
154 UINT32 SizeOfUninitializedData
;
155 UINT32 AddressOfEntryPoint
;
157 UINT32 BaseOfData
; ///< PE32 contains this additional field, which is absent in PE32+.
159 /// Optional Header Windows-Specific Fields.
162 UINT32 SectionAlignment
;
163 UINT32 FileAlignment
;
164 UINT16 MajorOperatingSystemVersion
;
165 UINT16 MinorOperatingSystemVersion
;
166 UINT16 MajorImageVersion
;
167 UINT16 MinorImageVersion
;
168 UINT16 MajorSubsystemVersion
;
169 UINT16 MinorSubsystemVersion
;
170 UINT32 Win32VersionValue
;
172 UINT32 SizeOfHeaders
;
175 UINT16 DllCharacteristics
;
176 UINT32 SizeOfStackReserve
;
177 UINT32 SizeOfStackCommit
;
178 UINT32 SizeOfHeapReserve
;
179 UINT32 SizeOfHeapCommit
;
181 UINT32 NumberOfRvaAndSizes
;
182 EFI_IMAGE_DATA_DIRECTORY DataDirectory
[EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES
];
183 } EFI_IMAGE_OPTIONAL_HEADER32
;
187 /// EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC means PE32+ and
188 /// EFI_IMAGE_OPTIONAL_HEADER64 must be used. The data structures only vary
189 /// after NT additional fields.
191 #define EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC 0x20b
194 /// Optional Header Standard Fields for PE32+.
201 UINT8 MajorLinkerVersion
;
202 UINT8 MinorLinkerVersion
;
204 UINT32 SizeOfInitializedData
;
205 UINT32 SizeOfUninitializedData
;
206 UINT32 AddressOfEntryPoint
;
209 /// Optional Header Windows-Specific Fields.
212 UINT32 SectionAlignment
;
213 UINT32 FileAlignment
;
214 UINT16 MajorOperatingSystemVersion
;
215 UINT16 MinorOperatingSystemVersion
;
216 UINT16 MajorImageVersion
;
217 UINT16 MinorImageVersion
;
218 UINT16 MajorSubsystemVersion
;
219 UINT16 MinorSubsystemVersion
;
220 UINT32 Win32VersionValue
;
222 UINT32 SizeOfHeaders
;
225 UINT16 DllCharacteristics
;
226 UINT64 SizeOfStackReserve
;
227 UINT64 SizeOfStackCommit
;
228 UINT64 SizeOfHeapReserve
;
229 UINT64 SizeOfHeapCommit
;
231 UINT32 NumberOfRvaAndSizes
;
232 EFI_IMAGE_DATA_DIRECTORY DataDirectory
[EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES
];
233 } EFI_IMAGE_OPTIONAL_HEADER64
;
238 /// EFI_IMAGE_NT_HEADERS32 is for use ONLY by tools.
242 EFI_IMAGE_FILE_HEADER FileHeader
;
243 EFI_IMAGE_OPTIONAL_HEADER32 OptionalHeader
;
244 } EFI_IMAGE_NT_HEADERS32
;
246 #define EFI_IMAGE_SIZEOF_NT_OPTIONAL32_HEADER sizeof (EFI_IMAGE_NT_HEADERS32)
250 /// EFI_IMAGE_HEADERS64 is for use ONLY by tools.
254 EFI_IMAGE_FILE_HEADER FileHeader
;
255 EFI_IMAGE_OPTIONAL_HEADER64 OptionalHeader
;
256 } EFI_IMAGE_NT_HEADERS64
;
258 #define EFI_IMAGE_SIZEOF_NT_OPTIONAL64_HEADER sizeof (EFI_IMAGE_NT_HEADERS64)
261 // Other Windows Subsystem Values
263 #define EFI_IMAGE_SUBSYSTEM_UNKNOWN 0
264 #define EFI_IMAGE_SUBSYSTEM_NATIVE 1
265 #define EFI_IMAGE_SUBSYSTEM_WINDOWS_GUI 2
266 #define EFI_IMAGE_SUBSYSTEM_WINDOWS_CUI 3
267 #define EFI_IMAGE_SUBSYSTEM_OS2_CUI 5
268 #define EFI_IMAGE_SUBSYSTEM_POSIX_CUI 7
271 /// Length of ShortName.
273 #define EFI_IMAGE_SIZEOF_SHORT_NAME 8
276 /// Section Table. This table immediately follows the optional header.
279 UINT8 Name
[EFI_IMAGE_SIZEOF_SHORT_NAME
];
281 UINT32 PhysicalAddress
;
284 UINT32 VirtualAddress
;
285 UINT32 SizeOfRawData
;
286 UINT32 PointerToRawData
;
287 UINT32 PointerToRelocations
;
288 UINT32 PointerToLinenumbers
;
289 UINT16 NumberOfRelocations
;
290 UINT16 NumberOfLinenumbers
;
291 UINT32 Characteristics
;
292 } EFI_IMAGE_SECTION_HEADER
;
295 /// Size of EFI_IMAGE_SECTION_HEADER.
297 #define EFI_IMAGE_SIZEOF_SECTION_HEADER 40
300 // Section Flags Values
302 #define EFI_IMAGE_SCN_TYPE_NO_PAD BIT3 ///< 0x00000008 ///< Reserved.
303 #define EFI_IMAGE_SCN_CNT_CODE BIT5 ///< 0x00000020
304 #define EFI_IMAGE_SCN_CNT_INITIALIZED_DATA BIT6 ///< 0x00000040
305 #define EFI_IMAGE_SCN_CNT_UNINITIALIZED_DATA BIT7 ///< 0x00000080
307 #define EFI_IMAGE_SCN_LNK_OTHER BIT8 ///< 0x00000100 ///< Reserved.
308 #define EFI_IMAGE_SCN_LNK_INFO BIT9 ///< 0x00000200 ///< Section contains comments or some other type of information.
309 #define EFI_IMAGE_SCN_LNK_REMOVE BIT11 ///< 0x00000800 ///< Section contents will not become part of image.
310 #define EFI_IMAGE_SCN_LNK_COMDAT BIT12 ///< 0x00001000
312 #define EFI_IMAGE_SCN_ALIGN_1BYTES BIT20 ///< 0x00100000
313 #define EFI_IMAGE_SCN_ALIGN_2BYTES BIT21 ///< 0x00200000
314 #define EFI_IMAGE_SCN_ALIGN_4BYTES (BIT20|BIT21) ///< 0x00300000
315 #define EFI_IMAGE_SCN_ALIGN_8BYTES BIT22 ///< 0x00400000
316 #define EFI_IMAGE_SCN_ALIGN_16BYTES (BIT20|BIT22) ///< 0x00500000
317 #define EFI_IMAGE_SCN_ALIGN_32BYTES (BIT21|BIT22) ///< 0x00600000
318 #define EFI_IMAGE_SCN_ALIGN_64BYTES (BIT20|BIT21|BIT22) ///< 0x00700000
320 #define EFI_IMAGE_SCN_MEM_DISCARDABLE BIT25 ///< 0x02000000
321 #define EFI_IMAGE_SCN_MEM_NOT_CACHED BIT26 ///< 0x04000000
322 #define EFI_IMAGE_SCN_MEM_NOT_PAGED BIT27 ///< 0x08000000
323 #define EFI_IMAGE_SCN_MEM_SHARED BIT28 ///< 0x10000000
324 #define EFI_IMAGE_SCN_MEM_EXECUTE BIT29 ///< 0x20000000
325 #define EFI_IMAGE_SCN_MEM_READ BIT30 ///< 0x40000000
326 #define EFI_IMAGE_SCN_MEM_WRITE BIT31 ///< 0x80000000
329 /// Size of a Symbol Table Record.
331 #define EFI_IMAGE_SIZEOF_SYMBOL 18
334 // Symbols have a section number of the section in which they are
335 // defined. Otherwise, section numbers have the following meanings:
337 #define EFI_IMAGE_SYM_UNDEFINED (UINT16) 0 ///< Symbol is undefined or is common.
338 #define EFI_IMAGE_SYM_ABSOLUTE (UINT16) -1 ///< Symbol is an absolute value.
339 #define EFI_IMAGE_SYM_DEBUG (UINT16) -2 ///< Symbol is a special debug item.
342 // Symbol Type (fundamental) values.
344 #define EFI_IMAGE_SYM_TYPE_NULL 0 ///< no type.
345 #define EFI_IMAGE_SYM_TYPE_VOID 1 ///< no valid type.
346 #define EFI_IMAGE_SYM_TYPE_CHAR 2 ///< type character.
347 #define EFI_IMAGE_SYM_TYPE_SHORT 3 ///< type short integer.
348 #define EFI_IMAGE_SYM_TYPE_INT 4
349 #define EFI_IMAGE_SYM_TYPE_LONG 5
350 #define EFI_IMAGE_SYM_TYPE_FLOAT 6
351 #define EFI_IMAGE_SYM_TYPE_DOUBLE 7
352 #define EFI_IMAGE_SYM_TYPE_STRUCT 8
353 #define EFI_IMAGE_SYM_TYPE_UNION 9
354 #define EFI_IMAGE_SYM_TYPE_ENUM 10 ///< enumeration.
355 #define EFI_IMAGE_SYM_TYPE_MOE 11 ///< member of enumeration.
356 #define EFI_IMAGE_SYM_TYPE_BYTE 12
357 #define EFI_IMAGE_SYM_TYPE_WORD 13
358 #define EFI_IMAGE_SYM_TYPE_UINT 14
359 #define EFI_IMAGE_SYM_TYPE_DWORD 15
362 // Symbol Type (derived) values.
364 #define EFI_IMAGE_SYM_DTYPE_NULL 0 ///< no derived type.
365 #define EFI_IMAGE_SYM_DTYPE_POINTER 1
366 #define EFI_IMAGE_SYM_DTYPE_FUNCTION 2
367 #define EFI_IMAGE_SYM_DTYPE_ARRAY 3
372 #define EFI_IMAGE_SYM_CLASS_END_OF_FUNCTION ((UINT8) -1)
373 #define EFI_IMAGE_SYM_CLASS_NULL 0
374 #define EFI_IMAGE_SYM_CLASS_AUTOMATIC 1
375 #define EFI_IMAGE_SYM_CLASS_EXTERNAL 2
376 #define EFI_IMAGE_SYM_CLASS_STATIC 3
377 #define EFI_IMAGE_SYM_CLASS_REGISTER 4
378 #define EFI_IMAGE_SYM_CLASS_EXTERNAL_DEF 5
379 #define EFI_IMAGE_SYM_CLASS_LABEL 6
380 #define EFI_IMAGE_SYM_CLASS_UNDEFINED_LABEL 7
381 #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_STRUCT 8
382 #define EFI_IMAGE_SYM_CLASS_ARGUMENT 9
383 #define EFI_IMAGE_SYM_CLASS_STRUCT_TAG 10
384 #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_UNION 11
385 #define EFI_IMAGE_SYM_CLASS_UNION_TAG 12
386 #define EFI_IMAGE_SYM_CLASS_TYPE_DEFINITION 13
387 #define EFI_IMAGE_SYM_CLASS_UNDEFINED_STATIC 14
388 #define EFI_IMAGE_SYM_CLASS_ENUM_TAG 15
389 #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_ENUM 16
390 #define EFI_IMAGE_SYM_CLASS_REGISTER_PARAM 17
391 #define EFI_IMAGE_SYM_CLASS_BIT_FIELD 18
392 #define EFI_IMAGE_SYM_CLASS_BLOCK 100
393 #define EFI_IMAGE_SYM_CLASS_FUNCTION 101
394 #define EFI_IMAGE_SYM_CLASS_END_OF_STRUCT 102
395 #define EFI_IMAGE_SYM_CLASS_FILE 103
396 #define EFI_IMAGE_SYM_CLASS_SECTION 104
397 #define EFI_IMAGE_SYM_CLASS_WEAK_EXTERNAL 105
400 // type packing constants
402 #define EFI_IMAGE_N_BTMASK 017
403 #define EFI_IMAGE_N_TMASK 060
404 #define EFI_IMAGE_N_TMASK1 0300
405 #define EFI_IMAGE_N_TMASK2 0360
406 #define EFI_IMAGE_N_BTSHFT 4
407 #define EFI_IMAGE_N_TSHIFT 2
410 // Communal selection types.
412 #define EFI_IMAGE_COMDAT_SELECT_NODUPLICATES 1
413 #define EFI_IMAGE_COMDAT_SELECT_ANY 2
414 #define EFI_IMAGE_COMDAT_SELECT_SAME_SIZE 3
415 #define EFI_IMAGE_COMDAT_SELECT_EXACT_MATCH 4
416 #define EFI_IMAGE_COMDAT_SELECT_ASSOCIATIVE 5
419 // the following values only be referred in PeCoff, not defined in PECOFF.
421 #define EFI_IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY 1
422 #define EFI_IMAGE_WEAK_EXTERN_SEARCH_LIBRARY 2
423 #define EFI_IMAGE_WEAK_EXTERN_SEARCH_ALIAS 3
426 /// Relocation format.
429 UINT32 VirtualAddress
;
430 UINT32 SymbolTableIndex
;
432 } EFI_IMAGE_RELOCATION
;
435 /// Size of EFI_IMAGE_RELOCATION
437 #define EFI_IMAGE_SIZEOF_RELOCATION 10
440 // I386 relocation types.
442 #define EFI_IMAGE_REL_I386_ABSOLUTE 0x0000 ///< Reference is absolute, no relocation is necessary.
443 #define EFI_IMAGE_REL_I386_DIR16 0x0001 ///< Direct 16-bit reference to the symbols virtual address.
444 #define EFI_IMAGE_REL_I386_REL16 0x0002 ///< PC-relative 16-bit reference to the symbols virtual address.
445 #define EFI_IMAGE_REL_I386_DIR32 0x0006 ///< Direct 32-bit reference to the symbols virtual address.
446 #define EFI_IMAGE_REL_I386_DIR32NB 0x0007 ///< Direct 32-bit reference to the symbols virtual address, base not included.
447 #define EFI_IMAGE_REL_I386_SEG12 0x0009 ///< Direct 16-bit reference to the segment-selector bits of a 32-bit virtual address.
448 #define EFI_IMAGE_REL_I386_SECTION 0x000A
449 #define EFI_IMAGE_REL_I386_SECREL 0x000B
450 #define EFI_IMAGE_REL_I386_REL32 0x0014 ///< PC-relative 32-bit reference to the symbols virtual address.
453 // x64 processor relocation types.
455 #define IMAGE_REL_AMD64_ABSOLUTE 0x0000
456 #define IMAGE_REL_AMD64_ADDR64 0x0001
457 #define IMAGE_REL_AMD64_ADDR32 0x0002
458 #define IMAGE_REL_AMD64_ADDR32NB 0x0003
459 #define IMAGE_REL_AMD64_REL32 0x0004
460 #define IMAGE_REL_AMD64_REL32_1 0x0005
461 #define IMAGE_REL_AMD64_REL32_2 0x0006
462 #define IMAGE_REL_AMD64_REL32_3 0x0007
463 #define IMAGE_REL_AMD64_REL32_4 0x0008
464 #define IMAGE_REL_AMD64_REL32_5 0x0009
465 #define IMAGE_REL_AMD64_SECTION 0x000A
466 #define IMAGE_REL_AMD64_SECREL 0x000B
467 #define IMAGE_REL_AMD64_SECREL7 0x000C
468 #define IMAGE_REL_AMD64_TOKEN 0x000D
469 #define IMAGE_REL_AMD64_SREL32 0x000E
470 #define IMAGE_REL_AMD64_PAIR 0x000F
471 #define IMAGE_REL_AMD64_SSPAN32 0x0010
474 /// Based relocation format.
477 UINT32 VirtualAddress
;
479 } EFI_IMAGE_BASE_RELOCATION
;
482 /// Size of EFI_IMAGE_BASE_RELOCATION.
484 #define EFI_IMAGE_SIZEOF_BASE_RELOCATION 8
487 // Based relocation types.
489 #define EFI_IMAGE_REL_BASED_ABSOLUTE 0
490 #define EFI_IMAGE_REL_BASED_HIGH 1
491 #define EFI_IMAGE_REL_BASED_LOW 2
492 #define EFI_IMAGE_REL_BASED_HIGHLOW 3
493 #define EFI_IMAGE_REL_BASED_HIGHADJ 4
494 #define EFI_IMAGE_REL_BASED_MIPS_JMPADDR 5
495 #define EFI_IMAGE_REL_BASED_ARM_MOV32A 5
496 #define EFI_IMAGE_REL_BASED_ARM_MOV32T 7
497 #define EFI_IMAGE_REL_BASED_IA64_IMM64 9
498 #define EFI_IMAGE_REL_BASED_MIPS_JMPADDR16 9
499 #define EFI_IMAGE_REL_BASED_DIR64 10
502 /// Relocation types of RISC-V processor.
504 #define EFI_IMAGE_REL_BASED_RISCV_HI20 5
505 #define EFI_IMAGE_REL_BASED_RISCV_LOW12I 7
506 #define EFI_IMAGE_REL_BASED_RISCV_LOW12S 8
509 /// Line number format.
513 UINT32 SymbolTableIndex
; ///< Symbol table index of function name if Linenumber is 0.
514 UINT32 VirtualAddress
; ///< Virtual address of line number.
516 UINT16 Linenumber
; ///< Line number.
517 } EFI_IMAGE_LINENUMBER
;
520 /// Size of EFI_IMAGE_LINENUMBER.
522 #define EFI_IMAGE_SIZEOF_LINENUMBER 6
527 #define EFI_IMAGE_ARCHIVE_START_SIZE 8
528 #define EFI_IMAGE_ARCHIVE_START "!<arch>\n"
529 #define EFI_IMAGE_ARCHIVE_END "`\n"
530 #define EFI_IMAGE_ARCHIVE_PAD "\n"
531 #define EFI_IMAGE_ARCHIVE_LINKER_MEMBER "/ "
532 #define EFI_IMAGE_ARCHIVE_LONGNAMES_MEMBER "// "
535 /// Archive Member Headers
538 UINT8 Name
[16]; ///< File member name - `/' terminated.
539 UINT8 Date
[12]; ///< File member date - decimal.
540 UINT8 UserID
[6]; ///< File member user id - decimal.
541 UINT8 GroupID
[6]; ///< File member group id - decimal.
542 UINT8 Mode
[8]; ///< File member mode - octal.
543 UINT8 Size
[10]; ///< File member size - decimal.
544 UINT8 EndHeader
[2]; ///< String to end header. (0x60 0x0A).
545 } EFI_IMAGE_ARCHIVE_MEMBER_HEADER
;
548 /// Size of EFI_IMAGE_ARCHIVE_MEMBER_HEADER.
550 #define EFI_IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR 60
558 /// Export Directory Table.
561 UINT32 Characteristics
;
562 UINT32 TimeDateStamp
;
567 UINT32 NumberOfFunctions
;
568 UINT32 NumberOfNames
;
569 UINT32 AddressOfFunctions
;
570 UINT32 AddressOfNames
;
571 UINT32 AddressOfNameOrdinals
;
572 } EFI_IMAGE_EXPORT_DIRECTORY
;
580 } EFI_IMAGE_IMPORT_BY_NAME
;
583 /// Import Address Table RVA (Thunk Table).
589 EFI_IMAGE_IMPORT_BY_NAME
*AddressOfData
;
591 } EFI_IMAGE_THUNK_DATA
;
593 #define EFI_IMAGE_ORDINAL_FLAG BIT31 ///< Flag for PE32.
594 #define EFI_IMAGE_SNAP_BY_ORDINAL(Ordinal) ((Ordinal & EFI_IMAGE_ORDINAL_FLAG) != 0)
595 #define EFI_IMAGE_ORDINAL(Ordinal) (Ordinal & 0xffff)
598 /// Import Directory Table
601 UINT32 Characteristics
;
602 UINT32 TimeDateStamp
;
603 UINT32 ForwarderChain
;
605 EFI_IMAGE_THUNK_DATA
*FirstThunk
;
606 } EFI_IMAGE_IMPORT_DESCRIPTOR
;
610 /// Debug Directory Format.
613 UINT32 Characteristics
;
614 UINT32 TimeDateStamp
;
619 UINT32 RVA
; ///< The address of the debug data when loaded, relative to the image base.
620 UINT32 FileOffset
; ///< The file pointer to the debug data.
621 } EFI_IMAGE_DEBUG_DIRECTORY_ENTRY
;
623 #define EFI_IMAGE_DEBUG_TYPE_CODEVIEW 2 ///< The Visual C++ debug information.
626 /// Debug Data Structure defined in Microsoft C++.
628 #define CODEVIEW_SIGNATURE_NB10 SIGNATURE_32('N', 'B', '1', '0')
630 UINT32 Signature
; ///< "NB10"
635 // Filename of .PDB goes here
637 } EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY
;
640 /// Debug Data Structure defined in Microsoft C++.
642 #define CODEVIEW_SIGNATURE_RSDS SIGNATURE_32('R', 'S', 'D', 'S')
644 UINT32 Signature
; ///< "RSDS".
651 // Filename of .PDB goes here
653 } EFI_IMAGE_DEBUG_CODEVIEW_RSDS_ENTRY
;
657 /// Debug Data Structure defined by Apple Mach-O to Coff utility.
659 #define CODEVIEW_SIGNATURE_MTOC SIGNATURE_32('M', 'T', 'O', 'C')
661 UINT32 Signature
; ///< "MTOC".
664 // Filename of .DLL (Mach-O with debug info) goes here
666 } EFI_IMAGE_DEBUG_CODEVIEW_MTOC_ENTRY
;
672 UINT32 Characteristics
;
673 UINT32 TimeDateStamp
;
676 UINT16 NumberOfNamedEntries
;
677 UINT16 NumberOfIdEntries
;
679 // Array of EFI_IMAGE_RESOURCE_DIRECTORY_ENTRY entries goes here.
681 } EFI_IMAGE_RESOURCE_DIRECTORY
;
684 /// Resource directory entry format.
689 UINT32 NameOffset
:31;
690 UINT32 NameIsString
:1;
697 UINT32 OffsetToDirectory
:31;
698 UINT32 DataIsDirectory
:1;
701 } EFI_IMAGE_RESOURCE_DIRECTORY_ENTRY
;
704 /// Resource directory entry for string.
709 } EFI_IMAGE_RESOURCE_DIRECTORY_STRING
;
712 /// Resource directory entry for data array.
719 } EFI_IMAGE_RESOURCE_DATA_ENTRY
;
722 /// Header format for TE images, defined in the PI Specification, 1.0.
725 UINT16 Signature
; ///< The signature for TE format = "VZ".
726 UINT16 Machine
; ///< From the original file header.
727 UINT8 NumberOfSections
; ///< From the original file header.
728 UINT8 Subsystem
; ///< From original optional header.
729 UINT16 StrippedSize
; ///< Number of bytes we removed from the header.
730 UINT32 AddressOfEntryPoint
; ///< Offset to entry point -- from original optional header.
731 UINT32 BaseOfCode
; ///< From original image -- required for ITP debug.
732 UINT64 ImageBase
; ///< From original file header.
733 EFI_IMAGE_DATA_DIRECTORY DataDirectory
[2]; ///< Only base relocation and debug directory.
734 } EFI_TE_IMAGE_HEADER
;
737 #define EFI_TE_IMAGE_HEADER_SIGNATURE SIGNATURE_16('V', 'Z')
740 // Data directory indexes in our TE image header
742 #define EFI_TE_IMAGE_DIRECTORY_ENTRY_BASERELOC 0
743 #define EFI_TE_IMAGE_DIRECTORY_ENTRY_DEBUG 1
747 /// Union of PE32, PE32+, and TE headers.
750 EFI_IMAGE_NT_HEADERS32 Pe32
;
751 EFI_IMAGE_NT_HEADERS64 Pe32Plus
;
752 EFI_TE_IMAGE_HEADER Te
;
753 } EFI_IMAGE_OPTIONAL_HEADER_UNION
;
756 EFI_IMAGE_NT_HEADERS32
*Pe32
;
757 EFI_IMAGE_NT_HEADERS64
*Pe32Plus
;
758 EFI_TE_IMAGE_HEADER
*Te
;
759 EFI_IMAGE_OPTIONAL_HEADER_UNION
*Union
;
760 } EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION
;