using System; using System.Collections.Generic; using System.IO; using System.Text; namespace BinaryObjectScanner.Wrappers { public class NewExecutable : WrapperBase { #region Descriptive Properties /// public override string DescriptionString => "New Executable (NE)"; #endregion #region Pass-Through Properties #region MS-DOS Stub #region Standard Fields /// #if NET48 public string Stub_Magic => _model.Stub.Header.Magic; #else public string? Stub_Magic => _model.Stub?.Header?.Magic; #endif /// #if NET48 public ushort Stub_LastPageBytes => _model.Stub.Header.LastPageBytes; #else public ushort? Stub_LastPageBytes => _model.Stub?.Header?.LastPageBytes; #endif /// #if NET48 public ushort Stub_Pages => _model.Stub.Header.Pages; #else public ushort? Stub_Pages => _model.Stub?.Header?.Pages; #endif /// #if NET48 public ushort Stub_RelocationItems => _model.Stub.Header.RelocationItems; #else public ushort? Stub_RelocationItems => _model.Stub?.Header?.RelocationItems; #endif /// #if NET48 public ushort Stub_HeaderParagraphSize => _model.Stub.Header.HeaderParagraphSize; #else public ushort? Stub_HeaderParagraphSize => _model.Stub?.Header?.HeaderParagraphSize; #endif /// #if NET48 public ushort Stub_MinimumExtraParagraphs => _model.Stub.Header.MinimumExtraParagraphs; #else public ushort? Stub_MinimumExtraParagraphs => _model.Stub?.Header?.MinimumExtraParagraphs; #endif /// #if NET48 public ushort Stub_MaximumExtraParagraphs => _model.Stub.Header.MaximumExtraParagraphs; #else public ushort? Stub_MaximumExtraParagraphs => _model.Stub?.Header?.MaximumExtraParagraphs; #endif /// #if NET48 public ushort Stub_InitialSSValue => _model.Stub.Header.InitialSSValue; #else public ushort? Stub_InitialSSValue => _model.Stub?.Header?.InitialSSValue; #endif /// #if NET48 public ushort Stub_InitialSPValue => _model.Stub.Header.InitialSPValue; #else public ushort? Stub_InitialSPValue => _model.Stub?.Header?.InitialSPValue; #endif /// #if NET48 public ushort Stub_Checksum => _model.Stub.Header.Checksum; #else public ushort? Stub_Checksum => _model.Stub?.Header?.Checksum; #endif /// #if NET48 public ushort Stub_InitialIPValue => _model.Stub.Header.InitialIPValue; #else public ushort? Stub_InitialIPValue => _model.Stub?.Header?.InitialIPValue; #endif /// #if NET48 public ushort Stub_InitialCSValue => _model.Stub.Header.InitialCSValue; #else public ushort? Stub_InitialCSValue => _model.Stub?.Header?.InitialCSValue; #endif /// #if NET48 public ushort Stub_RelocationTableAddr => _model.Stub.Header.RelocationTableAddr; #else public ushort? Stub_RelocationTableAddr => _model.Stub?.Header?.RelocationTableAddr; #endif /// #if NET48 public ushort Stub_OverlayNumber => _model.Stub.Header.OverlayNumber; #else public ushort? Stub_OverlayNumber => _model.Stub?.Header?.OverlayNumber; #endif #endregion #region PE Extensions /// #if NET48 public ushort[] Stub_Reserved1 => _model.Stub.Header.Reserved1; #else public ushort[]? Stub_Reserved1 => _model.Stub?.Header?.Reserved1; #endif /// #if NET48 public ushort Stub_OEMIdentifier => _model.Stub.Header.OEMIdentifier; #else public ushort? Stub_OEMIdentifier => _model.Stub?.Header?.OEMIdentifier; #endif /// #if NET48 public ushort Stub_OEMInformation => _model.Stub.Header.OEMInformation; #else public ushort? Stub_OEMInformation => _model.Stub?.Header?.OEMInformation; #endif /// #if NET48 public ushort[] Stub_Reserved2 => _model.Stub.Header.Reserved2; #else public ushort[]? Stub_Reserved2 => _model.Stub?.Header?.Reserved2; #endif /// #if NET48 public uint Stub_NewExeHeaderAddr => _model.Stub.Header.NewExeHeaderAddr; #else public uint? Stub_NewExeHeaderAddr => _model.Stub?.Header?.NewExeHeaderAddr; #endif #endregion #endregion #region Header /// #if NET48 public string Magic => _model.Header.Magic; #else public string? Magic => _model.Header?.Magic; #endif /// #if NET48 public byte LinkerVersion => _model.Header.LinkerVersion; #else public byte? LinkerVersion => _model.Header?.LinkerVersion; #endif /// #if NET48 public byte LinkerRevision => _model.Header.LinkerRevision; #else public byte? LinkerRevision => _model.Header?.LinkerRevision; #endif /// #if NET48 public ushort EntryTableOffset => _model.Header.EntryTableOffset; #else public ushort? EntryTableOffset => _model.Header?.EntryTableOffset; #endif /// #if NET48 public ushort EntryTableSize => _model.Header.EntryTableSize; #else public ushort? EntryTableSize => _model.Header?.EntryTableSize; #endif /// #if NET48 public uint CrcChecksum => _model.Header.CrcChecksum; #else public uint? CrcChecksum => _model.Header?.CrcChecksum; #endif /// #if NET48 public SabreTools.Models.NewExecutable.HeaderFlag FlagWord => _model.Header.FlagWord; #else public SabreTools.Models.NewExecutable.HeaderFlag? FlagWord => _model.Header?.FlagWord; #endif /// #if NET48 public ushort AutomaticDataSegmentNumber => _model.Header.AutomaticDataSegmentNumber; #else public ushort? AutomaticDataSegmentNumber => _model.Header?.AutomaticDataSegmentNumber; #endif /// #if NET48 public ushort InitialHeapAlloc => _model.Header.InitialHeapAlloc; #else public ushort? InitialHeapAlloc => _model.Header?.InitialHeapAlloc; #endif /// #if NET48 public ushort InitialStackAlloc => _model.Header.InitialStackAlloc; #else public ushort? InitialStackAlloc => _model.Header?.InitialStackAlloc; #endif /// #if NET48 public uint InitialCSIPSetting => _model.Header.InitialCSIPSetting; #else public uint? InitialCSIPSetting => _model.Header?.InitialCSIPSetting; #endif /// #if NET48 public uint InitialSSSPSetting => _model.Header.InitialSSSPSetting; #else public uint? InitialSSSPSetting => _model.Header?.InitialSSSPSetting; #endif /// #if NET48 public ushort FileSegmentCount => _model.Header.FileSegmentCount; #else public ushort? FileSegmentCount => _model.Header?.FileSegmentCount; #endif /// #if NET48 public ushort ModuleReferenceTableSize => _model.Header.ModuleReferenceTableSize; #else public ushort? ModuleReferenceTableSize => _model.Header?.ModuleReferenceTableSize; #endif /// #if NET48 public ushort NonResidentNameTableSize => _model.Header.NonResidentNameTableSize; #else public ushort? NonResidentNameTableSize => _model.Header?.NonResidentNameTableSize; #endif /// #if NET48 public ushort SegmentTableOffset => _model.Header.SegmentTableOffset; #else public ushort? SegmentTableOffset => _model.Header?.SegmentTableOffset; #endif /// #if NET48 public ushort ResourceTableOffset => _model.Header.ResourceTableOffset; #else public ushort? ResourceTableOffset => _model.Header?.ResourceTableOffset; #endif /// #if NET48 public ushort ResidentNameTableOffset => _model.Header.ResidentNameTableOffset; #else public ushort? ResidentNameTableOffset => _model.Header?.ResidentNameTableOffset; #endif /// #if NET48 public ushort ModuleReferenceTableOffset => _model.Header.ModuleReferenceTableOffset; #else public ushort? ModuleReferenceTableOffset => _model.Header?.ModuleReferenceTableOffset; #endif /// #if NET48 public ushort ImportedNamesTableOffset => _model.Header.ImportedNamesTableOffset; #else public ushort? ImportedNamesTableOffset => _model.Header?.ImportedNamesTableOffset; #endif /// #if NET48 public uint NonResidentNamesTableOffset => _model.Header.NonResidentNamesTableOffset; #else public uint? NonResidentNamesTableOffset => _model.Header?.NonResidentNamesTableOffset; #endif /// #if NET48 public ushort MovableEntriesCount => _model.Header.MovableEntriesCount; #else public ushort? MovableEntriesCount => _model.Header?.MovableEntriesCount; #endif /// #if NET48 public ushort SegmentAlignmentShiftCount => _model.Header.SegmentAlignmentShiftCount; #else public ushort? SegmentAlignmentShiftCount => _model.Header?.SegmentAlignmentShiftCount; #endif /// #if NET48 public ushort ResourceEntriesCount => _model.Header.ResourceEntriesCount; #else public ushort? ResourceEntriesCount => _model.Header?.ResourceEntriesCount; #endif /// #if NET48 public SabreTools.Models.NewExecutable.OperatingSystem TargetOperatingSystem => _model.Header.TargetOperatingSystem; #else public SabreTools.Models.NewExecutable.OperatingSystem? TargetOperatingSystem => _model.Header?.TargetOperatingSystem; #endif /// #if NET48 public SabreTools.Models.NewExecutable.OS2Flag AdditionalFlags => _model.Header.AdditionalFlags; #else public SabreTools.Models.NewExecutable.OS2Flag? AdditionalFlags => _model.Header?.AdditionalFlags; #endif /// #if NET48 public ushort ReturnThunkOffset => _model.Header.ReturnThunkOffset; #else public ushort? ReturnThunkOffset => _model.Header?.ReturnThunkOffset; #endif /// #if NET48 public ushort SegmentReferenceThunkOffset => _model.Header.SegmentReferenceThunkOffset; #else public ushort? SegmentReferenceThunkOffset => _model.Header?.SegmentReferenceThunkOffset; #endif /// #if NET48 public ushort MinCodeSwapAreaSize => _model.Header.MinCodeSwapAreaSize; #else public ushort? MinCodeSwapAreaSize => _model.Header?.MinCodeSwapAreaSize; #endif /// #if NET48 public byte WindowsSDKRevision => _model.Header.WindowsSDKRevision; #else public byte? WindowsSDKRevision => _model.Header?.WindowsSDKRevision; #endif /// #if NET48 public byte WindowsSDKVersion => _model.Header.WindowsSDKVersion; #else public byte? WindowsSDKVersion => _model.Header?.WindowsSDKVersion; #endif #endregion #region Tables /// #if NET48 public SabreTools.Models.NewExecutable.SegmentTableEntry[] SegmentTable => _model.SegmentTable; #else public SabreTools.Models.NewExecutable.SegmentTableEntry?[]? SegmentTable => _model.SegmentTable; #endif /// #if NET48 public SabreTools.Models.NewExecutable.ResourceTable ResourceTable => _model.ResourceTable; #else public SabreTools.Models.NewExecutable.ResourceTable? ResourceTable => _model.ResourceTable; #endif /// #if NET48 public SabreTools.Models.NewExecutable.ResidentNameTableEntry[] ResidentNameTable => _model.ResidentNameTable; #else public SabreTools.Models.NewExecutable.ResidentNameTableEntry?[]? ResidentNameTable => _model.ResidentNameTable; #endif /// #if NET48 public SabreTools.Models.NewExecutable.ModuleReferenceTableEntry[] ModuleReferenceTable => _model.ModuleReferenceTable; #else public SabreTools.Models.NewExecutable.ModuleReferenceTableEntry?[]? ModuleReferenceTable => _model.ModuleReferenceTable; #endif /// #if NET48 public Dictionary ImportedNameTable => _model.ImportedNameTable; #else public Dictionary? ImportedNameTable => _model.ImportedNameTable; #endif /// #if NET48 public SabreTools.Models.NewExecutable.EntryTableBundle[] EntryTable => _model.EntryTable; #else public SabreTools.Models.NewExecutable.EntryTableBundle?[]? EntryTable => _model.EntryTable; #endif /// #if NET48 public SabreTools.Models.NewExecutable.NonResidentNameTableEntry[] NonResidentNameTable => _model.NonResidentNameTable; #else public SabreTools.Models.NewExecutable.NonResidentNameTableEntry?[]? NonResidentNameTable => _model.NonResidentNameTable; #endif #endregion #endregion #region Extension Properties // TODO: Determine what extension properties are needed #endregion #region Constructors /// #if NET48 public NewExecutable(SabreTools.Models.NewExecutable.Executable model, byte[] data, int offset) #else public NewExecutable(SabreTools.Models.NewExecutable.Executable? model, byte[]? data, int offset) #endif : base(model, data, offset) { // All logic is handled by the base class } /// #if NET48 public NewExecutable(SabreTools.Models.NewExecutable.Executable model, Stream data) #else public NewExecutable(SabreTools.Models.NewExecutable.Executable? model, Stream? data) #endif : base(model, data) { // All logic is handled by the base class } /// /// Create an NE executable from a byte array and offset /// /// Byte array representing the executable /// Offset within the array to parse /// An NE executable wrapper on success, null on failure #if NET48 public static NewExecutable Create(byte[] data, int offset) #else public static NewExecutable? Create(byte[]? data, int offset) #endif { // If the data is invalid if (data == null) return null; // If the offset is out of bounds if (offset < 0 || offset >= data.Length) return null; // Create a memory stream and use that MemoryStream dataStream = new MemoryStream(data, offset, data.Length - offset); return Create(dataStream); } /// /// Create an NE executable from a Stream /// /// Stream representing the executable /// An NE executable wrapper on success, null on failure #if NET48 public static NewExecutable Create(Stream data) #else public static NewExecutable? Create(Stream? data) #endif { // If the data is invalid if (data == null || data.Length == 0 || !data.CanSeek || !data.CanRead) return null; var executable = new SabreTools.Serialization.Streams.NewExecutable().Deserialize(data); if (executable == null) return null; try { return new NewExecutable(executable, data); } catch { return null; } } #endregion #region Printing /// public override StringBuilder PrettyPrint() { StringBuilder builder = new StringBuilder(); Printing.NewExecutable.Print(builder, _model); return builder; } #if NET6_0_OR_GREATER /// public override string ExportJSON() => System.Text.Json.JsonSerializer.Serialize(_model, _jsonSerializerOptions); #endif #endregion #region REMOVE -- DO NOT USE /// /// Read an arbitrary range from the source /// /// The start of where to read data from, -1 means start of source /// How many bytes to read, -1 means read until end /// Byte array representing the range, null on error [Obsolete] #if NET48 public byte[] ReadArbitraryRange(int rangeStart = -1, int length = -1) #else public byte[]? ReadArbitraryRange(int rangeStart = -1, int length = -1) #endif { // If we have an unset range start, read from the start of the source if (rangeStart == -1) rangeStart = 0; // If we have an unset length, read the whole source if (length == -1) { switch (_dataSource) { case DataSource.ByteArray: #if NET48 length = _byteArrayData.Length - _byteArrayOffset; #else length = _byteArrayData!.Length - _byteArrayOffset; #endif break; case DataSource.Stream: #if NET48 length = (int)_streamData.Length; #else length = (int)_streamData!.Length; #endif break; } } return ReadFromDataSource(rangeStart, length); } #endregion } }