From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:GCZ" |
|---|
| claim | "After the 32-byte header come all num_blocks u64 block pointers, then all num_blocks u32 hashes (not interleaved as the header comment says); data starts at 32 + 12 * num_blocks. A pointer's top bit marks a raw block (it must be exactly block_size long); the other bits are an offset into the data area; a block's stored length is the next pointer minus its own (last: compressed_data_size minus its own). The hash is Adler-32 of the stored bytes and a mismatch is only logged. Initialize rejects the file on a wrong magic (0xB10BC001, stored as bytes 01 C0 0B B1; the struct comment's 0xB10BB10B is not what the code compares), tables or tables+compressed_data_size larger than the file, num_blocks 0, or if ValidateBlockPointers finds any block whose end or offset exceeds compressed_data_size, a raw block not exactly block_size, or a compressed block longer than block_size+64." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Dolphin's GCZ reader at this commit" |
|---|
| observed_in | |
|---|
|
|---|
| data | | trigger | "reading block n" |
|---|
| effect | "offset = (pointer[n] without bit 63) + header size + tables; hash checked over stored bytes; compressed blocks are zlib streams (inflateInit, not raw) that must decompress to exactly block_size" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "Initialize reads pointers then hashes and sets m_data_offset; GetBlockCompressedSize and GetBlock apply the flag, check the Adler-32 of the stored bytes (HashAdler32) and inflate with Z_FULL_FLUSH" |
|---|
| repo | "https://github.com/dolphin-emu/dolphin" |
|---|
| commit | "41460454e9600f909950fddf0abd13a138430162" |
|---|
| path | "Source/Core/DiscIO/CompressedBlob.cpp" |
|---|
| lines | "54-98,123-212" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "GCZ block pointers and hashes" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T11:40:56.429Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T16:44:26.385Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read CompressedBlob.cpp 33-250 at dolphin 41460454 (Initialize, GetBlockCompressedSize, GetBlock, ValidateBlockPointers): size checks, zero blocks, pointers then hashes, data offset = header + tables, raw flag bit 63, Adler-32 mismatch only logged, inflate must produce block_size, compressed block limit block_size+64. Matches. Magic constant value itself (CompressedBlob.h) not re-read this session." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:27:02.233Z" |
|---|
| summary | "Omission: the reader rejects the whole file in Initialize (CompressedBlobReader 40-98 and ValidateBlockPointers 213-250) on bad magic, header tables or data larger than the file, zero blocks, or any…" |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T13:10:41.720Z" |
|---|
| summary | "The reader's magic is GCZ_MAGIC = 0xB10BC001 (CompressedBlob.h line 25; Initialize and IsGCZBlob compare against it). 0xB10BB10B appears only in the struct member comment. Rest of the claim re-read…" |
|---|
| changed | |
|---|
|
|
|---|