From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Tool:Nuitka" |
|---|
| claim | "An appended Nuitka onefile payload starts with 'KA' plus 'X' (uncompressed) or 'Y' (zstd); it holds per-file records (NUL-terminated name in UTF-16LE on Windows or UTF-8, a flags byte on non-Windows, uint64 size, optional uint32 CRC-32) and the last 8 bytes of the executable are the uint64 payload size." |
|---|
| scope | | level | "tool" |
|---|
| applies_to | "Tool:Nuitka" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "NuitkaOnefilePayload" |
|---|
| size_min | 11 |
|---|
| fields | | name | "tag" |
|---|
| offset | 0 |
|---|
| type | "char[2] 'KA'" |
|---|
|
| name | "compression" |
|---|
| offset | 2 |
|---|
| type | "char 'X' or 'Y'" |
|---|
|
| name | "records" |
|---|
| type | "repeated: name NUL-terminated (UTF-16LE on Windows, UTF-8 otherwise); non-Windows only: flags u8 (1 executable, 2 symlink); a symlink record then has the NUL-terminated target and nothing else; otherwise u64 size, [u32 crc32 when checksums are on], [u32 compressed size when the archive is compressed], data" |
|---|
| notes | "the list ends with an empty name (one NUL in the file name encoding); on Windows archive mode pads with zero bytes to a multiple of 8" |
|---|
|
| name | "payload_size" |
|---|
| offset | "end-8" |
|---|
| type | "uint64 (native byte order of the packer, struct.pack 'Q')" |
|---|
| notes | "computed as end_pos - start_pos before the 8 bytes are written, although the source comment says it includes the size of the size field; not resolved" |
|---|
|
|
|---|
| endianness | "native" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "writes b'KA' + compression_indicator at the payload start, then per file records; OnefileBootstrap.c lines 186-274 read the size from the last 8 bytes before the payload end" |
|---|
| repo | "https://github.com/Nuitka/Nuitka" |
|---|
| commit | "999d9a7e11ad60eb14aea0e0b23932f92b2e73a3" |
|---|
| path | "nuitka/tools/onefile_compressor/OnefileCompressor.py" |
|---|
| lines | "60-100, 110-200, 318-345" |
|---|
|
| type | "source" |
|---|
| detail | "Read lines 105-190 (per-file record), 300-345 (KA header, utf-16le on isWin32Windows) and 395-410 (trailing Q). Symlink entries (non-Windows) are flags=2 then the NUL-terminated target instead of a size. Whether the trailing value counts its own 8 bytes was not resolved here (the C-side comment says it does)." |
|---|
| repo | "https://github.com/Nuitka/Nuitka" |
|---|
| commit | "999d9a7e11ad60eb14aea0e0b23932f92b2e73a3" |
|---|
| path | "nuitka/tools/onefile_compressor/OnefileCompressor.py" |
|---|
| lines | "105-190, 300-345, 395-410" |
|---|
|
| type | "source" |
|---|
| detail | "struct.pack("Q", input_size), struct.pack("I", crc/compressed_size), struct.pack("Q", end_pos - start_pos): no < or > prefix" |
|---|
| repo | "https://github.com/Nuitka/Nuitka" |
|---|
| commit | "999d9a7e11ad60eb14aea0e0b23932f92b2e73a3" |
|---|
| path | "nuitka/tools/onefile_compressor/OnefileCompressor.py" |
|---|
| lines | "159, 167, 183, 409" |
|---|
|
| type | "source" |
|---|
| detail | "_attachOnefilePayloadFile: flags 2 + link target for symlinks, flags 1 for X_OK, struct.pack('Q', input_size), crc 'I' with checksums, compressed size 'I' when archive and compressing; _attachOnefilePayload: terminator filename '\0', pad to 8 for Windows/archive, trailing struct.pack('Q', end_pos - start_pos) after end_pos = tell()." |
|---|
| repo | "https://github.com/Nuitka/Nuitka" |
|---|
| commit | "999d9a7e11ad60eb14aea0e0b23932f92b2e73a3" |
|---|
| path | "nuitka/tools/onefile_compressor/OnefileCompressor.py" |
|---|
| lines | "105-190, 300-410" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Onefile payload" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T08:09:14.593Z" |
|---|
| verifications | |
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-18T22:35:54.689Z" |
|---|
| summary | "Raise to high: re-read OnefileCompressor.py; b'KA' + indicator (b'Y' zstd, b'X' none), names NUL-terminated (utf-16le on Windows else utf8), flags byte on non-Windows (bit 1 executable, 2 symlink…" |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:51:34.210Z" |
|---|
| summary | "Byte order native: the compressor packs sizes with struct.pack("Q"/"I") without a byte-order prefix (producer's native order)" |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T17:32:58.776Z" |
|---|
| summary | "Variants missing from the record description: symlink entries (non-Windows, flags & 2: name NUL, flags byte, NUL-terminated target, no size or data), flags & 1 = executable, an empty name (single…" |
|---|
| changed | |
|---|
|
|
|---|