BinaryObjectScanner/BurnOutSharp.Models/MSDOS/ExecutableHeader.cs

using System.Runtime.InteropServices;

namespace BurnOutSharp.Models.MSDOS
{
    /// <summary>
    /// MZ executables only consists of 2 structures: the header and the relocation table.
    /// The header, which is followed by the program image, looks like this.
    /// </summary>
    /// <see href="https://wiki.osdev.org/MZ"/>
    /// <see href="http://www.pinvoke.net/default.aspx/Structures.IMAGE_DOS_HEADER"/>
    [StructLayout(LayoutKind.Sequential)]
    public class ExecutableHeader
    {
        #region Standard Fields

        /// <summary>
        /// 0x5A4D (ASCII for 'M' and 'Z')
        /// </summary>
        [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)]
        public byte[] Magic;

        /// <summary>
        /// Number of bytes in the last page.
        /// </summary>
        public ushort LastPageBytes;

        /// <summary>
        /// Number of whole/partial pages.
        /// </summary>
        /// <remarks>A page (or block) is 512 bytes long.</remarks>
        public ushort Pages;

        /// <summary>
        /// Number of entries in the relocation table.
        /// </summary>
        public ushort RelocationItems;

        /// <summary>
        /// The number of paragraphs taken up by the header. It can be any value, as the loader
        /// just uses it to find where the actual executable data starts. It may be larger than
        /// what the "standard" fields take up, and you may use it if you want to include your
        /// own header metadata, or put the relocation table there, or use it for any other purpose. [08]
        /// </summary>
        /// <remarks>A paragraph is 16 bytes in size</remarks>
        public ushort HeaderParagraphSize;

        /// <summary>
        /// The number of paragraphs required by the program, excluding the PSP and program image.
        /// If no free block is big enough, the loading stops.
        /// </summary>
        /// <remarks>A paragraph is 16 bytes in size</remarks>
        public ushort MinimumExtraParagraphs;

        /// <summary>
        /// The number of paragraphs requested by the program.
        /// If no free block is big enough, the biggest one possible is allocated.
        /// </summary>
        /// <remarks>A paragraph is 16 bytes in size</remarks>
        public ushort MaximumExtraParagraphs;

        /// <summary>
        /// Relocatable segment address for SS.
        /// </summary>
        public ushort InitialSSValue;

        /// <summary>
        /// Initial value for SP.
        /// </summary>
        public ushort InitialSPValue;

        /// <summary>
        /// When added to the sum of all other words in the file, the result should be zero.
        /// </summary>
        public ushort Checksum;

        /// <summary>
        /// Initial value for IP. [14]
        /// </summary>
        public ushort InitialIPValue;

        /// <summary>
        /// Relocatable segment address for CS.
        /// </summary>
        public ushort InitialCSValue;

        /// <summary>
        /// The (absolute) offset to the relocation table.
        /// </summary>
        public ushort RelocationTableAddr;

        /// <summary>
        /// Value used for overlay management.
        /// If zero, this is the main executable.
        /// </summary>
        public ushort OverlayNumber;

        #endregion

        #region PE Extensions

        /// <summary>
        /// Reserved words
        /// </summary>
        [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)]
        public ushort[] Reserved1;

        /// <summary>
        /// Defined by name but no other information is given; typically zeroes
        /// </summary>
        public ushort OEMIdentifier;

        /// <summary>
        /// Defined by name but no other information is given; typically zeroes
        /// </summary>
        public ushort OEMInformation;

        /// <summary>
        /// Reserved words
        /// </summary>
        [MarshalAs(UnmanagedType.ByValArray, SizeConst = 10)]
        public ushort[] Reserved2;

        /// <summary>
        /// Starting address of the PE header
        /// </summary>
        public uint NewExeHeaderAddr;

        #endregion
    }
}