From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:RocksDB database" |
|---|
| claim | "For block-based tables with footer format_version >= 6 the footer is 53 bytes at the end of the file: checksum type, extended magic 3E 00 7A 00, a footer checksum (with the file offset of the footer mixed in), the base context checksum, the metaindex block size (format_version >= 8: low 16 bits size, high 16 bits gap to the footer), 24 reserved zero bytes, format_version and the table magic. The index block handle is no longer in the footer for these versions. Footers of format_version 1-5 have checksum type, metaindex and index handles padded to 40 bytes, format_version and magic (also 53 bytes); version 0 (plain table legacy magic only) is 48 bytes." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:RocksDB database" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "SstFooterV6" |
|---|
| size | 53 |
|---|
| endianness | "little" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "checksum_type" |
|---|
|
| offset | "0x1" |
|---|
| size | 4 |
|---|
| type | "uint8_t[4]" |
|---|
| name | "extended_magic" |
|---|
| bits | "3E 00 7A 00" |
|---|
|
| offset | "0x5" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "footer_checksum" |
|---|
| bits | "checksum of the 53 bytes with this field zeroed, plus ChecksumModifierForContext(base_context_checksum, footer_offset)" |
|---|
|
| offset | "0x9" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "base_context_checksum" |
|---|
|
| offset | "0xD" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "metaindex_size" |
|---|
| bits | "format_version>=8: low 16 bits block size, high 16 bits gap" |
|---|
|
| offset | "0x11" |
|---|
| size | 24 |
|---|
| type | "uint8_t[24]" |
|---|
| name | "reserved" |
|---|
| bits | "first 16 unchecked, last 8 must be zero" |
|---|
|
| offset | "0x29" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "format_version" |
|---|
|
| offset | "0x2D" |
|---|
| size | 8 |
|---|
| type | "uint64_t" |
|---|
| name | "table_magic" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "FooterBuilder::Build and Footer::DecodeFrom; kNewVersionsEncodedLength = 1 + 2*20 + 4 + 8 (format.h 384-385, BlockHandle::kMaxEncodedLength = 2*kMaxVarint64Length = 20, kMaxVarint64Length = 10 in util/coding.h line 36); kLatestBbtFormatVersion = 8 (format.h 188)." |
|---|
| repo | "https://github.com/facebook/rocksdb" |
|---|
| commit | "54732b0c8f6f8af34f973d7fae0a234022fcf1fa" |
|---|
| path | "table/format.cc" |
|---|
| lines | "270-398, 400-540" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "RocksDB SST footer format_version 6 and up" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T11:32:07.083Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T12:01:02.666Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read table/format.cc FooterBuilder::Build (270-398) and Footer::DecodeFrom (400-540) plus format.h 376-386 at the cited commit: kNewVersionsEncodedLength = 1 + 2*20 + 4 + 8 = 53, kVersion0EncodedLength = 2*20+8 = 48; for format_version >= 6 part 2 = extended magic 3E 00 7A 00, u32 footer checksum (computed with that field zeroed, plus ChecksumModifierForContext(base_context_checksum, footer_offset)), u32 base context checksum, u32 metaindex size (format_version >= 8: low 16 bits size, high 16 gap), 24 zero bytes (16 unchecked, last 8 must be 0); then u32 format_version and u64 magic. For versions 1-5 part 2 is the two block handles padded to 40 bytes." |
|---|
|
|
|---|