blob: 3a732f311d983dc5570a2e8a975ad1612e0ada16 [file] [log] [blame]
/*
genidl - Generate interface defintion language listing from a
Portable Executable.
Copyright (C) 2009, 2010, 2011, 2012, 2013 mingw-w64 project
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _GENIDL_READPE_H
#define _GENIDL_READPE_H
#pragma pack(push,1)
/**
* PE header layout structure
* @see http://www.jbox.dk/sanos/source/include/os/pe.h.html
*/
typedef struct sDosHeader {
uint16_t magic; /**< PE signature, usually MZ or ZM */
uint16_t cblp; /**< (PE image size) % (512) */
uint16_t cp; /**< Size of PE image in 512 byte blocks */
uint16_t crlc; /**< Number of relocation table entries*/
uint16_t cparhdr; /**< Size of PE header */
uint16_t minalloc; /**< Minimum required memory */
uint16_t maxalloc; /**< Maximum required memory */
uint16_t ss; /**< Stack seg offset in load module */
uint16_t sp; /**< initial value of Stack Pointer */
uint16_t csum; /**< Image checksum */
uint16_t ip; /**< initial value of Instruction Pointer */
uint16_t cs; /**< Initial value of the CS register, relative to the segment the program was loaded at. */
uint16_t lfarlc; /**< Offset of the first relocation item in the file. */
uint16_t ovno; /**< Overlay number. */
uint16_t res[4]; /**< Reserved slack space */
uint16_t oemid; /**< OEM ID */
uint16_t oeminfo; /**< OEM info */
uint16_t res2[10]; /**< Reserved slack space */
int32_t lfanew; /**< Offset to new PE header */
} sDosHeader;
/**
* Data directory table structure layout
*/
typedef struct sImgDataDir {
uint32_t virtualAddress; /**< Relative Virtual Address */
uint32_t size; /**< Size of the table in bytes */
} sImgDataDir;
#define IMG_NOOF_DIR_ENTRIES 16
/**
* PE32 Optional header layout structure
* @see http://www.microsoft.com/whdc/system/platform/firmware/PECOFF.mspx
*/
typedef struct sImgOptionalHeaders32 {
uint16_t Magic; /**< Identifies the type of image */
unsigned char MajorLinkerVersion; /**< Linker major version */
unsigned char MinorLinkerVersion; /**< Linker minor version */
uint32_t SizeOfCode; /**< Size of excutable .text and related sections */
uint32_t SizeOfInitializedData; /**< Size of initialized .data and related sections */
uint32_t SizeOfUninitializedData; /**< Size of unitialized .bss and related sections */
uint32_t AddressOfEntryPoint; /**< Address of image entry point relative to image base */
uint32_t BaseOfCode; /**< Address to start of .text section relative to image base */
uint32_t BaseOfData; /**< Address to start of .data section relative to image base */
uint32_t ImageBase; /**< Prefered load address of image */
uint32_t SectionAlignment; /**< Section allignment when loaded in memory */
uint32_t FileAlignment; /**< Section allignment of image on disk */
uint16_t MajorOperatingSystemVersion; /**< Minimum required OS version (Major version) */
uint16_t MinorOperatingSystemVersion; /**< Minimum required OS version (Minor version) */
uint16_t MajorImageVersion; /**< PE Image major version */
uint16_t MinorImageVersion; /**< PE Image minor version */
uint16_t MajorSubsystemVersion; /**< Subsystem major version */
uint16_t MinorSubsystemVersion; /**< Subsystem minor version */
uint32_t Win32VersionValue; /**< Reserved, set to 0 */
uint32_t SizeOfImage; /**< Total size of image in multiples of SectionAlignment */
uint32_t SizeOfHeaders; /**< Size of DOS stub header, PE header, and section headers in multiples of SectionAlignment */
uint32_t CheckSum; /**< Image checksum */
uint16_t Subsystem; /**< Image subsystem */
uint16_t DllCharacteristics; /**< DLL characteristics */
uint32_t SizeOfStackReserve; /**< Amount of stack to reserve */
uint32_t SizeOfStackCommit; /**< Amount of stack to commit on start */
uint32_t SizeOfHeapReserve; /**< Amount of heap to reserve */
uint32_t SizeOfHeapCommit; /**< Amount of heap to commit on start */
uint32_t LoaderFlags; /**< Reserved, set to 0 */
uint32_t NumberOfRvaAndSizes; /**< Number of DataDirectory entries at the end of the header */
sImgDataDir DataDirectory[IMG_NOOF_DIR_ENTRIES]; /**< Data directories */
} sImgOptionalHeaders32;
/**
* PE32+ Optional header layout structure
* @see http://www.microsoft.com/whdc/system/platform/firmware/PECOFF.mspx
*/
typedef struct sImgOptionalHeaders64 {
uint16_t Magic; /**< Identifies the type of image */
unsigned char MajorLinkerVersion; /**< Linker major version */
unsigned char MinorLinkerVersion; /**< Linker minor version */
uint32_t SizeOfCode; /**< Size of excutable .text and related sections */
uint32_t SizeOfInitializedData; /**< Size of initialized .data and related sections */
uint32_t SizeOfUninitializedData; /**< Size of unitialized .bss and related sections */
uint32_t AddressOfEntryPoint; /**< Address of image entry point relative to image base */
uint32_t BaseOfCode; /**< Address to start of .text section relative to image base */
uint64_t ImageBase; /**< Prefered load address of image */
uint32_t SectionAlignment; /**< Section allignment when loaded in memory */
uint32_t FileAlignment; /**< Section allignment of image on disk */
uint16_t MajorOperatingSystemVersion; /**< Minimum required OS version (Major version) */
uint16_t MinorOperatingSystemVersion; /**< Minimum required OS version (Minor version) */
uint16_t MajorImageVersion; /**< PE Image major version */
uint16_t MinorImageVersion; /**< PE Image minor version */
uint16_t MajorSubsystemVersion; /**< Subsystem major version */
uint16_t MinorSubsystemVersion; /**< Subsystem minor version */
uint32_t Win32VersionValue; /**< Reserved, set to 0 */
uint32_t SizeOfImage; /**< Total size of image in multiples of SectionAlignment */
uint32_t SizeOfHeaders; /**< Size of DOS stub header, PE header, and section headers in multiples of SectionAlignment */
uint32_t CheckSum; /**< Image checksum */
uint16_t Subsystem; /**< Image subsystem */
uint16_t DllCharacteristics; /**< DLL characteristics */
uint64_t SizeOfStackReserve; /**< Amount of stack to reserve */
uint64_t SizeOfStackCommit; /**< Amount of stack to commit on start */
uint64_t SizeOfHeapReserve; /**< Amount of heap to reserve */
uint64_t SizeOfHeapCommit; /**< Amount of heap to commit on start */
uint32_t LoaderFlags; /**< Reserved, set to 0 */
uint32_t NumberOfRvaAndSizes; /**< Number of DataDirectory entries at the end of the header */
sImgDataDir DataDirectory[IMG_NOOF_DIR_ENTRIES]; /**< Data directories */
} sImgOptionalHeaders64;
/**
* COFF header structure layout
*/
typedef struct sImgFileHeader {
uint16_t Machine; /**< Machine ID to run image */
uint16_t NumberOfSections; /**< Number of sections, maximum of 96 */
uint32_t TimeDateStamp; /**< 32bit time_t seconds since epoch */
uint32_t PointerToSymbolTable; /**< File offset to COFF symbol table */
uint32_t NumberOfSymbols; /**< Number of symbol entries in COFF symbol table*/
uint16_t SizeOfOptionalHeader; /**< Size of optional header */
uint16_t Characteristics; /**< Object/Image attribute flags */
} sImgFileHeader;
#define IMG_SIZEOF_NT_OPTIONAL32_HEADER 224
#define IMG_SIZEOF_NT_OPTIONAL64_HEADER 240
/**
* PE32+ Headers structure layout on disk
*/
typedef struct sImgNtHeaders64 {
uint32_t Signature; /**< PE\0\0 signature */
sImgFileHeader FileHeader; /**< Common PE32/PE32+ header */
sImgOptionalHeaders64 OptionalHeader; /**< Optional fields for 64bit PE32+ executables */
} sImgNtHeaders64;
/**
* PE32 Headers structure layout on disk
*/
typedef struct sImgNtHeaders32 {
uint32_t Signature; /**< PE\0\0 signature */
sImgFileHeader FileHeader; /**< Common PE32/PE32+ header */
sImgOptionalHeaders32 OptionalHeader; /**< Optional fields for 32bit PE32 executables */
} sImgNtHeaders32;
/**
* Generic object type to hold both PE32 and PE32+ headers
*/
typedef union uImgHeader {
sImgNtHeaders32 hdr32; /**< PE32 header */
sImgNtHeaders64 hdr64; /**< PE32+ header */
} uImgHeader;
#define IMG_FIRST_SECTION(ntheader) ((sImgSectionHdr *) ((ULONG_PTR)ntheader + FIELD_OFFSET(IMAGE_NT_HEADERS,OptionalHeader) + ((PIMAGE_NT_HEADERS)(ntheader))->FileHeader.SizeOfOptionalHeader))
/**
* Section header structure layout
*/
typedef struct sImgSectionHdr {
unsigned char Name[8]; /**< Section Name */
union {
uint32_t PhysicalAddress; /**< */
uint32_t VirtualSize; /**< Total section size when loaded in memory */
} Misc;
uint32_t VirtualAddress; /**< Section offset from image base */
uint32_t SizeOfRawData; /**< Size of section on disk */
uint32_t PointerToRawData; /**< Pointer to first page of section */
uint32_t PointerToRelocations; /**< Pointer to section relocation entries */
uint32_t PointerToLinenumbers; /**< Pointer to COFF debug line-number entries */
uint16_t NumberOfRelocations; /**< Number of relocation entries in section */
uint16_t NumberOfLinenumbers; /**< Number of line-number entries in section */
uint32_t Characteristics; /**< Section characteristics flag */
} sImgSectionHdr;
/**
* Finds PE signature in file associated with fp
* @param[in] fp Pointer to a file
* @param[out] be64 indicates if PE is 64bit if 1, 32bit otherwise
*@return Offset at which a PE signature is found
*/
int32_t genidl_ispe (FILE *fp, int32_t *be64);
/**
* Reads the typelib from a file
* @param[in] fp Pointer to file
* @param[in] nores typelib to read in directory
* @param[out] pDta raw typelib info
* @param[out] szDta size of raw typelib information
* @return 1 for success
*/
int32_t genidl_pe_typelib_resource_read (FILE *fp, int32_t noRes, unsigned char **pDta, size_t *szDta);
/**
* Counts the number of typelib resources
* @param[in] fp File to check
* @return number of found typelib resource
*/
int32_t genidl_pe_typelib_resource_count (FILE *fp);
typedef struct sImgResourceDataEntry {
uint32_t OffsetToData;
uint32_t Size;
uint32_t CodePage;
uint32_t Reserved;
} sImgResourceDataEntry;
#ifdef __GNUC__
__extension__
#endif
typedef struct sImgResourceDirectoryEntry {
#ifdef __GNUC__
__extension__
#endif
union {
#ifdef __GNUC__
__extension__
#endif
struct {
uint32_t NameOffset:31;
uint32_t NameIsString:1;
};
uint32_t Name;
uint16_t Id;
};
#ifdef __GNUC__
__extension__
#endif
union {
uint32_t OffsetToData;
#ifdef __GNUC__
__extension__
#endif
struct {
uint32_t OffsetToDirectory:31;
uint32_t DataIsDirectory:1;
};
};
} sImgResourceDirectoryEntry;
typedef struct sImgResourceDirStringWC {
uint16_t Length;
uint16_t NameString[1];
} sImgResourceDirStringWC;
typedef struct sImgResourceDirectory {
uint32_t Characteristics;
uint32_t TimeDateStamp;
uint16_t MajorVersion;
uint16_t MinorVersion;
uint16_t NumberOfNamedEntries;
uint16_t NumberOfIdEntries;
} sImgResourceDirectory;
#define GENIDL_IMG_RESDATA_IS_DIR 0x80000000
#define GENIDL_IMG_RESNAME_IS_STR 0x80000000
#pragma pack(pop)
#endif