@isopodlabs/binary_libs 0.1.1 → 0.1.3

package/src/pe.ts

@@ -1,506 +0,0 @@
-import * as binary from '@isopodlabs/binary';
-import * as path from 'path';
-
-class MyDate extends Date {
-	constructor(x: number) { super(x * 1000); }
-	valueOf()	{ return this.getTime() / 1000; }
-	toString()	{ return super.toString(); }
-}
-
-const uint16	= binary.UINT16_LE;
-const uint32	= binary.UINT32_LE;
-const uint64	= binary.UINT64_LE;
-
-const TIMEDATE = binary.as(uint32, MyDate);
-
-//-----------------------------------------------------------------------------
-//	COFF
-//-----------------------------------------------------------------------------
-
-const DOS_HEADER = {
-	magic:		uint16,
-	cblp:		uint16,
-	cp:			uint16,
-	crlc:		uint16,
-	cparhdr:	uint16,
-	minalloc:	uint16,
-	maxalloc:	binary.asHex(uint16),
-	ss:			uint16,
-	sp:			uint16,
-	csum:		uint16,
-	ip:			uint16,
-	cs:			uint16,
-	lfarlc:		uint16,
-	ovno:		uint16,
-};
-
-const EXE_HEADER = {
-	res:		binary.ArrayType(4, uint16),
-	oemid:		uint16,
-	oeminfo:	uint16,
-	res2:		binary.ArrayType(10, uint16),
-	lfanew:		binary.INT32_LE,
-};
-
-//-----------------------------------------------------------------------------
-//	PE
-//-----------------------------------------------------------------------------
-
-export class pe_stream extends binary.stream {
-	constructor(public pe: PE, data: Uint8Array) {
-		super(data);
-	}
-	get_rva()	{ return this.pe.GetDataRVA(uint32.get(this))?.data; }
-}
-
-const RVA_STRING = {
-	get(s: pe_stream)	{ return binary.utils.decodeTextTo0(s.get_rva(), 'utf8'); },
-	put(_s: pe_stream)	{}
-};
-const RVA_ARRAY16 = {
-	get(s: pe_stream)	{ return binary.utils.to16(s.get_rva()); },
-	put(_s: pe_stream)	{}
-};
-const RVA_ARRAY32 = {
-	get(s: pe_stream)	{ return binary.utils.to32(s.get_rva()); },
-	put(_s: pe_stream)	{}
-};
-const RVA_ARRAY64 = {
-	get(s: pe_stream)	{ return binary.utils.to64(s.get_rva()); },
-	put(_s: pe_stream)	{}
-};
-
-const FILE_HEADER = {
-	Machine:				uint16,
-	NumberOfSections:		uint16,
-	TimeDateStamp:			uint32,
-	PointerToSymbolTable:	uint32,
-	NumberOfSymbols:		uint32,
-	SizeOfOptionalHeader:	uint16,
-	Characteristics:		uint16,
-};
-
-const SECTION_CHARACTERISTICS = {
-//							0x00000000,
-//							0x00000001,
-//							0x00000002,
-//							0x00000004,
-	TYPE_NO_PAD:			0x00000008,
-//							0x00000010,
-	CNT_CODE:				0x00000020,
-	CNT_INITIALIZED_DATA:	0x00000040,
-	CNT_UNINITIALIZED_DATA:	0x00000080,
-	LNK_OTHER:				0x00000100,
-	LNK_INFO:				0x00000200,
-//							0x00000400,
-	LNK_REMOVE:				0x00000800,
-	LNK_COMDAT:				0x00001000,
-	GPREL:					0x00008000,
-//	MEM_PURGEABLE			0x00020000,
-	MEM_16BIT:				0x00020000,
-	MEM_LOCKED:				0x00040000,
-	MEM_PRELOAD:			0x00080000,
-	ALIGN:					0x00f00000,
-	//ALIGN_1BYTES			0x00100000,
-	//ALIGN_2BYTES			0x00200000,
-	//ALIGN_4BYTES			0x00300000,
-	//ALIGN_8BYTES			0x00400000,
-	//ALIGN_16BYTES			0x00500000,
-	//ALIGN_32BYTES			0x00600000,
-	//ALIGN_64BYTES			0x00700000,
-	//ALIGN_128BYTES		0x00800000,
-	//ALIGN_256BYTES		0x00900000,
-	//ALIGN_512BYTES		0x00A00000,
-	//ALIGN_1024BYTES		0x00B00000,
-	//ALIGN_2048BYTES		0x00C00000,
-	//ALIGN_4096BYTES		0x00D00000,
-	//ALIGN_8192BYTES		0x00E00000,
-	LNK_NRELOC_OVFL:		0x01000000,
-	MEM_DISCARDABLE:		0x02000000,
-	MEM_NOT_CACHED:			0x04000000,
-	MEM_NOT_PAGED:			0x08000000,
-	MEM_SHARED:				0x10000000,
-	MEM_EXECUTE:			0x20000000,
-	MEM_READ:				0x40000000,
-	MEM_WRITE:				0x80000000,
-} as const;
-
-class Section extends binary.ReadClass({
-	Name:					binary.StringType(8),
-	VirtualSize:			uint32,
-	VirtualAddress:			binary.asHex(uint32),
-	SizeOfRawData:			uint32,
-	PointerToRawData:		binary.asHex(uint32),
-	PointerToRelocations:	binary.asHex(uint32),
-	PointerToLinenumbers:	binary.asHex(uint32),
-	NumberOfRelocations:	binary.INT16_LE,
-	NumberOfLinenumbers:	binary.INT16_LE,
-	Characteristics:		binary.asFlags(uint32, SECTION_CHARACTERISTICS)
-}) {
-	data?: binary.MappedMemory;
-	constructor(r: binary.stream) {
-		super(r);
-		try {
-			this.data = new binary.MappedMemory(r.buffer_at(+this.PointerToRawData, this.SizeOfRawData), +this.VirtualAddress, this.flags);
-		} catch (e) {
-			console.log(e);
-		}
-	}
-	get flags() {
-		return binary.MEM.RELATIVE
-			| (this.Characteristics.MEM_READ	? binary.MEM.READ 	: 0)
-			| (this.Characteristics.MEM_WRITE	? binary.MEM.WRITE 	: 0)
-			| (this.Characteristics.MEM_EXECUTE	? binary.MEM.EXECUTE	: 0);
-	}
-}
-
-interface DirectoryInfo {
-	read?: (pe: PE, data: binary.MappedMemory) => any;
-}
-
-export const DIRECTORIES : Record<string, DirectoryInfo> = {
-	EXPORT:			{read: (pe, data) => ReadExports(new pe_stream(pe, data.data)) },
-	IMPORT:			{read: (pe, data) => ReadImports(new pe_stream(pe, data.data)) },
-	RESOURCE:		{read: (pe, data) => ReadResourceDirectory(new binary.stream(data.data), data)},
-	EXCEPTION:		{},	// Exception Directory
-	SECURITY:		{},	// Security Directory
-	BASERELOC:		{},	// Base Relocation Table
-	DEBUG_DIR:		{},	// Debug Directory
-	ARCHITECTURE:	{},	// Architecture Specific Data
-	GLOBALPTR:		{},	// RVA of GP
-	TLS:			{},
-	LOAD_CONFIG:	{},	// Load Configuration Directory
-	BOUND_IMPORT:	{},	// Bound Import Directory in headers
-	IAT:			{},	// Import Address Table
-	DELAY_IMPORT:	{},
-	CLR_DESCRIPTOR:	{},
-};
-
-export const DATA_DIRECTORY = {
-	VirtualAddress: 			uint32,
-	Size: 						uint32,
-};
-
-type Directory = binary.ReadType<typeof DATA_DIRECTORY>;
-
-const MAGIC = {
-	NT32:		0x10b,
-	NT64:		0x20b,
-	ROM:		0x107,
-	OBJ:		0x104,	// object files, eg as output
-//	DEMAND:		0x10b,	// demand load format, eg normal ld output
-	TARGET:		0x101,	// target shlib
-	HOST:		0x123,	// host   shlib
-};
-
-const DLLCHARACTERISTICS = {
-	DYNAMIC_BASE:		  	0x0040,	// DLL can be relocated at load time (ASLR)
-	FORCE_INTEGRITY:	   	0x0080,	// Code integrity checks are enforced
-	NX_COMPAT:			 	0x0100,	// Image is NX compatible (DEP)
-	NO_ISOLATION:		  	0x0200,	// Isolation aware, but do not isolate the image
-	NO_SEH:					0x0400,	// Does not use structured exception handling
-	NO_BIND:			   	0x0800,	// Do not bind the image
-	WDM_DRIVER:				0x2000,	// Driver uses WDM model
-	TERMINAL_SERVER_AWARE: 	0x8000,	// Terminal Server aware
-};
-
-const OPTIONAL_HEADER = {
-	Magic:						binary.asEnum(uint16, MAGIC),
-	MajorLinkerVersion:			binary.UINT8,
-	MinorLinkerVersion:			binary.UINT8,
-	SizeOfCode:					uint32,
-	SizeOfInitializedData:		uint32,
-	SizeOfUninitializedData:	uint32,
-	AddressOfEntryPoint:		binary.asHex(uint32),
-	BaseOfCode:					binary.asHex(uint32),
-};
-
-const OPTIONAL_HEADER32 = {
-	BaseOfData: 				binary.asHex(uint32),
-	ImageBase:  				binary.asHex(uint32),
-	SectionAlignment:   		uint32,
-	FileAlignment:  			uint32,
-	MajorOperatingSystemVersion:uint16,
-	MinorOperatingSystemVersion:uint16,
-	MajorImageVersion:  		uint16,
-	MinorImageVersion:  		uint16,
-	MajorSubsystemVersion:  	uint16,
-	MinorSubsystemVersion:  	uint16,
-	Win32VersionValue:  		uint32,
-	SizeOfImage:				uint32,
-	SizeOfHeaders:  			uint32,
-	CheckSum:   				uint32,
-	Subsystem:  				uint16,
-	DllCharacteristics: 		binary.asFlags(uint16, DLLCHARACTERISTICS),
-	SizeOfStackReserve: 		uint32,
-	SizeOfStackCommit:  		uint32,
-	SizeOfHeapReserve:  		uint32,
-	SizeOfHeapCommit:   		uint32,
-	LoaderFlags:				uint32,
-	DataDirectory:  			binary.objectWithNames(binary.ArrayType(uint32, DATA_DIRECTORY), binary.names(Object.keys(DIRECTORIES))),
-};
-
-const OPTIONAL_HEADER64 = {
-	ImageBase:  				binary.asHex(uint64),
-	SectionAlignment:   		uint32,
-	FileAlignment:  			uint32,
-	MajorOperatingSystemVersion:uint16,
-	MinorOperatingSystemVersion:uint16,
-	MajorImageVersion:  		uint16,
-	MinorImageVersion:  		uint16,
-	MajorSubsystemVersion:  	uint16,
-	MinorSubsystemVersion:  	uint16,
-	Win32VersionValue:  		uint32,
-	SizeOfImage:				uint32,
-	SizeOfHeaders:  			uint32,
-	CheckSum:   				uint32,
-	Subsystem:  				uint16,
-	DllCharacteristics: 		binary.asFlags(uint16, DLLCHARACTERISTICS),
-	SizeOfStackReserve: 		uint64,
-	SizeOfStackCommit:  		uint64,
-	SizeOfHeapReserve:  		uint64,
-	SizeOfHeapCommit:   		uint64,
-	LoaderFlags:				uint32,
-	DataDirectory:  			binary.objectWithNames(binary.ArrayType(uint32, DATA_DIRECTORY), binary.names(Object.keys(DIRECTORIES))),
-};
-
-export class PE {
-	header:		binary.ReadType<typeof DOS_HEADER> & binary.ReadType<typeof EXE_HEADER>;
-	opt?:		binary.ReadType<typeof OPTIONAL_HEADER> & (binary.ReadType<typeof OPTIONAL_HEADER32> | binary.ReadType<typeof OPTIONAL_HEADER64>);
-	sections:	Section[];
-
-	static check(data: Uint8Array): boolean {
-		return uint16.get(new binary.stream(data)) === binary.utils.stringCode("MZ");
-	}
-
-	constructor(private data: Uint8Array) {
-		const file	= new binary.stream(data);
-		this.header	= binary.read(file, {...DOS_HEADER, ...EXE_HEADER});
-
-		file.seek(this.header.lfanew);
-		if (uint32.get(file) == binary.utils.stringCode("PE\0\0")) {
-			const h = binary.read(file, FILE_HEADER);
-
-			if (h.SizeOfOptionalHeader) {
-				const opt	= new binary.stream(file.read_buffer(h.SizeOfOptionalHeader));
-				const opt1	= binary.read(opt, OPTIONAL_HEADER);
-				if (opt1.Magic == 'NT32')
-					this.opt = binary.read_more(opt, OPTIONAL_HEADER32, opt1);
-				else if (opt1.Magic == 'NT64')
-					this.opt = binary.read_more(opt, OPTIONAL_HEADER64, opt1);
-			}
-
-			this.sections = Array.from({length: h.NumberOfSections}, () => new Section(file));
-		} else {
-			this.sections = [];
-		}
-	}
-
-	get directories() {
-		return this.opt?.DataDirectory;
-	}
-
-	FindSectionRVA(rva: number) {
-		for (const i of this.sections) {
-			if (rva >= +i.VirtualAddress && rva < +i.VirtualAddress + i.SizeOfRawData)
-				return i;
-		}
-	}
-
-	FindSectionRaw(addr: number) {
-		for (const i of this.sections) {
-			if (addr >= +i.PointerToRawData && addr < +i.PointerToRawData + i.SizeOfRawData)
-				return i;
-		}
-	}
-
-	GetDataRVA(rva: number, size?: number) {
-		const sect = this.FindSectionRVA(rva);
-		if (sect && sect.data)
-			return sect.data.at(rva, size);
-	}
-	GetDataRaw(addr: number, size: number) {
-		const sect = this.FindSectionRaw(addr);
-		if (sect && sect.data) {
-			const offset = addr - +sect.PointerToRawData;
-			return sect.data.data.subarray(offset, offset + size);
-		}
-	}
-	GetDataDir(dir: Directory) {
-		if (dir.Size)
-			return this.GetDataRVA(dir.VirtualAddress, dir.Size);
-	}
-
-	ReadDirectory(name: string) {
-		const dir	= this.opt?.DataDirectory[name];
-		if (dir?.Size) {
-			const data 	= this.GetDataDir(dir);
-			const info	= DIRECTORIES[name];
-			if (data && info?.read)
-				return info.read(this, data);
-			return data;
-		}
-	}
-}
-
-
-//-----------------------------------------------------------------------------
-//	exports
-//-----------------------------------------------------------------------------
-
-const EXPORT_DIRECTORY = {
-	ExportFlags:	uint32,	// Reserved, must be 0.
-	TimeDateStamp:	TIMEDATE,			// The time and date that the export data was created.
-	MajorVersion:	binary.asHex(uint16),	// The major version number. The major and minor version numbers can be set by the user.
-	MinorVersion:	binary.asHex(uint16),	// The minor version number.
-	DLLName:		RVA_STRING,			// The address of the ASCII string that contains the name of the DLL. This address is relative to the image base.
-	OrdinalBase:	uint32,				// The starting ordinal number for exports in this image. This field specifies the starting ordinal number for the export address table. It is usually set to 1.
-	NumberEntries:	uint32,				// The number of entries in the export address table.
-	NumberNames:	uint32,				// The number of entries in the name pointer table. This is also the number of entries in the ordinal table.
-	FunctionTable:	RVA_ARRAY32,		// RVA of functions
-	NameTable:		RVA_ARRAY32,		// RVA of names
-	OrdinalTable:	RVA_ARRAY16,		// RVA from base of image
-};
-
-interface ExportEntry {
-	ordinal: number;
-	name: string;
-	address: number;
-}
-
-export function ReadExports(file: pe_stream) {
-	const dir 		= binary.read(file, EXPORT_DIRECTORY);
-	const addresses	= dir.FunctionTable!;
-	const names		= dir.NameTable;
-	const ordinals	= dir.OrdinalTable;
-
-	const result: ExportEntry[] = [];
-	for (let i = 0; i < dir.NumberEntries; i++) {
-		const sect = file.pe.FindSectionRVA(addresses[i]);
-		if (sect) {
-			const ordinal	= (ordinals && i < dir.NumberNames ? ordinals[i] : i) + dir.OrdinalBase;
-			const name		= names && i < dir.NumberNames ? binary.utils.decodeTextTo0(file.pe.GetDataRVA(names[i])?.data, 'utf8') : '';
-			result.push({ordinal, name, address: addresses[i]});
-		}
-	}
-	const sorted = result.sort((a, b)=> a.address - b.address);
-	return sorted.map((v, i) => {
-		let j = i;
-		while (++j < sorted.length && sorted[j].address == v.address);
-		return [v.ordinal, v.name, file.pe.GetDataRVA(v.address, j < sorted.length ? sorted[j].address - v.address : undefined)];
-	});
-}
-
-//-----------------------------------------------------------------------------
-//	imports
-//-----------------------------------------------------------------------------
-
-export class DLLImports extends Array {}
-
-const RVA_ITA64 = {
-	get(s: pe_stream)	{ 
-		const r = binary.utils.to64(s.get_rva());
-		if (r) {
-			const result = Array.from(r.subarray(0, r.indexOf(0n)), i =>
-				i >> 63n
-					? `ordinal_${i - (1n << 63n)}`
-					: binary.utils.decodeTextTo0(s.pe.GetDataRVA(Number(i))?.data.subarray(2), 'utf8')
-			);
-			Object.setPrototypeOf(result, DLLImports.prototype);
-			return result;
-		}
-	},
-	put(_s: pe_stream)	{}
-};
-
-const IMPORT_DESCRIPTOR = {
-	Characteristics:	uint32,	// 0 for terminating null import descriptor
-	TimeDateStamp:  	TIMEDATE,			// 0 if not bound, -1 if bound, and real date\time stamp in IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT (new BIND)	// O.W. date/time stamp of DLL bound to (Old BIND)
-	ForwarderChain: 	uint32,	// -1 if no forwarders
-	DllName:			RVA_STRING,//uint32,
-	FirstThunk:			RVA_ITA64,//uint32,	// RVA to IAT (if bound this IAT has actual addresses)
-};
-
-export function ReadImports(file: pe_stream) {
-	const result: [string, any][] = [];
-	while (file.remaining()) {
-		const r = binary.read(file, IMPORT_DESCRIPTOR);
-		if (!r.Characteristics)
-			break;
-		result.push([r.DllName, r.FirstThunk]);
-	}
-	return result;
-}
-
-//-----------------------------------------------------------------------------
-//	resources
-//-----------------------------------------------------------------------------
-
-class RESOURCE_DATA_ENTRY extends binary.ReadClass({
-	OffsetToData:	uint32,
-	Size:			uint32,
-	CodePage:		uint32,
-	Reserved:		uint32,
-}) {
-	data:			Uint8Array;
-	constructor(file: binary.stream, data: binary.MappedMemory) {
-		super(file);
-		this.data	= data.slice(this.OffsetToData, this.OffsetToData + this.Size).data;
-	}
-}
-
-const RESOURCE_DIRECTORY = {
-	Characteristics:		uint32,
-	TimeDateStamp:			uint32,
-	MajorVersion:			uint16,
-	MinorVersion:			uint16,
-	NumberOfNamedEntries:	uint16,
-	NumberOfIdEntries:		uint16,
-	entries:				binary.ArrayType(obj=> obj.NumberOfNamedEntries + obj.NumberOfIdEntries, {
-		u0: uint32,
-		u1: uint32,
-	})
-};
-
-const IRT = {
-	0:	'NONE',
-	1:	'CURSOR',
-	2:	'BITMAP',
-	3:	'ICON',
-	4:	'MENU',
-	5:	'DIALOG',
-	6:	'STRING',
-	7:	'FONTDIR',
-	8:	'FONT',
-	9:	'ACCELERATOR',
-	10:	'RCDATA',
-	11:	'MESSAGETABLE',
-	12:	'GROUP_CURSOR',
-	14:	'GROUP_ICON',
-	16:	'VERSION',
-	17:	'DLGINCLUDE',
-	19:	'PLUGPLAY',
-	20:	'VXD',
-	21:	'ANICURSOR',
-	22:	'ANIICON',
-	23:	'HTML',
-	24:	'MANIFEST',
-	241:'TOOLBAR',
-} as const;
-
-export function ReadResourceDirectory(file: binary.stream, data: binary.MappedMemory, type = 0) {
-	const dir 		= binary.read(file, RESOURCE_DIRECTORY);
-	const id_type	= binary.StringType(uint16, 'utf16le');
-	const topbit	= 0x80000000;
-	const result : Record<string, any> = {};
-
-	for (const i of dir.entries) {
-		const id = i.u0 & topbit ? id_type.get(file.seek(i.u0 & ~topbit)) : !type ? IRT[i.u0 as keyof typeof IRT] : i.u0;
-		
-		file.seek(i.u1 & ~topbit);
-		result[id]	= i.u1 & topbit
-			? ReadResourceDirectory(file, data, type || i.u0)
-			: new RESOURCE_DATA_ENTRY(file, data);
-	}
-	return result;
-}