Struct Checkpoint 

pub struct Checkpoint {
    pub header: CheckpointHeader,
    pub metadata: CheckpointMetadata,
    pub chunks: Vec<DataChunk>,
}

Complete checkpoint containing all kernel state.

Fields

header: CheckpointHeader

Checkpoint header.

metadata: CheckpointMetadata

Kernel metadata.

chunks: Vec<DataChunk>

Data chunks.

Implementations

impl Checkpoint

pub fn new(metadata: CheckpointMetadata) -> Checkpoint

Create a new checkpoint.

pub fn add_chunk(&mut self, chunk: DataChunk)

Add a data chunk.

pub fn add_control_block(&mut self, data: Vec<u8>)

Add control block data.

pub fn add_h2k_queue(&mut self, data: Vec<u8>)

Add H2K queue data.

pub fn add_k2h_queue(&mut self, data: Vec<u8>)

Add K2H queue data.

pub fn add_hlc_state(&mut self, data: Vec<u8>)

Add HLC state.

pub fn add_device_memory(&mut self, name: &str, data: Vec<u8>)

Add device memory region.

pub fn get_chunk(&self, chunk_type: ChunkType) -> Option<&DataChunk>

Get a chunk by type.

pub fn get_chunks(&self, chunk_type: ChunkType) -> Vec<&DataChunk>

Get all chunks of a type.

pub fn total_size(&self) -> usize

Calculate total size in bytes.

pub fn to_bytes(&self) -> Vec<u8>

Serialize checkpoint to bytes.

pub fn from_bytes(bytes: &[u8]) -> Result<Checkpoint, RingKernelError>

Deserialize checkpoint from bytes.

impl Checkpoint

pub fn content_digest(&self) -> String

Stable content digest of the checkpoint’s data chunks.

This is a CRC32 over each chunk’s (identity, data) in the order they were added. Two checkpoints with the same content digest have identical chunk contents at identical identities. Used as the stable “parent id” for delta checkpoints.

pub fn delta_from(base: &Checkpoint, new: &Checkpoint) -> Checkpoint

Produce a delta checkpoint: chunks present in new whose bytes differ from the corresponding chunk in base (same identity), plus chunks that are new in new. Unchanged chunks are omitted.

The delta’s metadata.custom records the base’s content digest under DELTA_PARENT_DIGEST_KEY so the reader can verify it before applying.

Restore via Checkpoint::applied_with_delta.

pub fn applied_with_delta( base: &Checkpoint, delta: &Checkpoint, ) -> Result<Checkpoint, RingKernelError>

Apply a delta produced by Checkpoint::delta_from on top of base, returning the resulting full checkpoint. Chunks in the delta replace chunks with the same identity in base; chunks only in base carry over unchanged.

Errors if the delta’s recorded parent digest does not match base.content_digest() — this catches accidental application on top of the wrong base.

Trait Implementations

impl Clone for Checkpoint

fn clone(&self) -> Checkpoint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Checkpoint

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

Formats the value using the given formatter.