Struct Qcow2Dev

pub struct Qcow2Dev<T> {
    pub info: Qcow2Info,
    /* private fields */
}

Fields

info: Qcow2Info

Implementations

impl<T: Qcow2IoOps> Qcow2Dev<T>

pub fn new( path: &Path, header: Qcow2Header, params: &Qcow2DevParams, file: T, ) -> Qcow2Result<Self>

pub fn set_backing_dev(&mut self, back: Box<Qcow2Dev<T>>)

Setup the backing Qcow2 device

pub fn refblock_cache_is_empty(&self) -> bool

if the refblock cache for holding refcount block slice is empty

pub fn l2_cache_is_empty(&self) -> bool

if the l2 cache for holding l2 slice is empty

pub async fn shrink_caches(&self) -> Qcow2Result<()>

shrink both refblock and l2 caches, so the memory can be released, often called when qcow2 device is idle

pub async fn fsync_range(&self, off: u64, len: usize) -> Qcow2Result<()>

for flushing data in the qcow2 virtual range to disk

pub async fn flush_meta(&self) -> Qcow2Result<()>

flush meta data in ram to disk

pub async fn get_mapping(&self, virtual_offset: u64) -> Qcow2Result<Mapping>

pub async fn read_at(&self, buf: &mut [u8], offset: u64) -> Qcow2Result<usize>

Read data to buf from the virtual offset of this qcow2 image

pub async fn write_at(&self, buf: &[u8], offset: u64) -> Qcow2Result<()>

Write data in buf to the virtual offset of this qcow2 image

pub fn need_flush_meta(&self) -> bool

Helper for checking if there is dirty meta data which needs to be flushed to disk

pub async fn qcow2_cluster_usage<F>(&self, cls_usage: F) -> Qcow2Result<()>

where F: Fn(&str, &Vec<&RangeInclusive<u64>>, Option<(usize, usize)>),

Return Host Cluster usage, such as, allocated clusters, how many of them are compressed, …

pub async fn check(&self) -> Qcow2Result<()>

Check Qcow2 meta integrity and cluster leak

pub fn qcow2_prep_io<'life_self, 'async_recursion>( &'life_self self, ) -> Pin<Box<dyn Future<Output = Qcow2Result<()>> + 'async_recursion>>

where 'life_self: 'async_recursion,

Prepare everything(loading l1/refcount table) for handling any qcow2 IO

Trait Implementations

impl<T> Debug for Qcow2Dev<T>

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

Formats the value using the given formatter.