123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752 |
- /** @file
- EFI image format for PE32, PE32+ and TE. Please note some data structures are
- different for PE32 and PE32+. EFI_IMAGE_NT_HEADERS32 is for PE32 and
- EFI_IMAGE_NT_HEADERS64 is for PE32+.
-
- This file is coded to the Visual Studio, Microsoft Portable Executable and
- Common Object File Format Specification, Revision 8.0 - May 16, 2006.
- This file also includes some definitions in PI Specification, Revision 1.0.
-
- Copyright (c) 2006 - 2008, Intel Corporation
- All rights reserved. This program and the accompanying materials
- are licensed and made available under the terms and conditions of the BSD License
- which accompanies this distribution. The full text of the license may be found at
- http://opensource.org/licenses/bsd-license.php
-
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
-
- **/
-
- #ifndef __PE_IMAGE_H__
- #define __PE_IMAGE_H__
-
- ///
- /// PE32+ Subsystem type for EFI images
- ///
- #define EFI_IMAGE_SUBSYSTEM_EFI_APPLICATION 10
- #define EFI_IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER 11
- #define EFI_IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER 12
- #define EFI_IMAGE_SUBSYSTEM_EFI_EFI_ROM 13
-
- #define EFI_IMAGE_SUBSYSTEM_SAL_RUNTIME_DRIVER 13 ///< defined PI Specification, 1.0
-
-
- ///
- /// PE32+ Machine type for EFI images
- ///
- #define IMAGE_FILE_MACHINE_I386 0x014c
- #define IMAGE_FILE_MACHINE_IA64 0x0200
- #define IMAGE_FILE_MACHINE_EBC 0x0EBC
- #define IMAGE_FILE_MACHINE_X64 0x8664
- //
- // Support old names for backward compatible
- //
- #define EFI_IMAGE_MACHINE_IA32 IMAGE_FILE_MACHINE_I386
- #define EFI_IMAGE_MACHINE_IA64 IMAGE_FILE_MACHINE_IA64
- #define EFI_IMAGE_MACHINE_IPF IMAGE_FILE_MACHINE_IA64
- #define EFI_IMAGE_MACHINE_EBC IMAGE_FILE_MACHINE_EBC
- #define EFI_IMAGE_MACHINE_X64 IMAGE_FILE_MACHINE_X64
-
- ///
- /// EXE file formats
- ///
- #define EFI_IMAGE_DOS_SIGNATURE SIGNATURE_16('M', 'Z')
- #define EFI_IMAGE_OS2_SIGNATURE SIGNATURE_16('N', 'E')
- #define EFI_IMAGE_OS2_SIGNATURE_LE SIGNATURE_16('L', 'E')
- #define EFI_IMAGE_NT_SIGNATURE SIGNATURE_32('P', 'E', '\0', '\0')
-
- ///
- /// PE images can start with an optional DOS header, so if an image is run
- /// under DOS it can print an error message.
- ///
- typedef struct {
- UINT16 e_magic; ///< Magic number
- UINT16 e_cblp; ///< Bytes on last page of file
- UINT16 e_cp; ///< Pages in file
- UINT16 e_crlc; ///< Relocations
- UINT16 e_cparhdr; ///< Size of header in paragraphs
- UINT16 e_minalloc; ///< Minimum extra paragraphs needed
- UINT16 e_maxalloc; ///< Maximum extra paragraphs needed
- UINT16 e_ss; ///< Initial (relative) SS value
- UINT16 e_sp; ///< Initial SP value
- UINT16 e_csum; ///< Checksum
- UINT16 e_ip; ///< Initial IP value
- UINT16 e_cs; ///< Initial (relative) CS value
- UINT16 e_lfarlc; ///< File address of relocation table
- UINT16 e_ovno; ///< Overlay number
- UINT16 e_res[4]; ///< Reserved words
- UINT16 e_oemid; ///< OEM identifier (for e_oeminfo)
- UINT16 e_oeminfo; ///< OEM information; e_oemid specific
- UINT16 e_res2[10]; ///< Reserved words
- UINT32 e_lfanew; ///< File address of new exe header
- } EFI_IMAGE_DOS_HEADER;
-
- ///
- /// COFF File Header (Object and Image)
- ///
- typedef struct {
- UINT16 Machine;
- UINT16 NumberOfSections;
- UINT32 TimeDateStamp;
- UINT32 PointerToSymbolTable;
- UINT32 NumberOfSymbols;
- UINT16 SizeOfOptionalHeader;
- UINT16 Characteristics;
- } EFI_IMAGE_FILE_HEADER;
-
- ///
- /// Size of EFI_IMAGE_FILE_HEADER
- ///
- #define EFI_IMAGE_SIZEOF_FILE_HEADER 20
-
- ///
- /// Characteristics
- ///
- #define EFI_IMAGE_FILE_RELOCS_STRIPPED BIT0 ///< 0x0001 Relocation info stripped from file.
- #define EFI_IMAGE_FILE_EXECUTABLE_IMAGE BIT1 ///< 0x0002 File is executable (i.e. no unresolved externel references).
- #define EFI_IMAGE_FILE_LINE_NUMS_STRIPPED BIT2 ///< 0x0004 Line nunbers stripped from file.
- #define EFI_IMAGE_FILE_LOCAL_SYMS_STRIPPED BIT3 ///< 0x0008 Local symbols stripped from file.
- #define EFI_IMAGE_FILE_BYTES_REVERSED_LO BIT7 ///< 0x0080 Bytes of machine word are reversed.
- #define EFI_IMAGE_FILE_32BIT_MACHINE BIT8 ///< 0x0100 32 bit word machine.
- #define EFI_IMAGE_FILE_DEBUG_STRIPPED BIT9 ///< 0x0200 Debugging info stripped from file in .DBG file
- #define EFI_IMAGE_FILE_SYSTEM BIT12 ///< 0x1000 System File.
- #define EFI_IMAGE_FILE_DLL BIT13 ///< 0x2000 File is a DLL.
- #define EFI_IMAGE_FILE_BYTES_REVERSED_HI BIT15 ///< 0x8000 Bytes of machine word are reversed.
-
- ///
- /// Other Machine Types
- ///
- #define EFI_IMAGE_FILE_MACHINE_UNKNOWN 0 ///< Any machine type
- #define EFI_IMAGE_FILE_MACHINE_I386 0x14c ///< Intel 386.
- #define EFI_IMAGE_FILE_MACHINE_R3000 0x162 ///< MIPS* little-endian, 0540 big-endian
- #define EFI_IMAGE_FILE_MACHINE_R4000 0x166 ///< MIPS* little-endian
- #define EFI_IMAGE_FILE_MACHINE_POWERPC 0x1F0 ///< IBM* PowerPC Little-Endian
- //
- // * Other names and brands may be claimed as the property of others.
- //
-
- ///
- /// Header Data Directories
- ///
- typedef struct {
- UINT32 VirtualAddress;
- UINT32 Size;
- } EFI_IMAGE_DATA_DIRECTORY;
-
- #define EFI_IMAGE_ROM_OPTIONAL_HDR_MAGIC 0x107
-
- ///
- /// Directory Entries
- ///
- #define EFI_IMAGE_DIRECTORY_ENTRY_EXPORT 0
- #define EFI_IMAGE_DIRECTORY_ENTRY_IMPORT 1
- #define EFI_IMAGE_DIRECTORY_ENTRY_RESOURCE 2
- #define EFI_IMAGE_DIRECTORY_ENTRY_EXCEPTION 3
- #define EFI_IMAGE_DIRECTORY_ENTRY_SECURITY 4
- #define EFI_IMAGE_DIRECTORY_ENTRY_BASERELOC 5
- #define EFI_IMAGE_DIRECTORY_ENTRY_DEBUG 6
- #define EFI_IMAGE_DIRECTORY_ENTRY_COPYRIGHT 7
- #define EFI_IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8
- #define EFI_IMAGE_DIRECTORY_ENTRY_TLS 9
- #define EFI_IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10
-
- #define EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES 16
-
- ///
- /// @attention
- /// EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC means PE32 and
- /// EFI_IMAGE_OPTIONAL_HEADER32 must be used. The data structures only vary
- /// after NT additional fields.
- ///
- #define EFI_IMAGE_NT_OPTIONAL_HDR32_MAGIC 0x10b
-
- typedef struct {
- ///
- /// Standard fields.
- ///
- UINT16 Magic;
- UINT8 MajorLinkerVersion;
- UINT8 MinorLinkerVersion;
- UINT32 SizeOfCode;
- UINT32 SizeOfInitializedData;
- UINT32 SizeOfUninitializedData;
- UINT32 AddressOfEntryPoint;
- UINT32 BaseOfCode;
- UINT32 BaseOfData; ///< PE32 contains this additional field, which is absent in PE32+
- ///
- /// NT additional fields.
- ///
- UINT32 ImageBase;
- UINT32 SectionAlignment;
- UINT32 FileAlignment;
- UINT16 MajorOperatingSystemVersion;
- UINT16 MinorOperatingSystemVersion;
- UINT16 MajorImageVersion;
- UINT16 MinorImageVersion;
- UINT16 MajorSubsystemVersion;
- UINT16 MinorSubsystemVersion;
- UINT32 Win32VersionValue;
- UINT32 SizeOfImage;
- UINT32 SizeOfHeaders;
- UINT32 CheckSum;
- UINT16 Subsystem;
- UINT16 DllCharacteristics;
- UINT32 SizeOfStackReserve;
- UINT32 SizeOfStackCommit;
- UINT32 SizeOfHeapReserve;
- UINT32 SizeOfHeapCommit;
- UINT32 LoaderFlags;
- UINT32 NumberOfRvaAndSizes;
- EFI_IMAGE_DATA_DIRECTORY DataDirectory[EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES];
- } EFI_IMAGE_OPTIONAL_HEADER32;
-
- ///
- /// @attention
- /// EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC means PE32+ and
- /// EFI_IMAGE_OPTIONAL_HEADER64 must be used. The data structures only vary
- /// after NT additional fields.
- ///
- #define EFI_IMAGE_NT_OPTIONAL_HDR64_MAGIC 0x20b
-
- typedef struct {
- //
- // Standard fields.
- //
- UINT16 Magic;
- UINT8 MajorLinkerVersion;
- UINT8 MinorLinkerVersion;
- UINT32 SizeOfCode;
- UINT32 SizeOfInitializedData;
- UINT32 SizeOfUninitializedData;
- UINT32 AddressOfEntryPoint;
- UINT32 BaseOfCode;
- //
- // NT additional fields.
- //
- UINT64 ImageBase;
- UINT32 SectionAlignment;
- UINT32 FileAlignment;
- UINT16 MajorOperatingSystemVersion;
- UINT16 MinorOperatingSystemVersion;
- UINT16 MajorImageVersion;
- UINT16 MinorImageVersion;
- UINT16 MajorSubsystemVersion;
- UINT16 MinorSubsystemVersion;
- UINT32 Win32VersionValue;
- UINT32 SizeOfImage;
- UINT32 SizeOfHeaders;
- UINT32 CheckSum;
- UINT16 Subsystem;
- UINT16 DllCharacteristics;
- UINT64 SizeOfStackReserve;
- UINT64 SizeOfStackCommit;
- UINT64 SizeOfHeapReserve;
- UINT64 SizeOfHeapCommit;
- UINT32 LoaderFlags;
- UINT32 NumberOfRvaAndSizes;
- EFI_IMAGE_DATA_DIRECTORY DataDirectory[EFI_IMAGE_NUMBER_OF_DIRECTORY_ENTRIES];
- } EFI_IMAGE_OPTIONAL_HEADER64;
-
-
- ///
- /// @attention
- /// EFI_IMAGE_NT_HEADERS32 and EFI_IMAGE_HEADERS64 are for use ONLY
- /// by tools. All proper EFI code MUST use EFI_IMAGE_NT_HEADERS ONLY!!!
- ///
- typedef struct {
- UINT32 Signature;
- EFI_IMAGE_FILE_HEADER FileHeader;
- EFI_IMAGE_OPTIONAL_HEADER32 OptionalHeader;
- } EFI_IMAGE_NT_HEADERS32;
-
- #define EFI_IMAGE_SIZEOF_NT_OPTIONAL32_HEADER sizeof (EFI_IMAGE_NT_HEADERS32)
-
- typedef struct {
- UINT32 Signature;
- EFI_IMAGE_FILE_HEADER FileHeader;
- EFI_IMAGE_OPTIONAL_HEADER64 OptionalHeader;
- } EFI_IMAGE_NT_HEADERS64;
-
- #define EFI_IMAGE_SIZEOF_NT_OPTIONAL64_HEADER sizeof (EFI_IMAGE_NT_HEADERS64)
-
-
- ///
- /// Processor specific definition of EFI_IMAGE_OPTIONAL_HEADER so the
- /// type name EFI_IMAGE_OPTIONAL_HEADER is appropriate to the build. Same for
- /// EFI_IMAGE_NT_HEADERS. These definitions MUST be used by ALL EFI code.
- ///
- #if defined (MDE_CPU_IA32)
-
- #define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \
- (((Machine) == EFI_IMAGE_MACHINE_IA32) || ((Machine) == EFI_IMAGE_MACHINE_EBC))
-
- #define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_X64)
-
- typedef EFI_IMAGE_NT_HEADERS32 EFI_IMAGE_NT_HEADERS;
-
- #elif defined (MDE_CPU_IPF)
-
- #define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \
- (((Machine) == EFI_IMAGE_MACHINE_IPF) || ((Machine) == EFI_IMAGE_MACHINE_EBC))
-
- #define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)
-
- typedef EFI_IMAGE_NT_HEADERS64 EFI_IMAGE_NT_HEADERS;
-
- #elif defined (MDE_CPU_X64)
-
- #define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \
- (((Machine) == EFI_IMAGE_MACHINE_X64) || ((Machine) == EFI_IMAGE_MACHINE_EBC))
-
- #define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_IA32)
-
- typedef EFI_IMAGE_NT_HEADERS64 EFI_IMAGE_NT_HEADERS;
-
- #elif defined (MDE_CPU_EBC)
-
- ///
- /// This is just to make sure you can cross compile with the EBC compiiler.
- /// It does not make sense to have a PE loader coded in EBC. You need to
- /// understand the basic
- ///
- #define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_EBC)
-
- #define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)
-
- typedef EFI_IMAGE_NT_HEADERS64 EFI_IMAGE_NT_HEADERS;
-
- #else
- #error Unknown Processor Type
- #endif
-
-
- #define EFI_IMAGE_FIRST_SECTION(ntheader) \
- ( \
- (EFI_IMAGE_SECTION_HEADER *) \
- ( \
- (UINT32) ntheader + \
- FIELD_OFFSET (EFI_IMAGE_NT_HEADERS, OptionalHeader) + \
- ((EFI_IMAGE_NT_HEADERS *) (ntheader))->FileHeader.SizeOfOptionalHeader \
- ) \
- )
-
- ///
- /// Other Windows Subsystem Values
- ///
- #define EFI_IMAGE_SUBSYSTEM_UNKNOWN 0
- #define EFI_IMAGE_SUBSYSTEM_NATIVE 1
- #define EFI_IMAGE_SUBSYSTEM_WINDOWS_GUI 2
- #define EFI_IMAGE_SUBSYSTEM_WINDOWS_CUI 3
- #define EFI_IMAGE_SUBSYSTEM_OS2_CUI 5
- #define EFI_IMAGE_SUBSYSTEM_POSIX_CUI 7
-
- ///
- /// Section header format.
- ///
- #define EFI_IMAGE_SIZEOF_SHORT_NAME 8
-
- typedef struct {
- UINT8 Name[EFI_IMAGE_SIZEOF_SHORT_NAME];
- union {
- UINT32 PhysicalAddress;
- UINT32 VirtualSize;
- } Misc;
- UINT32 VirtualAddress;
- UINT32 SizeOfRawData;
- UINT32 PointerToRawData;
- UINT32 PointerToRelocations;
- UINT32 PointerToLinenumbers;
- UINT16 NumberOfRelocations;
- UINT16 NumberOfLinenumbers;
- UINT32 Characteristics;
- } EFI_IMAGE_SECTION_HEADER;
-
- ///
- /// Size of EFI_IMAGE_SECTION_HEADER
- ///
- #define EFI_IMAGE_SIZEOF_SECTION_HEADER 40
-
- ///
- /// Section Flags Values
- ///
- #define EFI_IMAGE_SCN_TYPE_NO_PAD BIT3 ///< 0x00000008 ///< Reserved.
- #define EFI_IMAGE_SCN_CNT_CODE BIT5 ///< 0x00000020
- #define EFI_IMAGE_SCN_CNT_INITIALIZED_DATA BIT6 ///< 0x00000040
- #define EFI_IMAGE_SCN_CNT_UNINITIALIZED_DATA BIT7 ///< 0x00000080
-
- #define EFI_IMAGE_SCN_LNK_OTHER BIT8 ///< 0x00000100 ///< Reserved.
- #define EFI_IMAGE_SCN_LNK_INFO BIT9 ///< 0x00000200 ///< Section contains comments or some other type of information.
- #define EFI_IMAGE_SCN_LNK_REMOVE BIT10 ///< 0x00000800 ///< Section contents will not become part of image.
- #define EFI_IMAGE_SCN_LNK_COMDAT BIT12 ///< 0x00001000
-
- #define EFI_IMAGE_SCN_ALIGN_1BYTES BIT20 ///< 0x00100000
- #define EFI_IMAGE_SCN_ALIGN_2BYTES BIT21 ///< 0x00200000
- #define EFI_IMAGE_SCN_ALIGN_4BYTES (BIT20|BIT21) ///< 0x00300000
- #define EFI_IMAGE_SCN_ALIGN_8BYTES BIT22 ///< 0x00400000
- #define EFI_IMAGE_SCN_ALIGN_16BYTES (BIT20|BIT22) ///< 0x00500000
- #define EFI_IMAGE_SCN_ALIGN_32BYTES (BIT21|BIT22) ///< 0x00600000
- #define EFI_IMAGE_SCN_ALIGN_64BYTES (BIT20|BIT21|BIT22) ///< 0x00700000
-
- #define EFI_IMAGE_SCN_MEM_DISCARDABLE BIT25 ///< 0x02000000
- #define EFI_IMAGE_SCN_MEM_NOT_CACHED BIT26 ///< 0x04000000
- #define EFI_IMAGE_SCN_MEM_NOT_PAGED BIT27 ///< 0x08000000
- #define EFI_IMAGE_SCN_MEM_SHARED BIT28 ///< 0x10000000
- #define EFI_IMAGE_SCN_MEM_EXECUTE BIT29 ///< 0x20000000
- #define EFI_IMAGE_SCN_MEM_READ BIT30 ///< 0x40000000
- #define EFI_IMAGE_SCN_MEM_WRITE BIT31 ///< 0x80000000
-
- ///
- /// Size of a Symbol Table Record
- ///
- #define EFI_IMAGE_SIZEOF_SYMBOL 18
-
- ///
- /// Symbols have a section number of the section in which they are
- /// defined. Otherwise, section numbers have the following meanings:
- ///
- #define EFI_IMAGE_SYM_UNDEFINED (UINT16) 0 ///< Symbol is undefined or is common.
- #define EFI_IMAGE_SYM_ABSOLUTE (UINT16) -1 ///< Symbol is an absolute value.
- #define EFI_IMAGE_SYM_DEBUG (UINT16) -2 ///< Symbol is a special debug item.
-
- ///
- /// Symbol Type (fundamental) values.
- ///
- #define EFI_IMAGE_SYM_TYPE_NULL 0 ///< no type.
- #define EFI_IMAGE_SYM_TYPE_VOID 1 ///< no valid type.
- #define EFI_IMAGE_SYM_TYPE_CHAR 2 ///< type character.
- #define EFI_IMAGE_SYM_TYPE_SHORT 3 ///< type short integer.
- #define EFI_IMAGE_SYM_TYPE_INT 4
- #define EFI_IMAGE_SYM_TYPE_LONG 5
- #define EFI_IMAGE_SYM_TYPE_FLOAT 6
- #define EFI_IMAGE_SYM_TYPE_DOUBLE 7
- #define EFI_IMAGE_SYM_TYPE_STRUCT 8
- #define EFI_IMAGE_SYM_TYPE_UNION 9
- #define EFI_IMAGE_SYM_TYPE_ENUM 10 ///< enumeration.
- #define EFI_IMAGE_SYM_TYPE_MOE 11 ///< member of enumeration.
- #define EFI_IMAGE_SYM_TYPE_BYTE 12
- #define EFI_IMAGE_SYM_TYPE_WORD 13
- #define EFI_IMAGE_SYM_TYPE_UINT 14
- #define EFI_IMAGE_SYM_TYPE_DWORD 15
-
- ///
- /// Symbol Type (derived) values.
- ///
- #define EFI_IMAGE_SYM_DTYPE_NULL 0 ///< no derived type.
- #define EFI_IMAGE_SYM_DTYPE_POINTER 1
- #define EFI_IMAGE_SYM_DTYPE_FUNCTION 2
- #define EFI_IMAGE_SYM_DTYPE_ARRAY 3
-
- ///
- /// Storage classes.
- ///
- #define EFI_IMAGE_SYM_CLASS_END_OF_FUNCTION ((UINT8) -1)
- #define EFI_IMAGE_SYM_CLASS_NULL 0
- #define EFI_IMAGE_SYM_CLASS_AUTOMATIC 1
- #define EFI_IMAGE_SYM_CLASS_EXTERNAL 2
- #define EFI_IMAGE_SYM_CLASS_STATIC 3
- #define EFI_IMAGE_SYM_CLASS_REGISTER 4
- #define EFI_IMAGE_SYM_CLASS_EXTERNAL_DEF 5
- #define EFI_IMAGE_SYM_CLASS_LABEL 6
- #define EFI_IMAGE_SYM_CLASS_UNDEFINED_LABEL 7
- #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_STRUCT 8
- #define EFI_IMAGE_SYM_CLASS_ARGUMENT 9
- #define EFI_IMAGE_SYM_CLASS_STRUCT_TAG 10
- #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_UNION 11
- #define EFI_IMAGE_SYM_CLASS_UNION_TAG 12
- #define EFI_IMAGE_SYM_CLASS_TYPE_DEFINITION 13
- #define EFI_IMAGE_SYM_CLASS_UNDEFINED_STATIC 14
- #define EFI_IMAGE_SYM_CLASS_ENUM_TAG 15
- #define EFI_IMAGE_SYM_CLASS_MEMBER_OF_ENUM 16
- #define EFI_IMAGE_SYM_CLASS_REGISTER_PARAM 17
- #define EFI_IMAGE_SYM_CLASS_BIT_FIELD 18
- #define EFI_IMAGE_SYM_CLASS_BLOCK 100
- #define EFI_IMAGE_SYM_CLASS_FUNCTION 101
- #define EFI_IMAGE_SYM_CLASS_END_OF_STRUCT 102
- #define EFI_IMAGE_SYM_CLASS_FILE 103
- #define EFI_IMAGE_SYM_CLASS_SECTION 104
- #define EFI_IMAGE_SYM_CLASS_WEAK_EXTERNAL 105
-
- //
- // type packing constants
- //
- #define EFI_IMAGE_N_BTMASK 017
- #define EFI_IMAGE_N_TMASK 060
- #define EFI_IMAGE_N_TMASK1 0300
- #define EFI_IMAGE_N_TMASK2 0360
- #define EFI_IMAGE_N_BTSHFT 4
- #define EFI_IMAGE_N_TSHIFT 2
-
- ///
- /// Communal selection types.
- ///
- #define EFI_IMAGE_COMDAT_SELECT_NODUPLICATES 1
- #define EFI_IMAGE_COMDAT_SELECT_ANY 2
- #define EFI_IMAGE_COMDAT_SELECT_SAME_SIZE 3
- #define EFI_IMAGE_COMDAT_SELECT_EXACT_MATCH 4
- #define EFI_IMAGE_COMDAT_SELECT_ASSOCIATIVE 5
-
- ///
- /// the following values only be referred in PeCoff, not defined in PECOFF.
- ///
- #define EFI_IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY 1
- #define EFI_IMAGE_WEAK_EXTERN_SEARCH_LIBRARY 2
- #define EFI_IMAGE_WEAK_EXTERN_SEARCH_ALIAS 3
-
- ///
- /// Relocation format.
- ///
- typedef struct {
- UINT32 VirtualAddress;
- UINT32 SymbolTableIndex;
- UINT16 Type;
- } EFI_IMAGE_RELOCATION;
-
- ///
- /// Size of EFI_IMAGE_RELOCATION
- ///
- #define EFI_IMAGE_SIZEOF_RELOCATION 10
-
- ///
- /// I386 relocation types.
- ///
- #define EFI_IMAGE_REL_I386_ABSOLUTE 0x0000 ///< Reference is absolute, no relocation is necessary
- #define EFI_IMAGE_REL_I386_DIR16 0x0001 ///< Direct 16-bit reference to the symbols virtual address
- #define EFI_IMAGE_REL_I386_REL16 0x0002 ///< PC-relative 16-bit reference to the symbols virtual address
- #define EFI_IMAGE_REL_I386_DIR32 0x0006 ///< Direct 32-bit reference to the symbols virtual address
- #define EFI_IMAGE_REL_I386_DIR32NB 0x0007 ///< Direct 32-bit reference to the symbols virtual address, base not included
- #define EFI_IMAGE_REL_I386_SEG12 0x0009 ///< Direct 16-bit reference to the segment-selector bits of a 32-bit virtual address
- #define EFI_IMAGE_REL_I386_SECTION 0x000A
- #define EFI_IMAGE_REL_I386_SECREL 0x000B
- #define EFI_IMAGE_REL_I386_REL32 0x0014 ///< PC-relative 32-bit reference to the symbols virtual address
-
- ///
- /// x64 processor relocation types.
- ///
- #define IMAGE_REL_AMD64_ABSOLUTE 0x0000
- #define IMAGE_REL_AMD64_ADDR64 0x0001
- #define IMAGE_REL_AMD64_ADDR32 0x0002
- #define IMAGE_REL_AMD64_ADDR32NB 0x0003
- #define IMAGE_REL_AMD64_REL32 0x0004
- #define IMAGE_REL_AMD64_REL32_1 0x0005
- #define IMAGE_REL_AMD64_REL32_2 0x0006
- #define IMAGE_REL_AMD64_REL32_3 0x0007
- #define IMAGE_REL_AMD64_REL32_4 0x0008
- #define IMAGE_REL_AMD64_REL32_5 0x0009
- #define IMAGE_REL_AMD64_SECTION 0x000A
- #define IMAGE_REL_AMD64_SECREL 0x000B
- #define IMAGE_REL_AMD64_SECREL7 0x000C
- #define IMAGE_REL_AMD64_TOKEN 0x000D
- #define IMAGE_REL_AMD64_SREL32 0x000E
- #define IMAGE_REL_AMD64_PAIR 0x000F
- #define IMAGE_REL_AMD64_SSPAN32 0x0010
-
- ///
- /// Based relocation format.
- ///
- typedef struct {
- UINT32 VirtualAddress;
- UINT32 SizeOfBlock;
- } EFI_IMAGE_BASE_RELOCATION;
-
- ///
- /// Size of EFI_IMAGE_BASE_RELOCATION
- ///
- #define EFI_IMAGE_SIZEOF_BASE_RELOCATION 8
-
- ///
- /// Based relocation types.
- ///
- #define EFI_IMAGE_REL_BASED_ABSOLUTE 0
- #define EFI_IMAGE_REL_BASED_HIGH 1
- #define EFI_IMAGE_REL_BASED_LOW 2
- #define EFI_IMAGE_REL_BASED_HIGHLOW 3
- #define EFI_IMAGE_REL_BASED_HIGHADJ 4
- #define EFI_IMAGE_REL_BASED_MIPS_JMPADDR 5
- #define EFI_IMAGE_REL_BASED_IA64_IMM64 9
- #define IMAGE_REL_BASED_MIPS_JMPADDR16 9
- #define EFI_IMAGE_REL_BASED_DIR64 10
-
- ///
- /// Line number format.
- ///
- typedef struct {
- union {
- UINT32 SymbolTableIndex; // Symbol table index of function name if Linenumber is 0.
- UINT32 VirtualAddress; // Virtual address of line number.
- } Type;
- UINT16 Linenumber; // Line number.
- } EFI_IMAGE_LINENUMBER;
-
- ///
- /// Size of EFI_IMAGE_LINENUMBER
- ///
- #define EFI_IMAGE_SIZEOF_LINENUMBER 6
-
- ///
- /// Archive format.
- ///
- #define EFI_IMAGE_ARCHIVE_START_SIZE 8
- #define EFI_IMAGE_ARCHIVE_START "!<arch>\n"
- #define EFI_IMAGE_ARCHIVE_END "`\n"
- #define EFI_IMAGE_ARCHIVE_PAD "\n"
- #define EFI_IMAGE_ARCHIVE_LINKER_MEMBER "/ "
- #define EFI_IMAGE_ARCHIVE_LONGNAMES_MEMBER "// "
-
- typedef struct {
- UINT8 Name[16]; ///< File member name - `/' terminated.
- UINT8 Date[12]; ///< File member date - decimal.
- UINT8 UserID[6]; ///< File member user id - decimal.
- UINT8 GroupID[6]; ///< File member group id - decimal.
- UINT8 Mode[8]; ///< File member mode - octal.
- UINT8 Size[10]; ///< File member size - decimal.
- UINT8 EndHeader[2]; ///< String to end header. (0x60 0x0A)
- } EFI_IMAGE_ARCHIVE_MEMBER_HEADER;
-
- ///
- /// Size of EFI_IMAGE_ARCHIVE_MEMBER_HEADER
- ///
- #define EFI_IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR 60
-
-
- ///
- /// DLL Support
- ///
-
- ///
- /// Export Directory Table
- ///
- typedef struct {
- UINT32 Characteristics;
- UINT32 TimeDateStamp;
- UINT16 MajorVersion;
- UINT16 MinorVersion;
- UINT32 Name;
- UINT32 Base;
- UINT32 NumberOfFunctions;
- UINT32 NumberOfNames;
- UINT32 AddressOfFunctions;
- UINT32 AddressOfNames;
- UINT32 AddressOfNameOrdinals;
- } EFI_IMAGE_EXPORT_DIRECTORY;
-
- ///
- /// Hint/Name Table
- ///
- typedef struct {
- UINT16 Hint;
- UINT8 Name[1];
- } EFI_IMAGE_IMPORT_BY_NAME;
-
- typedef struct {
- union {
- UINT32 Function;
- UINT32 Ordinal;
- EFI_IMAGE_IMPORT_BY_NAME *AddressOfData;
- } u1;
- } EFI_IMAGE_THUNK_DATA;
-
- #define EFI_IMAGE_ORDINAL_FLAG BIT31 ///< Flag for PE32
- #define EFI_IMAGE_SNAP_BY_ORDINAL(Ordinal) ((Ordinal & EFI_IMAGE_ORDINAL_FLAG) != 0)
- #define EFI_IMAGE_ORDINAL(Ordinal) (Ordinal & 0xffff)
-
- ///
- /// Import Directory Table
- ///
- typedef struct {
- UINT32 Characteristics;
- UINT32 TimeDateStamp;
- UINT32 ForwarderChain;
- UINT32 Name;
- EFI_IMAGE_THUNK_DATA *FirstThunk;
- } EFI_IMAGE_IMPORT_DESCRIPTOR;
-
-
- ///
- /// Debug Direcotry Format
- ///
- typedef struct {
- UINT32 Characteristics;
- UINT32 TimeDateStamp;
- UINT16 MajorVersion;
- UINT16 MinorVersion;
- UINT32 Type;
- UINT32 SizeOfData;
- UINT32 RVA; ///< The address of the debug data when loaded, relative to the image base
- UINT32 FileOffset; ///< The file pointer to the debug data
- } EFI_IMAGE_DEBUG_DIRECTORY_ENTRY;
-
- #define EFI_IMAGE_DEBUG_TYPE_CODEVIEW 2 ///< The Visual C++ debug information
-
- ///
- /// Debug Data Structure defined in Microsoft C++
- ///
- #define CODEVIEW_SIGNATURE_NB10 SIGNATURE_32('N', 'B', '1', '0')
- typedef struct {
- UINT32 Signature; ///< "NB10"
- UINT32 Unknown;
- UINT32 Unknown2;
- UINT32 Unknown3;
- //
- // Filename of .PDB goes here
- //
- } EFI_IMAGE_DEBUG_CODEVIEW_NB10_ENTRY;
-
- ///
- /// Debug Data Structure defined in Microsoft C++
- ///
- #define CODEVIEW_SIGNATURE_RSDS SIGNATURE_32('R', 'S', 'D', 'S')
- typedef struct {
- UINT32 Signature; ///< "RSDS"
- UINT32 Unknown;
- UINT32 Unknown2;
- UINT32 Unknown3;
- UINT32 Unknown4;
- UINT32 Unknown5;
- //
- // Filename of .PDB goes here
- //
- } EFI_IMAGE_DEBUG_CODEVIEW_RSDS_ENTRY;
-
- ///
- /// Header format for TE images, defined in PI Specification, 1.0
- ///
- typedef struct {
- UINT16 Signature; ///< signature for TE format = "VZ"
- UINT16 Machine; ///< from the original file header
- UINT8 NumberOfSections; ///< from the original file header
- UINT8 Subsystem; ///< from original optional header
- UINT16 StrippedSize; ///< how many bytes we removed from the header
- UINT32 AddressOfEntryPoint; ///< offset to entry point -- from original optional header
- UINT32 BaseOfCode; ///< from original image -- required for ITP debug
- UINT64 ImageBase; ///< from original file header
- EFI_IMAGE_DATA_DIRECTORY DataDirectory[2]; ///< only base relocation and debug directory
- } EFI_TE_IMAGE_HEADER;
-
-
- #define EFI_TE_IMAGE_HEADER_SIGNATURE SIGNATURE_16('V', 'Z')
-
- //
- // Data directory indexes in our TE image header
- //
- #define EFI_TE_IMAGE_DIRECTORY_ENTRY_BASERELOC 0
- #define EFI_TE_IMAGE_DIRECTORY_ENTRY_DEBUG 1
-
-
- ///
- /// Union of PE32, PE32+, and TE headers
- ///
- typedef union {
- EFI_IMAGE_NT_HEADERS32 Pe32;
- EFI_IMAGE_NT_HEADERS64 Pe32Plus;
- EFI_TE_IMAGE_HEADER Te;
- } EFI_IMAGE_OPTIONAL_HEADER_UNION;
-
- typedef union {
- EFI_IMAGE_NT_HEADERS32 *Pe32;
- EFI_IMAGE_NT_HEADERS64 *Pe32Plus;
- EFI_TE_IMAGE_HEADER *Te;
- EFI_IMAGE_OPTIONAL_HEADER_UNION *Union;
- } EFI_IMAGE_OPTIONAL_HEADER_PTR_UNION;
-
- #endif
|