Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
en:docs:tk:formats:newexe [2024/09/22 08:50] – created prokushev | en:docs:tk:formats:newexe [2024/10/13 14:35] (current) – prokushev | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== New Executable file format ====== | ||
+ | |||
+ | New Executable (NE) file format used by set of operating system including OS/2, Windows, Multitasking MS-DOS 4 and set of DOS Extenders. It is designed to be store on disk and in-memory usage. In-disk format is same for all OSes, but In-memory usage is mostly specific for Windows systems. | ||
+ | |||
^ Offset ^ Size ^ Name ^ Description ^ | ^ Offset ^ Size ^ Name ^ Description ^ | ||
- | | 00h | WORD | e_magic | + | | 00h | WORD | ne_magic |
- | | 02h | WORD | e_cblp | + | | On-disk |||| |
- | | 04h | WORD | e_cp | Number of blocks in the file that are part of the EXE file. If [02-03] is non-zero, only that much of the last block is used. | | + | | 02h | BYTE | ne_ver | Version |
- | | 06h | WORD| e_crlc | + | | 03h | BYTE| ne_rev |
- | WORD e_cparhdr; | + | | In-memory |||| |
- | WORD e_minalloc; | + | | 02h | WORD | count | Usage count (ne_ver/ |
- | WORD e_maxalloc; | + | | 04h | WORD | ne_enttab |
- | WORD e_ss; | + | | On-disk |||| |
- | WORD e_sp; /* Initial value of the SP register. */ | + | | 06h | WORD | ne_cbenttab |
- | WORD e_csum; | + | | In-memory |||| |
- | WORD e_ip; /* Initial value of the IP register. */ | + | | 06h | WORD | next | Selector to next module | |
- | WORD e_cs; /* Initial value of the CS register, relative to the segment | + | | On-disk |||| |
- | WORD e_lfarlc; | + | | 08h | DWORD | ne_crc | 32-bit CRC of entire contents of file. These words are taken as 00 during the calculation |
- | WORD e_ovno; | + | | In-memory |||| |
- | WORD e_res[ERES1WDS]; | + | | 08h | WORD | dgroup_entry | Near ptr to segment entry for DGROUP | |
- | WORD e_oemid; | + | | 0Ah | WORD | fileinfo | Near ptr to file info (OFSTRUCT) | |
- | WORD e_oeminfo; | + | | 0Ch | WORD | ne_flags | Flag word | |
- | WORD e_res2[ERES2WDS]; | + | | 0Eh | WORD | ne_autodata | Segment number |
- | | + | | 10h | WORD | ne_heap | Initial size, in bytes, |
- | }; | + | | 12h | WORD | ne_stack | Initial size, in bytes, of stack added to the data segment. This value is zero to indicate no initial stack allocation, or when SS is not equal to DS | |
+ | | 14h | DWORD | ne_csip | Segment number: | ||
+ | | 18h | DWORD | ne_sssp | Segment number: | ||
+ | | 1Ch | WORD | ne_cseg | Number | ||
+ | | 1Eh | WORD | ne_cmod | Number of entries in the Module Reference Table | | ||
+ | | 20h | WORD | ne_cbnrestab | Number | ||
+ | | 22h | WORD | ne_segtab | Segment Table file offset, relative to the beginning of the segmented EXE header | | ||
+ | | 24h | WORD | ne_rsrctab | Resource Table file offset, relative to the beginning | ||
+ | | 26h | WORD | ne_restab | Resident Name Table file offset, relative to the beginning | ||
+ | | 28h | WORD | ne_modtab | Module Reference Table file offset, relative to the beginning of the segmented EXE header | | ||
+ | | 2Ah | WORD | ne_imptab | Imported Names Table file offset, relative to the beginning | ||
+ | | 2Ch | DWORD | ne_nrestab | Non-Resident Name Table offset, relative to the beginning of the file | | ||
+ | | 30h | WORD | ne_cmovent | Number of movable entries in the Entry Table | | ||
+ | | 32h | WORD | ne_align | Logical sector alignment shift count, log(base 2) of the segment sector size (default 9) | | ||
+ | | 34h | WORD | ne_cres | Number of resource entries | | ||
+ | | 36h | BYTE | ne_exetyp | Executable type, used by loader. 02h = WINDOWS | | ||
+ | | 37h | BYTE | ne_flagsothers | Operating system flags | | ||
+ | | 38h | WORD | ??? | offset to return thunks or start of gangload area | | ||
+ | | 3Ah | WORD | ??? | offset to segment reference thunks or length of gangload area | | ||
+ | | 3Ch | WORD | ??? | minimum code swap area size | | ||
+ | | 3Eh | 2 BYTEs | ??? | expected Windows version (minor version first) | | ||
- | /* In-disk and In-memory module structure. See ' | + | On-disk segment entry |
- | struct new_exe { | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | WORD | + | | 00h | WORD | ns_sector | Logical-sector offset (n byte) to the contents |
- | union { | + | | 02h | WORD | ns_cbseg | Length |
- | struct { | + | | 04h | WORD | ns_flags | Flag word | |
- | BYTE | + | | 06h | WORD | ns_minalloc | Minimum allocation size of the segment, in bytes. Total size of the segment. Zero means 64K | |
- | BYTE | + | |
- | }; | + | |
- | WORD | + | |
- | }; | + | |
- | WORD ne_enttab; | + | |
- | | + | |
- | union { | + | |
- | WORD | + | |
- | WORD | + | |
- | }; | + | |
- | union { | + | |
- | DWORD | + | |
- | | + | |
- | struct { | + | |
- | WORD dgroup_entry; | + | |
- | WORD fileinfo; | + | |
- | }; | + | |
- | }; | + | |
- | | + | |
- | WORD | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | In-memory |
- | | + | |
- | | + | |
- | WORD ne_heap; | + | |
- | | + | |
- | | + | |
- | WORD ne_stack; | + | |
- | | + | |
- | | + | |
- | DWORD ne_csip; | + | |
- | DWORD | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | | + | | 00h | WORD | ns1_sector |
- | | + | | 02h | WORD | ns1_cbseg | Length |
- | | + | | 04h | WORD | ns1_flags | Flag word | |
- | | + | | 06h | WORD | ns1_minalloc | Minimum allocation size of the segment, in bytes. Total size of the segment. Zero means 64K | |
- | | + | | 08h | WORD | ns1_handle | Selector or handle |
- | | + | |
- | WORD ne_cseg; | + | |
- | WORD ne_cmod; | + | |
- | WORD ne_cbnrestab; | + | |
- | WORD ne_segtab; | + | |
- | | + | |
- | WORD ne_rsrctab; | + | |
- | | + | |
- | WORD | + | |
- | | + | |
- | WORD ne_modtab; | + | |
- | | + | |
- | WORD | + | |
- | | + | |
- | DWORD ne_nrestab; | + | |
- | | + | |
- | WORD ne_cmovent; | + | |
- | WORD ne_align; | + | |
- | | + | |
- | WORD ne_cres; | + | |
- | BYTE ne_exetyp; | + | |
- | | + | |
- | BYTE ne_flagsothers; | + | |
- | char ne_res[NERESBYTES]; | + | |
- | }; | + | |
- | // On-disk segment entry | ||
- | struct new_seg { | ||
- | WORD ns_sector; | ||
- | | ||
- | | ||
- | WORD ns_cbseg; | ||
- | WORD ns_flags; | ||
- | WORD ns_minalloc; | ||
- | | ||
- | }; | ||
- | |||
- | // In-memory segment entry | ||
- | struct new_seg1 { | ||
- | WORD ns1_sector; | ||
- | | ||
- | | ||
- | WORD ns1_cbseg; | ||
- | WORD ns1_flags; | ||
- | WORD ns1_minalloc; | ||
- | | ||
- | WORD ns1_handle; | ||
- | }; | ||
struct new_segdata { | struct new_segdata { | ||
Line 136: | Line 76: | ||
}; | }; | ||
- | struct new_rlcinfo { | + | Relocation table header |
- | WORD nr_nreloc; | + | |
- | }; | + | |
- | struct new_rlc { | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | | + | | 00h | WORD | nr_nreloc | Number of relocation table entries | |
- | char nr_flags; | + | |
- | | + | |
- | union { | + | |
- | struct { | + | |
- | char nr_segno; | + | |
- | char nr_res; | + | |
- | WORD nr_entry; | + | |
- | } nr_intref; | + | |
- | struct { | + | |
- | WORD nr_mod; | + | |
- | WORD nr_proc; | + | |
- | } nr_import; | + | |
- | struct { | + | |
- | WORD nr_ostype; | + | |
- | WORD nr_osres; | + | |
- | } nr_osfix; | + | |
- | } nr_union; | + | |
- | }; | + | |
- | #define NR_STYPE(x) | + | Relocation table entry |
- | #define NR_FLAGS(x) | + | |
- | #define NR_SOFF(x) | + | |
- | #define NR_SEGNO(x) | + | |
- | #define NR_RES(x) | + | |
- | #define NR_ENTRY(x) | + | |
- | #define NR_MOD(x) | + | |
- | #define NR_PROC(x) | + | |
- | #define NR_OSTYPE(x) | + | |
- | #define NR_OSRES(x) | + | |
- | # | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | #define NRSBYT | + | | 00h | char | nr_stype | Source type (0Fh = NRSTYP |
- | #define NRSSEG | + | | 01h | char | nr_flags | Flags byte (03h = TARGET_MASK): |
- | #define NRSPTR | + | | 02h | WORD | nr_soff | Offset within this segment of the source chain. If the ADDITIVE flag is set, then target value is added to the source contents, instead of replacing the source and following the chain. The source chain is an 0FFFFh terminated linked list within this segment of all references to the target | |
- | #define NRSOFF | + | | Internal fixup |||| |
- | #define NRPTR48 | + | | 04h | char | nr_segno | Segment number (for fixed segment) or 0FFh (for movable segment) | |
- | #define NROFF32 | + | | 05h | char | nr_res | Reserved (usually zero) | |
- | #define NRSOFF32 | + | | 06h | WORD | nr_entry | Entry table number (for movable segment) offset segment | |
+ | | Import |||| | ||
+ | | 04h | WORD | nr_mod | ??? | | ||
+ | | 06h | WORD | nr_proc | ??? | | ||
+ | | OS Fixup |||| | ||
+ | | 04h | WORD | nr_ostype | ??? | | ||
+ | | 06h | WORD | nr_osres | ??? | | ||
- | #define NRADD 0x04 | ||
- | #define NRRTYP | ||
- | #define NRRINT | ||
- | #define NRRORD | ||
- | #define NRRNAM | ||
- | #define NRROSF | ||
- | #define NRICHAIN | ||
- | #if (EXE386 == 0) | + | ^ Offset ^ Size ^ Name ^ Description ^ |
+ | | 00h | char | rs_len | ??? | | ||
+ | | 01h | char | rs_string[1] | ??? | | ||
- | #define RS_LEN(x) | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | #define RS_STRING(x) | + | | 00h | WORD | rt_id | ??? | |
- | #define RS_ALIGN(x) | + | | 02h | WORD | rt_nres | ??? | |
+ | | 04h | DWORD | rt_proc | ??? | | ||
- | #define RT_ID(x) | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | #define RT_NRES(x) | + | | 00h | WORD | rn_offset | ??? | |
- | #define RT_PROC(x) | + | | 02h | WORD | rn_length | ??? | |
+ | | 04h | WORD | rn_flags | ??? | | ||
+ | | 06h | WORD | rn_id | ??? | | ||
+ | | 08h | WORD | rn_handle | ??? | | ||
+ | | 0Ah | WORD | rn_usage | ??? | | ||
- | #define RN_OFFSET(x) | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | #define RN_LENGTH(x) | + | | 00h | WORD | rs_align |
- | #define RN_FLAGS(x) | + | | 02h | struct rsrc_typeinfo |
- | #define RN_ID(x) | + | |
- | #define RN_HANDLE(x) | + | |
- | #define RN_USAGE(x) | + | |
- | + | ||
- | #define RSORDID | + | |
- | + | ||
- | #define RNMOVE | + | |
- | #define RNPURE | + | |
- | #define RNPRELOAD | + | |
- | #define RNDISCARD | + | |
- | + | ||
- | #define NE_FFLAGS_LIBMODULE 0x8000 | + | |
- | + | ||
- | struct rsrc_string { | + | |
- | char rs_len; | + | |
- | char rs_string[1]; | + | |
- | }; | + | |
- | + | ||
- | struct rsrc_typeinfo { | + | |
- | | + | |
- | WORD rt_nres; | + | |
- | DWORD rt_proc; | + | |
- | }; | + | |
- | + | ||
- | struct rsrc_nameinfo { | + | |
- | WORD rn_offset; | + | |
- | WORD rn_length; | + | |
- | WORD rn_flags; | + | |
- | WORD rn_id; | + | |
- | WORD rn_handle; | + | |
- | WORD rn_usage; | + | |
- | }; | + | |
- | + | ||
- | struct new_rsrc { | + | |
- | WORD | + | |
- | struct rsrc_typeinfo | + | |
- | }; | + | |
- | + | ||
- | #endif | + | |
- | #pragma pack(pop) | ||
- | #ifdef __cplusplus | ||
- | } /* extern " | ||
- | #endif | ||
- | #endif | ||