Struct ChunkBuf 

pub struct ChunkBuf(/* private fields */);

A page-aligned chunk buffer for streaming file data into guest memory.

The buffer is guaranteed to hold at least one page (HV_PAGE_SIZE) and its length is always a whole number of pages. Reuse the same ChunkBuf across multiple imports to avoid repeated allocations.

Implementations

impl ChunkBuf

pub fn new() -> Self

Create a new chunk buffer with the default size.

pub fn with_size(size: usize) -> Self

Create a new chunk buffer with the given byte size, rounded down to a whole number of pages.

Panics if size is less than HV_PAGE_SIZE.

pub fn import_file_region<F, R: GuestArch>( &mut self, importer: &mut dyn ImageLoad<R>, params: ImportFileRegion<'_, F>, ) -> Result<(), ImportFileRegionError>

where F: ReadSeek + ?Sized,

Import a region from a file into guest memory.

Reads file_length bytes from file at file_offset, importing them at guest physical address gpa. If gpa is not page-aligned, the leading bytes of that page are zeroed. If memory_length exceeds file_length, the remaining bytes are zeroed. Zeroing extends to the end of the last target page.

pub fn crc32(&mut self, file: &mut dyn ReadSeek, len: u64) -> Result<u32, Error>

Read a file in chunks and compute its CRC32, rewinding it afterward.