From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Tool:UPX" |
|---|
| claim | "The UPX pack header (PackHeader) is 32 bytes for little-endian PE, ELF and Mach-O targets (22 for DOS COM/SYS, 27 for DOS EXE; big-endian formats, format id >= 128, are also 32 bytes but with a different field order): magic "UPX!" at 0, version, format id, method and level at 4-7, then adler32 and sizes; the last byte is a checksum of the previous bytes." |
|---|
| scope | | level | "tool" |
|---|
| applies_to | "UPX 5.x packed files" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "UPX pack header (little-endian formats, format id < 128)" |
|---|
| size | 32 |
|---|
| fields | | offset | 0 |
|---|
| size | 4 |
|---|
| name | "magic" |
|---|
| type | "uint32" |
|---|
| note | "55 50 58 21 'UPX!' (UPX_MAGIC_LE32 0x21585055)" |
|---|
|
| offset | 4 |
|---|
| size | 1 |
|---|
| name | "version" |
|---|
| type | "uint8" |
|---|
|
| offset | 5 |
|---|
| size | 1 |
|---|
| name | "format" |
|---|
| type | "uint8" |
|---|
| note | "UPX_F_xxx executable type, e.g. 3 DOS EXE, 10 Linux i386, 22 Linux ELF64 AMD64, 34 Mach-O AMD64" |
|---|
|
| offset | 6 |
|---|
| size | 1 |
|---|
| name | "method" |
|---|
| type | "uint8" |
|---|
| note | "2-10 NRV2B/D/E variants, 14 LZMA" |
|---|
|
| offset | 7 |
|---|
| size | 1 |
|---|
| name | "level" |
|---|
| type | "uint8" |
|---|
| note | "compression level 1..10" |
|---|
|
| offset | 8 |
|---|
| size | 4 |
|---|
| name | "u_adler" |
|---|
| type | "uint32" |
|---|
| note | "adler32 of uncompressed data" |
|---|
|
| offset | 12 |
|---|
| size | 4 |
|---|
| name | "c_adler" |
|---|
| type | "uint32" |
|---|
| note | "adler32 of compressed data" |
|---|
|
| offset | 16 |
|---|
| size | 4 |
|---|
| name | "u_len" |
|---|
| type | "uint32" |
|---|
|
| offset | 20 |
|---|
| size | 4 |
|---|
| name | "c_len" |
|---|
| type | "uint32" |
|---|
|
| offset | 24 |
|---|
| size | 4 |
|---|
| name | "u_file_size" |
|---|
| type | "uint32" |
|---|
|
| offset | 28 |
|---|
| size | 1 |
|---|
| name | "filter" |
|---|
| type | "uint8" |
|---|
|
| offset | 29 |
|---|
| size | 1 |
|---|
| name | "filter_cto" |
|---|
| type | "uint8" |
|---|
|
| offset | 30 |
|---|
| size | 1 |
|---|
| name | "n_mru_minus_1" |
|---|
| type | "uint8" |
|---|
|
| offset | 31 |
|---|
| size | 1 |
|---|
| name | "header_checksum" |
|---|
| type | "uint8" |
|---|
|
|
|---|
| notes | "Variants from putPackHeader. Little-endian, format < 128: u_adler at 8, c_adler at 12, then for DOS COM/SYS (22 bytes) u_len u16 at 16, c_len u16 at 18, filter at 20; for DOS EXE (27 bytes) u_len, c_len, u_file_size as 24-bit values at 16, 19, 22 and filter at 25; otherwise (32 bytes) as the field list. Big-endian, format >= 128 (32 bytes): u_len u32 at 8, c_len at 12, u_adler at 16, c_adler at 20, u_file_size at 24, then filter 28, filter_cto 29, n_mru-1 30, checksum 31 (all big-endian). In every variant the checksum is the last byte (index size-1)." |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "putPackHeader writes the fields at these offsets; size 22/27/32 by format" |
|---|
| repo | "https://github.com/upx/upx" |
|---|
| commit | "c068381dfb00bfee2f754eaa313152ede043db82" |
|---|
| path | "src/packhead.cpp" |
|---|
| lines | "113-178" |
|---|
|
| type | "source" |
|---|
| detail | "stub template with UPX! magic and version/format/method/level bytes" |
|---|
| repo | "https://github.com/upx/upx" |
|---|
| commit | "c068381dfb00bfee2f754eaa313152ede043db82" |
|---|
| path | "src/stub/src/include/header.S" |
|---|
| lines | "30-45" |
|---|
|
| type | "source" |
|---|
| detail | "Read putPackHeader lines 113-170: sizes 22/27/32 and the per-variant offsets; the big-endian branch (format >= 128) stores lengths before the adlers." |
|---|
| repo | "https://github.com/upx/upx" |
|---|
| commit | "c068381dfb00bfee2f754eaa313152ede043db82" |
|---|
| path | "src/packhead.cpp" |
|---|
| lines | "113-170" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Pack header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T04:49:15.615Z" |
|---|
| verifications | |
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:37:59.938Z" |
|---|
| summary | "The 32-byte header has two layouts: the data record described only the little-endian one (format < 128). Big-endian formats (>= 128) use a different field order, and the 22- and 27-byte DOS variants…" |
|---|
| changed | | "claim" |
| "data" |
| "evidence" |
|
|---|
|
|
|---|