Struct TransferStore 

pub struct TransferStore { /* private fields */ }

One exclusive process-local store owner. The file lock is held until drop. Existing ancestors must be deployment-protected; Windows additionally requires a deployment-owned private ACL. Reparse points are rejected on all Windows paths.

Implementations

impl TransferStore

pub fn open( root: impl Into<PathBuf>, limits: TransferLimits, ) -> TransferResult<Self>

Opens an existing owner-protected root, holds a nonblocking cross-process lock, and scans quota before admitting new work. Never creates arbitrary ancestors.

pub fn begin( &mut self, descriptor: ObjectDescriptor, ) -> TransferResult<TransferSession<'_>>

Starts/reopens only this exact authenticated-by-caller descriptor. Recovered block hashes are revalidated. Corrupt metadata or blocks fail closed and stay available for diagnostics; purge the partial explicitly before redownloading.

pub fn prune_expired(&mut self, ttl: Duration) -> TransferResult<usize>

Explicit TTL cleanup of incomplete objects only, under the root lock. Unknown/corrupt metadata fails closed. Complete objects are never removed.

pub fn purge_partial( &mut self, descriptor: &ObjectDescriptor, ) -> TransferResult<()>

Explicitly removes only a known incomplete object’s private inventory. A complete object, unknown file or invalid metadata prevents deletion.

Trait Implementations

impl Debug for TransferStore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.