diff -r 000000000000 -r 83f4b4db085c toolsandutils/e32tools/inc/pe_defs.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/toolsandutils/e32tools/inc/pe_defs.h Tue Feb 02 01:39:43 2010 +0200 @@ -0,0 +1,830 @@ +// Copyright (c) 1995-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of "Eclipse Public License v1.0" +// which accompanies this distribution, and is available +// at the URL "http://www.eclipse.org/legal/epl-v10.html". +// +// Initial Contributors: +// Nokia Corporation - initial contribution. +// +// Contributors: +// +// Description: +// + +#if !defined(__PE_DEFS_H__) +#define __PE_DEFS_H__ + +// A few additions to winnnt.h + +#define IMAGE_FILE_MINIMAL_OBJECT 0x0010 +#define IMAGE_FILE_UPDATE_OBJECT 0x0020 +#define IMAGE_FILE_16BIT_MACHINE 0x0040 +#define IMAGE_FILE_PATCH 0x0400 +#define IMAGE_FILE_MACHINE_I860 0x014d + +#define IMAGE_LIBRARY_PROCESS_INIT 0x0001 +#define IMAGE_LIBRARY_PROCESS_TERM 0x0002 +#define IMAGE_LIBRARY_THREAD_INIT 0x0004 +#define IMAGE_LIBRARY_THREAD_TERM 0x0008 + +#define IMAGE_LOADER_FLAGS_BREAK_ON_LOAD 0x0001 +#define IMAGE_LOADER_FLAGS_DEBUG_ON_LOAD 0x0002 + +#define IMAGE_SCN_LNK_OVERLAY 0x00000400 + + +// +// Image Format (copied entire from winnt.h) +// + +#define IMAGE_DOS_SIGNATURE 0x5A4D // MZ +#define IMAGE_OS2_SIGNATURE 0x454E // NE +#define IMAGE_OS2_SIGNATURE_LE 0x454C // LE +#define IMAGE_NT_SIGNATURE 0x00004550 // PE00 + +typedef struct _IMAGE_DOS_HEADER { // DOS .EXE header + TUint16 e_magic; // Magic number + TUint16 e_cblp; // TUint8 on last page of file + TUint16 e_cp; // Pages in file + TUint16 e_crlc; // Relocations + TUint16 e_cparhdr; // Size of header in paragraphs + TUint16 e_minalloc; // Minimum extra paragraphs needed + TUint16 e_maxalloc; // Maximum extra paragraphs needed + TUint16 e_ss; // Initial (relative) SS value + TUint16 e_sp; // Initial SP value + TUint16 e_csum; // Checksum + TUint16 e_ip; // Initial IP value + TUint16 e_cs; // Initial (relative) CS value + TUint16 e_lfarlc; // File address of relocation table + TUint16 e_ovno; // Overlay number + TUint16 e_res[4]; // Reserved TUint16s + TUint16 e_oemid; // OEM identifier (for e_oeminfo) + TUint16 e_oeminfo; // OEM information; e_oemid specific + TUint16 e_res2[10]; // Reserved TUint16s + TUint32 e_lfanew; // File address of new exe header + } IMAGE_DOS_HEADER, *PIMAGE_DOS_HEADER; + +typedef struct _IMAGE_OS2_HEADER { // OS/2 .EXE header + TUint16 ne_magic; // Magic number + TUint8 ne_ver; // Version number + TUint8 ne_rev; // Revision number + TUint16 ne_enttab; // Offset of Entry Table + TUint16 ne_cbenttab; // Number of TUint8 in Entry Table + TUint32 ne_crc; // Checksum of whole file + TUint16 ne_flags; // Flag TUint16 + TUint16 ne_autodata; // Automatic data segment number + TUint16 ne_heap; // Initial heap allocation + TUint16 ne_stack; // Initial stack allocation + TUint32 ne_csip; // Initial CS:IP setting + TUint32 ne_sssp; // Initial SS:SP setting + TUint16 ne_cseg; // Count of file segments + TUint16 ne_cmod; // Entries in Module Reference Table + TUint16 ne_cbnrestab; // Size of non-resident name table + TUint16 ne_segtab; // Offset of Segment Table + TUint16 ne_rsrctab; // Offset of Resource Table + TUint16 ne_restab; // Offset of resident name table + TUint16 ne_modtab; // Offset of Module Reference Table + TUint16 ne_imptab; // Offset of Imported Names Table + TUint32 ne_nrestab; // Offset of Non-resident Names Table + TUint16 ne_cmovent; // Count of movable entries + TUint16 ne_align; // Segment alignment shift count + TUint16 ne_cres; // Count of resource segments + TUint8 ne_exetyp; // Target Operating system + TUint8 ne_flagsothers; // Other .EXE flags + TUint16 ne_pretthunks; // offset to return thunks + TUint16 ne_psegrefTUint8; // offset to segment ref. TUint8 + TUint16 ne_swaparea; // Minimum code swap area size + TUint16 ne_expver; // Expected Windows version number + } IMAGE_OS2_HEADER, *PIMAGE_OS2_HEADER; + +// +// File header format. +// + +typedef struct _IMAGE_FILE_HEADER + { + TUint16 Machine; + TUint16 NumberOfSections; + TUint32 TimeDateStamp; + TUint32 PointerToSymbolTable; + TUint32 NumberOfSymbols; + TUint16 SizeOfOptionalHeader; + TUint16 Characteristics; + } IMAGE_FILE_HEADER, *PIMAGE_FILE_HEADER; + +#define IMAGE_SIZEOF_FILE_HEADER 20 + +#define IMAGE_FILE_RELOCS_STRIPPED 0x0001 // Relocation info stripped from file. +#define IMAGE_FILE_EXECUTABLE_IMAGE 0x0002 // File is executable (i.e. no unresolved externel references). +#define IMAGE_FILE_LINE_NUMS_STRIPPED 0x0004 // Line nunbers stripped from file. +#define IMAGE_FILE_LOCAL_SYMS_STRIPPED 0x0008 // Local symbols stripped from file. +#define IMAGE_FILE_CHAR_REVERSED_LO 0x0080 // TUint8 of machine TUint16 are reversed. +#define IMAGE_FILE_32BIT_MACHINE 0x0100 // 32 bit word machine. +#define IMAGE_FILE_DEBUG_STRIPPED 0x0200 // Debugging info stripped from file in .DBG file +#define IMAGE_FILE_SYSTEM 0x1000 // System File. +#define IMAGE_FILE_DLL 0x2000 // File is a DLL. +#define IMAGE_FILE_CHAR_REVERSED_HI 0x8000 // Char of machine short are reversed. + +#define IMAGE_FILE_MACHINE_UNKNOWN 0 +#define IMAGE_FILE_MACHINE_I386 0x14c // Intel 386. +#define IMAGE_FILE_MACHINE_R3000 0x162 // MIPS little-endian, 0540 big-endian +#define IMAGE_FILE_MACHINE_R4000 0x166 // MIPS little-endian +#define IMAGE_FILE_MACHINE_ALPHA 0x184 // Alpha_AXP +#define IMAGE_FILE_MACHINE_POWERPC 0x1F0 // IBM PowerPC Little-Endian + +// +// Directory format. +// +typedef struct _IMAGE_DATA_DIRECTORY + { + TUint32 VirtualAddress; + TUint32 Size; + } IMAGE_DATA_DIRECTORY, *PIMAGE_DATA_DIRECTORY; + +#define IMAGE_NUMBEROF_DIRECTORY_ENTRIES 16 + +// +// Optional header format. +// +typedef struct _IMAGE_OPTIONAL_HEADER + { + // + // Standard fields. + // + + TUint16 Magic; + TUint8 MajorLinkerVersion; + TUint8 MinorLinkerVersion; + TUint32 SizeOfCode; + TUint32 SizeOfInitializedData; + TUint32 SizeOfUninitializedData; + TUint32 AddressOfEntryPoint; + TUint32 BaseOfCode; + TUint32 BaseOfData; + + // + // NT additional fields. + // + + TUint32 ImageBase; + TUint32 SectionAlignment; + TUint32 FileAlignment; + TUint16 MajorOperatingSystemVersion; + TUint16 MinorOperatingSystemVersion; + TUint16 MajorImageVersion; + TUint16 MinorImageVersion; + TUint16 MajorSubsystemVersion; + TUint16 MinorSubsystemVersion; + TUint32 Reserved1; + TUint32 SizeOfImage; + TUint32 SizeOfHeaders; + TUint32 CheckSum; + TUint16 Subsystem; + TUint16 DllCharacteristics; + TUint32 SizeOfStackReserve; + TUint32 SizeOfStackCommit; + TUint32 SizeOfHeapReserve; + TUint32 SizeOfHeapCommit; + TUint32 LoaderFlags; + TUint32 NumberOfRvaAndSizes; + IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; + } IMAGE_OPTIONAL_HEADER, *PIMAGE_OPTIONAL_HEADER; + +typedef struct _IMAGE_ROM_OPTIONAL_HEADER { + TUint16 Magic; + TUint8 MajorLinkerVersion; + TUint8 MinorLinkerVersion; + TUint32 SizeOfCode; + TUint32 SizeOfInitializedData; + TUint32 SizeOfUninitializedData; + TUint32 AddressOfEntryPoint; + TUint32 BaseOfCode; + TUint32 BaseOfData; + TUint32 BaseOfBss; + TUint32 GprMask; + TUint32 CprMask[4]; + TUint32 GpValue; +} IMAGE_ROM_OPTIONAL_HEADER, *PIMAGE_ROM_OPTIONAL_HEADER; + +#define IMAGE_SIZEOF_ROM_OPTIONAL_HEADER 56 +#define IMAGE_SIZEOF_STD_OPTIONAL_HEADER 28 +#define IMAGE_SIZEOF_NT_OPTIONAL_HEADER 224 + +#define IMAGE_NT_OPTIONAL_HDR_MAGIC 0x10b +#define IMAGE_ROM_OPTIONAL_HDR_MAGIC 0x107 + +typedef struct _IMAGE_NT_HEADERS { + TUint32 Signature; + IMAGE_FILE_HEADER FileHeader; + IMAGE_OPTIONAL_HEADER OptionalHeader; +} IMAGE_NT_HEADERS, *PIMAGE_NT_HEADERS; + +typedef struct _IMAGE_ROM_HEADERS { + IMAGE_FILE_HEADER FileHeader; + IMAGE_ROM_OPTIONAL_HEADER OptionalHeader; +} IMAGE_ROM_HEADERS, *PIMAGE_ROM_HEADERS; + +#define IMAGE_FIRST_SECTION( ntheader ) ((PIMAGE_SECTION_HEADER) \ + ((TUint32)ntheader + \ + FIELD_OFFSET( IMAGE_NT_HEADERS, OptionalHeader ) + \ + ((PIMAGE_NT_HEADERS)(ntheader))->FileHeader.SizeOfOptionalHeader \ + )) + + +// Subsystem Values + +#define IMAGE_SUBSYSTEM_UNKNOWN 0 // Unknown subsystem. +#define IMAGE_SUBSYSTEM_NATIVE 1 // Image doesn't require a subsystem. +#define IMAGE_SUBSYSTEM_WINDOWS_GUI 2 // Image runs in the Windows GUI subsystem. +#define IMAGE_SUBSYSTEM_WINDOWS_CUI 3 // Image runs in the Windows character subsystem. +#define IMAGE_SUBSYSTEM_OS2_CUI 5 // image runs in the OS/2 character subsystem. +#define IMAGE_SUBSYSTEM_POSIX_CUI 7 // image run in the Posix character subsystem. + + +// Directory Entries + +#define IMAGE_DIRECTORY_ENTRY_EXPORT 0 // Export Directory +#define IMAGE_DIRECTORY_ENTRY_IMPORT 1 // Import Directory +#define IMAGE_DIRECTORY_ENTRY_RESOURCE 2 // Resource Directory +#define IMAGE_DIRECTORY_ENTRY_EXCEPTION 3 // Exception Directory +#define IMAGE_DIRECTORY_ENTRY_SECURITY 4 // Security Directory +#define IMAGE_DIRECTORY_ENTRY_BASERELOC 5 // Base Relocation Table +#define IMAGE_DIRECTORY_ENTRY_DEBUG 6 // Debug Directory +#define IMAGE_DIRECTORY_ENTRY_COPYRIGHT 7 // Description String +#define IMAGE_DIRECTORY_ENTRY_GLOBALPTR 8 // Machine Value (MIPS GP) +#define IMAGE_DIRECTORY_ENTRY_TLS 9 // TLS Directory +#define IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG 10 // Load Configuration Directory + +// +// Section header format. +// + +#define IMAGE_SIZEOF_SHORT_NAME 8 + +typedef struct _IMAGE_SECTION_HEADER { + TUint8 Name[IMAGE_SIZEOF_SHORT_NAME]; + union { + TUint32 PhysicalAddress; + TUint32 VirtualSize; + } Misc; + TUint32 VirtualAddress; + TUint32 SizeOfRawData; + TUint32 PointerToRawData; + TUint32 PointerToRelocations; + TUint32 PointerToLinenumbers; + TUint16 NumberOfRelocations; + TUint16 NumberOfLinenumbers; + TUint32 Characteristics; +} IMAGE_SECTION_HEADER, *PIMAGE_SECTION_HEADER; + +#define IMAGE_SIZEOF_SECTION_HEADER 40 + +#define IMAGE_SCN_TYPE_NO_PAD 0x00000008 // Reserved. + +#define IMAGE_SCN_CNT_CODE 0x00000020 // Section contains code. +#define IMAGE_SCN_CNT_INITIALIZED_DATA 0x00000040 // Section contains initialized data. +#define IMAGE_SCN_CNT_UNINITIALIZED_DATA 0x00000080 // Section contains uninitialized data. + +#define IMAGE_SCN_LNK_OTHER 0x00000100 // Reserved. +#define IMAGE_SCN_LNK_INFO 0x00000200 // Section contains comments or some other type of information. +#define IMAGE_SCN_LNK_REMOVE 0x00000800 // Section contents will not become part of image. +#define IMAGE_SCN_LNK_COMDAT 0x00001000 // Section contents comdat. + +#define IMAGE_SCN_ALIGN_1Byte 0x00100000 // +#define IMAGE_SCN_ALIGN_2Byte 0x00200000 // +#define IMAGE_SCN_ALIGN_4Byte 0x00300000 // +#define IMAGE_SCN_ALIGN_8Byte 0x00400000 // +#define IMAGE_SCN_ALIGN_16Byte 0x00500000 // Default alignment if no others are specified. +#define IMAGE_SCN_ALIGN_32Byte 0x00600000 // +#define IMAGE_SCN_ALIGN_64Byte 0x00700000 // + +#define IMAGE_SCN_MEM_DISCARDABLE 0x02000000 // Section can be discarded. +#define IMAGE_SCN_MEM_NOT_CACHED 0x04000000 // Section is not cachable. +#define IMAGE_SCN_MEM_NOT_PAGED 0x08000000 // Section is not pageable. +#define IMAGE_SCN_MEM_SHARED 0x10000000 // Section is shareable. +#define IMAGE_SCN_MEM_EXECUTE 0x20000000 // Section is executable. +#define IMAGE_SCN_MEM_READ 0x40000000 // Section is readable. +#define IMAGE_SCN_MEM_WRITE 0x80000000 // Section is writeable. + +// +// Symbol format. +// + +typedef struct _IMAGE_SYMBOL { + union { + TUint8 ShortName[8]; + struct { + TUint32 Short; // if 0, use LongName + TUint32 Long; // offset into string table + } Name; + TUint8 *LongName[2]; + } N; + TUint32 Value; + TInt16 SectionNumber; + TUint16 Type; + TUint8 StorageClass; + TUint8 NumberOfAuxSymbols; +} IMAGE_SYMBOL; +typedef IMAGE_SYMBOL *PIMAGE_SYMBOL; + +#define IMAGE_SIZEOF_SYMBOL 18 + +// +// Section values. +// +// Symbols have a section number of the section in which they are +// defined. Otherwise, section numbers have the following meanings: +// + +#define IMAGE_SYM_UNDEFINED (TInt16)0 // Symbol is undefined or is common. +#define IMAGE_SYM_ABSOLUTE (TInt16)-1 // Symbol is an absolute value. +#define IMAGE_SYM_DEBUG (TInt16)-2 // Symbol is a special debug item. + +// +// Type (fundamental) values. +// + +#define IMAGE_SYM_TYPE_NULL 0 // no type. +#define IMAGE_SYM_TYPE_VOID 1 // +#define IMAGE_SYM_TYPE_TUint8 2 // type character. +#define IMAGE_SYM_TYPE_TInt16 3 // type TInt16 integer. +#define IMAGE_SYM_TYPE_INT 4 // +#define IMAGE_SYM_TYPE_TUint32 5 // +#define IMAGE_SYM_TYPE_FLOAT 6 // +#define IMAGE_SYM_TYPE_DOUBLE 7 // +#define IMAGE_SYM_TYPE_STRUCT 8 // +#define IMAGE_SYM_TYPE_UNION 9 // +#define IMAGE_SYM_TYPE_ENUM 10 // enumeration. +#define IMAGE_SYM_TYPE_MOE 11 // member of enumeration. +#define IMAGE_SYM_TYPE_BYTE 12 // +#define IMAGE_SYM_TYPE_WORD 13 // +#define IMAGE_SYM_TYPE_UINT 14 // +#define IMAGE_SYM_TYPE_DWORD 15 // + +// +// Type (derived) values. +// + +#define IMAGE_SYM_DTYPE_NULL 0 // no derived type. +#define IMAGE_SYM_DTYPE_POINTER 1 // pointer. +#define IMAGE_SYM_DTYPE_FUNCTION 2 // function. +#define IMAGE_SYM_DTYPE_ARRAY 3 // array. + +// +// Storage classes. +// + +#define IMAGE_SYM_CLASS_END_OF_FUNCTION (TUint8 )-1 +#define IMAGE_SYM_CLASS_NULL 0 +#define IMAGE_SYM_CLASS_AUTOMATIC 1 +#define IMAGE_SYM_CLASS_EXTERNAL 2 +#define IMAGE_SYM_CLASS_STATIC 3 +#define IMAGE_SYM_CLASS_REGISTER 4 +#define IMAGE_SYM_CLASS_EXTERNAL_DEF 5 +#define IMAGE_SYM_CLASS_LABEL 6 +#define IMAGE_SYM_CLASS_UNDEFINED_LABEL 7 +#define IMAGE_SYM_CLASS_MEMBER_OF_STRUCT 8 +#define IMAGE_SYM_CLASS_ARGUMENT 9 +#define IMAGE_SYM_CLASS_STRUCT_TAG 10 +#define IMAGE_SYM_CLASS_MEMBER_OF_UNION 11 +#define IMAGE_SYM_CLASS_UNION_TAG 12 +#define IMAGE_SYM_CLASS_TYPE_DEFINITION 13 +#define IMAGE_SYM_CLASS_UNDEFINED_STATIC 14 +#define IMAGE_SYM_CLASS_ENUM_TAG 15 +#define IMAGE_SYM_CLASS_MEMBER_OF_ENUM 16 +#define IMAGE_SYM_CLASS_REGISTER_PARAM 17 +#define IMAGE_SYM_CLASS_BIT_FIELD 18 +#define IMAGE_SYM_CLASS_BLOCK 100 +#define IMAGE_SYM_CLASS_FUNCTION 101 +#define IMAGE_SYM_CLASS_END_OF_STRUCT 102 +#define IMAGE_SYM_CLASS_FILE 103 +// new +#define IMAGE_SYM_CLASS_SECTION 104 +#define IMAGE_SYM_CLASS_WEAK_EXTERNAL 105 + +// type packing constants + +#define N_BTMASK 017 +#define N_TMASK 060 +#define N_TMASK1 0300 +#define N_TMASK2 0360 +#define N_BTSHFT 4 +#define N_TSHIFT 2 + +// MACROS + +// Basic Type of x +#define BTYPE(x) ((x) & N_BTMASK) + +// Is x a pointer? +#ifndef ISPTR +#define ISPTR(x) (((x) & N_TMASK) == (IMAGE_SYM_DTYPE_POINTER << N_BTSHFT)) +#endif + +// Is x a function? +#ifndef ISFCN +#define ISFCN(x) (((x) & N_TMASK) == (IMAGE_SYM_DTYPE_FUNCTION << N_BTSHFT)) +#endif + +// Is x an array? + +#ifndef ISARY +#define ISARY(x) (((x) & N_TMASK) == (IMAGE_SYM_DTYPE_ARRAY << N_BTSHFT)) +#endif + +// Is x a structure, union, or enumeration TAG? +#ifndef ISTAG +#define ISTAG(x) ((x)==IMAGE_SYM_CLASS_STRUCT_TAG || (x)==IMAGE_SYM_CLASS_UNION_TAG || (x)==IMAGE_SYM_CLASS_ENUM_TAG) +#endif + +#ifndef INCREF +#define INCREF(x) ((((x)&~N_BTMASK)<>N_TSHIFT)&~N_BTMASK)|((x)&N_BTMASK)) +#endif + +// +// Auxiliary entry format. +// + +typedef union _IMAGE_AUX_SYMBOL { + struct { + TUint32 TagIndex; // struct, union, or enum tag index + union { + struct { + TUint16 Linenumber; // declaration line number + TUint16 Size; // size of struct, union, or enum + } LnSz; + TUint32 TotalSize; + } Misc; + union { + struct { // if ISFCN, tag, or .bb + TUint32 PointerToLinenumber; + TUint32 PointerToNextFunction; + } Function; + struct { // if ISARY, up to 4 dimen. + TUint16 Dimension[4]; + } Array; + } FcnAry; + TUint16 TvIndex; // tv index + } Sym; + struct { + TUint8 Name[IMAGE_SIZEOF_SYMBOL]; + } File; + struct { + TUint32 Length; // section length + TUint16 NumberOfRelocations; // number of relocation entries + TUint16 NumberOfLinenumbers; // number of line numbers + TUint32 CheckSum; // checksum for communal + TInt16 Number; // section number to associate with + TUint8 Selection; // communal selection type + } Section; +} IMAGE_AUX_SYMBOL; +typedef IMAGE_AUX_SYMBOL *PIMAGE_AUX_SYMBOL; + +#define IMAGE_SIZEOF_AUX_SYMBOL 18 + +// +// Communal selection types. +// + +#define IMAGE_COMDAT_SELECT_NODUPLICATES 1 +#define IMAGE_COMDAT_SELECT_ANY 2 +#define IMAGE_COMDAT_SELECT_SAME_SIZE 3 +#define IMAGE_COMDAT_SELECT_EXACT_MATCH 4 +#define IMAGE_COMDAT_SELECT_ASSOCIATIVE 5 + +#define IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY 1 +#define IMAGE_WEAK_EXTERN_SEARCH_LIBRARY 2 +#define IMAGE_WEAK_EXTERN_SEARCH_ALIAS 3 + + +// +// Relocation format. +// + +typedef struct _IMAGE_RELOCATION { + TUint32 VirtualAddress; + TUint32 SymbolTableIndex; + TUint16 Type; +} IMAGE_RELOCATION; +typedef IMAGE_RELOCATION *PIMAGE_RELOCATION; + +#define IMAGE_SIZEOF_RELOCATION 10 + +// +// I386 relocation types. +// + +#define IMAGE_REL_I386_ABSOLUTE 0 // Reference is absolute, no relocation is necessary +#define IMAGE_REL_I386_DIR16 01 // Direct 16-bit reference to the symbols virtual address +#define IMAGE_REL_I386_REL16 02 // PC-relative 16-bit reference to the symbols virtual address +#define IMAGE_REL_I386_DIR32 06 // Direct 32-bit reference to the symbols virtual address +#define IMAGE_REL_I386_DIR32NB 07 // Direct 32-bit reference to the symbols virtual address, base not included +#define IMAGE_REL_I386_SEG12 011 // Direct 16-bit reference to the segment-selector bits of a 32-bit virtual address +#define IMAGE_REL_I386_SECTION 012 +#define IMAGE_REL_I386_SECREL 013 +#define IMAGE_REL_I386_REL32 024 // PC-relative 32-bit reference to the symbols virtual address + +// +// MIPS relocation types. +// + +#define IMAGE_REL_MIPS_ABSOLUTE 0 // Reference is absolute, no relocation is necessary +#define IMAGE_REL_MIPS_REFHALF 01 +#define IMAGE_REL_MIPS_REFTUint16 02 +#define IMAGE_REL_MIPS_JMPADDR 03 +#define IMAGE_REL_MIPS_REFHI 04 +#define IMAGE_REL_MIPS_REFLO 05 +#define IMAGE_REL_MIPS_GPREL 06 +#define IMAGE_REL_MIPS_LITERAL 07 +#define IMAGE_REL_MIPS_SECTION 012 +#define IMAGE_REL_MIPS_SECREL 013 +#define IMAGE_REL_MIPS_REFTUint16NB 042 +#define IMAGE_REL_MIPS_PAIR 045 + +// +// Alpha Relocation types. +// + +#define IMAGE_REL_ALPHA_ABSOLUTE 0x0 +#define IMAGE_REL_ALPHA_REFTUint32 0x1 +#define IMAGE_REL_ALPHA_REFQUAD 0x2 +#define IMAGE_REL_ALPHA_GPREL32 0x3 +#define IMAGE_REL_ALPHA_LITERAL 0x4 +#define IMAGE_REL_ALPHA_LITUSE 0x5 +#define IMAGE_REL_ALPHA_GPDISP 0x6 +#define IMAGE_REL_ALPHA_BRADDR 0x7 +#define IMAGE_REL_ALPHA_HINT 0x8 +#define IMAGE_REL_ALPHA_INLINE_REFTUint32 0x9 +#define IMAGE_REL_ALPHA_REFHI 0xA +#define IMAGE_REL_ALPHA_REFLO 0xB +#define IMAGE_REL_ALPHA_PAIR 0xC +#define IMAGE_REL_ALPHA_MATCH 0xD +#define IMAGE_REL_ALPHA_SECTION 0xE +#define IMAGE_REL_ALPHA_SECREL 0xF +#define IMAGE_REL_ALPHA_REFTUint32NB 0x10 + +// +// IBM PowerPC relocation types. +// + +#define IMAGE_REL_PPC_ABSOLUTE 0x0000 // NOP +#define IMAGE_REL_PPC_ADDR64 0x0001 // 64-bit address +#define IMAGE_REL_PPC_ADDR32 0x0002 // 32-bit address +#define IMAGE_REL_PPC_ADDR24 0x0003 // 26-bit address, shifted left 2 (branch absolute) +#define IMAGE_REL_PPC_ADDR16 0x0004 // 16-bit address +#define IMAGE_REL_PPC_ADDR14 0x0005 // 16-bit address, shifted left 2 (load doubleTUint16) +#define IMAGE_REL_PPC_REL24 0x0006 // 26-bit PC-relative offset, shifted left 2 (branch relative) +#define IMAGE_REL_PPC_REL14 0x0007 // 16-bit PC-relative offset, shifted left 2 (br cond relative) +#define IMAGE_REL_PPC_TOCREL16 0x0008 // 16-bit offset from TOC base +#define IMAGE_REL_PPC_TOCREL14 0x0009 // 16-bit offset from TOC base, shifted left 2 (load doubleTUint16) + +#define IMAGE_REL_PPC_ADDR32NB 0x000A // 32-bit addr w/o image base +#define IMAGE_REL_PPC_SECREL 0x000B // va of containing section (as in an image sectionhdr) +#define IMAGE_REL_PPC_SECTION 0x000C // sectionheader number +#define IMAGE_REL_PPC_IFGLUE 0x000D // substitute TOC restore instruction iff symbol is glue code +#define IMAGE_REL_PPC_IMGLUE 0x000E // symbol is glue code; virtual address is TOC restore instruction + +#define IMAGE_REL_PPC_TYPEMASK 0x00FF // mask to isolate above values in IMAGE_RELOCATION.Type + +// Flag bits in IMAGE_RELOCATION.TYPE + +#define IMAGE_REL_PPC_NEG 0x0100 // subtract reloc value rather than adding it +#define IMAGE_REL_PPC_BRTAKEN 0x0200 // fix branch prediction bit to predict branch taken +#define IMAGE_REL_PPC_BRNTAKEN 0x0400 // fix branch prediction bit to predict branch not taken +#define IMAGE_REL_PPC_TOCDEFN 0x0800 // toc slot defined in file (or, data in toc) + +// +// Based relocation format. +// + +typedef struct _IMAGE_BASE_RELOCATION { + TUint32 VirtualAddress; + TUint32 SizeOfBlock; +// TUint16 TypeOffset[1]; +} IMAGE_BASE_RELOCATION, *PIMAGE_BASE_RELOCATION; + +#define IMAGE_SIZEOF_BASE_RELOCATION 8 + +// +// Based relocation types. +// + +#define IMAGE_REL_BASED_ABSOLUTE 0 +#define IMAGE_REL_BASED_HIGH 1 +#define IMAGE_REL_BASED_LOW 2 +#define IMAGE_REL_BASED_HIGHLOW 3 +#define IMAGE_REL_BASED_HIGHADJ 4 +#define IMAGE_REL_BASED_MIPS_JMPADDR 5 + +// +// Line number format. +// + +typedef struct _IMAGE_LINENUMBER { + union { + TUint32 SymbolTableIndex; // Symbol table index of function name if Linenumber is 0. + TUint32 VirtualAddress; // Virtual address of line number. + } Type; + TUint16 Linenumber; // Line number. +} IMAGE_LINENUMBER; +typedef IMAGE_LINENUMBER *PIMAGE_LINENUMBER; + +#define IMAGE_SIZEOF_LINENUMBER 6 + +// +// Archive format. +// + +#define IMAGE_ARCHIVE_START_SIZE 8 +#define IMAGE_ARCHIVE_START "!\n" +#define IMAGE_ARCHIVE_END "`\n" +#define IMAGE_ARCHIVE_PAD "\n" +#define IMAGE_ARCHIVE_LINKER_MEMBER "/ " +#define IMAGE_ARCHIVE_TUint32NAMES_MEMBER "// " + +typedef struct _IMAGE_ARCHIVE_MEMBER_HEADER { + TUint8 Name[16]; // File member name - `/' terminated. + TUint8 Date[12]; // File member date - decimal. + TUint8 UserID[6]; // File member user id - decimal. + TUint8 GroupID[6]; // File member group id - decimal. + TUint8 Mode[8]; // File member mode - octal. + TUint8 Size[10]; // File member size - decimal. + TUint8 EndHeader[2]; // String to end header. +} IMAGE_ARCHIVE_MEMBER_HEADER, *PIMAGE_ARCHIVE_MEMBER_HEADER; + +#define IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR 60 + +// +// DLL support. +// + +// +// Export Format +// + +typedef struct _IMAGE_EXPORT_DIRECTORY { + TUint32 Characteristics; + TUint32 TimeDateStamp; + TUint16 MajorVersion; + TUint16 MinorVersion; + TUint32 Name; + TUint32 Base; + TUint32 NumberOfFunctions; + TUint32 NumberOfNames; + TUint32 **AddressOfFunctions; + TUint32 **AddressOfNames; + TUint16 **AddressOfNameOrdinals; +} IMAGE_EXPORT_DIRECTORY, *PIMAGE_EXPORT_DIRECTORY; + +// +// Import Format +// + +typedef struct _IMAGE_IMPORT_BY_NAME { + TUint16 Hint; + TUint8 Name[1]; +} IMAGE_IMPORT_BY_NAME, *PIMAGE_IMPORT_BY_NAME; + +typedef struct _IMAGE_THUNK_DATA { + union { + TUint32 *Function; + TUint32 Ordinal; + PIMAGE_IMPORT_BY_NAME AddressOfData; + } u1; +} IMAGE_THUNK_DATA, *PIMAGE_THUNK_DATA; + +#define IMAGE_ORDINAL_FLAG 0x80000000 +#define IMAGE_SNAP_BY_ORDINAL(Ordinal) ((Ordinal & IMAGE_ORDINAL_FLAG) != 0) +#define IMAGE_ORDINAL(Ordinal) (Ordinal & 0xffff) + +typedef struct _IMAGE_IMPORT_DESCRIPTOR { + TUint32 Characteristics; + TUint32 TimeDateStamp; + TUint32 ForwarderChain; + TUint32 Name; + PIMAGE_THUNK_DATA FirstThunk; +} IMAGE_IMPORT_DESCRIPTOR, *PIMAGE_IMPORT_DESCRIPTOR; + + +// +// Debug Format +// + +typedef struct _IMAGE_DEBUG_DIRECTORY { + TUint32 characteristics; + TUint32 TimeDateStamp; + TUint16 MajorVersion; + TUint16 MinorVersion; + TUint32 Type; + TUint32 SizeOfData; + TUint32 AddressOfRawData; + TUint32 PointerToRawData; +} IMAGE_DEBUG_DIRECTORY, *PIMAGE_DEBUG_DIRECTORY; + +#define IMAGE_DEBUG_TYPE_UNKNOWN 0 +#define IMAGE_DEBUG_TYPE_COFF 1 +#define IMAGE_DEBUG_TYPE_CODEVIEW 2 +#define IMAGE_DEBUG_TYPE_FPO 3 +#define IMAGE_DEBUG_TYPE_MISC 4 +#define IMAGE_DEBUG_TYPE_EXCEPTION 5 +#define IMAGE_DEBUG_TYPE_FIXUP 6 +#define IMAGE_DEBUG_TYPE_OMAP_TO_SRC 7 +#define IMAGE_DEBUG_TYPE_OMAP_FROM_SRC 8 + +typedef struct _IMAGE_COFF_SYMBOLS_HEADER { + TUint32 NumberOfSymbols; + TUint32 LvaToFirstSymbol; + TUint32 NumberOfLinenumbers; + TUint32 LvaToFirstLinenumber; + TUint32 RvaToFirstTUint8OfCode; + TUint32 RvaToLastTUint8OfCode; + TUint32 RvaToFirstTUint8OfData; + TUint32 RvaToLastTUint8OfData; +} IMAGE_COFF_SYMBOLS_HEADER, *PIMAGE_COFF_SYMBOLS_HEADER; + +#define FRAME_FPO 0 +#define FRAME_TRAP 1 +#define FRAME_TSS 2 + +typedef struct _FPO_DATA { + TUint32 ulOffStart; // offset 1st TUint8 of function code + TUint32 cbProcSize; // # TUint8 in function + TUint32 cdwLocals; // # TUint8 in locals/4 + TUint16 cdwParams; // # TUint8 in params/4 + TUint16 cbProlog : 8; // # TUint8 in prolog + TUint16 cbRegs : 3; // # regs saved + TUint16 fHasSEH : 1; // TRUE if SEH in func + TUint16 fUseBP : 1; // TRUE if EBP has been allocated + TUint16 reserved : 1; // reserved for future use + TUint16 cbFrame : 2; // frame type +} FPO_DATA, *PFPO_DATA; +#define SIZEOF_RFPO_DATA 16 + + +#define IMAGE_DEBUG_MISC_EXENAME 1 + +typedef struct _IMAGE_DEBUG_MISC { + TUint32 DataType; // type of misc data, see defines + TUint32 Length; // total length of record, rounded to four + // TUint8 multiple. + TBool Unicode; // TRUE if data is unicode string + TUint8 Reserved[ 3 ]; + TUint8 Data[ 1 ]; // Actual data +} IMAGE_DEBUG_MISC, *PIMAGE_DEBUG_MISC; + + +// +// Function table extracted from MIPS/ALPHA images. Does not contain +// information needed only for runtime support. Just those fields for +// each entry needed by a debugger. +// + +typedef struct _IMAGE_FUNCTION_ENTRY { + TUint32 StartingAddress; + TUint32 EndingAddress; + TUint32 EndOfPrologue; +} IMAGE_FUNCTION_ENTRY, *PIMAGE_FUNCTION_ENTRY; + +// +// Debugging information can be stripped from an image file and placed +// in a separate .DBG file, whose file name part is the same as the +// image file name part (e.g. symbols for CMD.EXE could be stripped +// and placed in CMD.DBG). This is indicated by the IMAGE_FILE_DEBUG_STRIPPED +// flag in the characteristics field of the file header. The beginning of +// the .DBG file contains the following structure which captures certain +// information from the image file. This allows a debug to proceed even if +// the original image file is not accessable. This header is followed by +// zero of more IMAGE_SECTION_HEADER structures, followed by zero or more +// IMAGE_DEBUG_DIRECTORY structures. The latter structures and those in +// the image file contain file offsets relative to the beginning of the +// .DBG file. +// +// If symbols have been stripped from an image, the IMAGE_DEBUG_MISC structure +// is left in the image file, but not mapped. This allows a debugger to +// compute the name of the .DBG file, from the name of the image in the +// IMAGE_DEBUG_MISC structure. +// + +typedef struct _IMAGE_SEPARATE_DEBUG_HEADER { + TUint16 Signature; + TUint16 Flags; + TUint16 Machine; + TUint16 characteristics; + TUint32 TimeDateStamp; + TUint32 CheckSum; + TUint32 ImageBase; + TUint32 SizeOfImage; + TUint32 NumberOfSections; + TUint32 ExportedNamesSize; + TUint32 DebugDirectorySize; + TUint32 Reserved[ 3 ]; // Note: reserved[0] is actually the section alignment +} IMAGE_SEPARATE_DEBUG_HEADER, *PIMAGE_SEPARATE_DEBUG_HEADER; + +#define IMAGE_SEPARATE_DEBUG_SIGNATURE 0x4944 + +#endif