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/09/26 12:59] (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 | ??? | |
- | 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) | + | |
- | #define NRSTYP | + | ^ Offset ^ Size ^ Name ^ Description ^ |
- | #define NRSBYT | + | | 00h | char | nr_stype | ??? | |
- | #define NRSSEG | + | | 01h | char | nr_flags | ??? | |
- | #define NRSPTR | + | | 02h | WORD | nr_soff | ??? | |
- | #define NRSOFF | + | | Internal fixup |||| |
- | #define NRPTR48 | + | | 04h | char | nr_segno | ??? | |
- | #define NROFF32 | + | | 05h | char | nr_res | ??? | |
- | #define NRSOFF32 | + | | 06h | WORD | nr_entry | ??? | |
+ | | ??? |||| | ||
+ | | 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 | ||