From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:Zstandard" |
|---|
| claim | "The byte after the frame magic, Frame_Header_Descriptor, says which optional header fields follow: bits 0-1 Dictionary_ID_flag (field of 0/1/2/4 bytes), bit 2 Content_Checksum_flag, bit 3 reserved (must be 0), bit 4 unused, bit 5 Single_Segment_flag (no Window_Descriptor; window = content size), bits 6-7 Frame_Content_Size_flag (field of 0 or 1 if single segment / 2 / 4 / 8 bytes; the 2-byte form stores size - 256). The whole frame header is 2-14 bytes." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:Zstandard" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "Frame_Header_Descriptor" |
|---|
| size | 1 |
|---|
| fields | | offset | 0 |
|---|
| size | 1 |
|---|
| type | "uint8" |
|---|
| name | "Frame_Header_Descriptor" |
|---|
| bits | | bit | "0-1" |
|---|
| name | "Dictionary_ID_flag" |
|---|
| notes | "Dictionary_ID field size 0, 1, 2 or 4 bytes" |
|---|
|
| bit | "2" |
|---|
| name | "Content_Checksum_flag" |
|---|
| notes | "4-byte XXH64 low half after the last block" |
|---|
|
| bit | "3" |
|---|
| name | "Reserved_bit" |
|---|
| notes | "must be 0" |
|---|
|
|
| bit | "5" |
|---|
| name | "Single_Segment_flag" |
|---|
| notes | "no Window_Descriptor; Window_Size = Frame_Content_Size" |
|---|
|
| bit | "6-7" |
|---|
| name | "Frame_Content_Size_flag" |
|---|
| notes | "FCS field size: 0 (1 if Single_Segment), 2 (value + 256), 4, 8 bytes" |
|---|
|
|
|---|
|
|
|---|
| test_vectors | | input | "FHD 0x20" |
|---|
| expected | "single segment, 1-byte content size, no checksum, no dictionary id: header = 2 bytes" |
|---|
|
| input | "FHD 0x64 then 2-byte FCS 00 00" |
|---|
| expected | "FCS flag 1 (2 bytes, size = 0 + 256 = 256), single segment, checksum" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "documentation" |
|---|
| detail | "Frame_Header_Descriptor bit table and FCS/DID field size tables" |
|---|
| repo | "https://github.com/facebook/zstd" |
|---|
| commit | "49cf51799ea051457f57243527aa2058f999f005" |
|---|
| path | "doc/zstd_compression_format.md" |
|---|
| lines | "141-233, 299-317" |
|---|
|
| type | "runtime_test" |
|---|
| detail | "parse_frame_header of Code:Zstandard/Zstandard decoder (Python) implements this table and decodes all reference test frames." |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Frame_Header_Descriptor" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-17T17:12:19.133Z" |
|---|
| verifications | |
|---|