Struct RecoveryScanner 

pub struct RecoveryScanner;

Scans damaged lockbox storage and reports or salvages recoverable content.

Recovery is intentionally separated from Lockbox because it operates on storage bytes and can succeed when a normal open fails.

Implementations

impl RecoveryScanner

pub fn scan_path(path: &Path, key: impl AsRef<[u8]>) -> RecoveryReport

Scan a lockbox file from disk and report recoverable entries.

pub fn scan_bytes(bytes: Vec<u8>, key: impl AsRef<[u8]>) -> RecoveryReport

Scan lockbox storage bytes and report recoverable entries.

pub fn salvage_bytes( bytes: Vec<u8>, key: impl AsRef<[u8]>, signing_key: &OwnerSigningKeyPair, ) -> Result<Lockbox, Error>

Salvage a damaged lockbox from storage bytes into a new opened lockbox.

Returns Error::InvalidKey if the supplied key cannot authenticate any recoverable records, or Error::CorruptRecord/storage errors if the recovered content cannot be written into the new lockbox.

pub fn salvage_bytes_with_secret_key( bytes: Vec<u8>, key: &SecureVec, signing_key: &OwnerSigningKeyPair, ) -> Result<Lockbox, Error>

Salvage a damaged lockbox using a content key held in secure memory.