Struct SSTableValidator 

pub struct SSTableValidator {
    pub expected_magic: u64,
    pub verify_full_checksum: bool,
    pub expected_checksum: Option<[u8; 32]>,
}

SSTable validator for pre-mmap validation

Fields

expected_magic: u64

Expected magic number (default: MAGIC_NUMBER)

verify_full_checksum: bool

Whether to perform full file checksum (expensive, optional)

expected_checksum: Option<[u8; 32]>

Expected file checksum (if known from metadata)

Implementations

impl SSTableValidator

pub fn with_checksum_verification(expected_checksum: [u8; 32]) -> Self

Create validator with full checksum verification enabled

pub fn validate_before_mmap(&self, file: &mut File) -> Result<()>

Validate SSTable file before memory mapping

This performs comprehensive validation WITHOUT mmap to establish safety invariants:

1. File size >= minimum (header + footer)
2. Magic number matches expected value
3. Footer is readable and well-formed
4. Optional: Full file checksum (if verify_full_checksum = true)

Performance cost: ~5-10ms for basic validation, ~50-100ms for full checksum

Safety benefit: Prevents segfaults from corrupted/truncated files

pub fn validate_fast(&self, file: &mut File) -> Result<()>

Fast validation: only check magic number and file size

Performance: O(1) - reads only footer Use case: Production hot path where performance is critical

Trait Implementations

impl Default for SSTableValidator

fn default() -> Self

Returns the “default value” for a type.