Struct qcow::Qcow2

pub struct Qcow2 {
    pub header: QcowHeader,
    pub snapshots: Vec<Snapshot>,
    pub l1_table: Vec<L1Entry>,
}

Parsed representation of a qcow2 file.

Can be aquired by using one of:

• open
• load
• load_from_memory

and then using DynamicQcow::unwrap_qcow2.

Example

let qcow = qcow::open(PATH).unwrap();

Fields

header: QcowHeader

Header of the qcow as parsed from the file, contains top-level data about the qcow

snapshots: Vec<Snapshot>

List of snapshots present within this qcow

l1_table: Vec<L1Entry>

Active table of L1Entrys used for handling lookups of contents

Implementations

impl Qcow2

pub fn cluster_size(&self) -> u64

Get the size of a cluster in bytes from the qcow

impl Qcow2

pub fn reader<'qcow, 'reader, R>(
    &'qcow self,
    reader: &'reader mut R
) -> Reader<'qcow, 'reader, R> where
    R: Read + Seek, 

Create a reader for reading from the guest virtual drive

Example

use std::io::Read;
use std::fs::File;

let qcow = qcow::open(PATH)?.unwrap_qcow2();
let mut file = File::open(PATH)?;
let mut reader = qcow.reader(&mut file);

// read first 10 bytes from virtual drive
let mut buf = [0u8; 10];
reader.read_exact(&mut buf)?;

Note: if reader is not identical to the source file unexpected things will happen.

Trait Implementations

impl BinRead for Qcow2

type Args = ()

The type of arguments needed to be supplied in order to read this type, usually a tuple.

fn read_options<R: Read + Seek>(
    __binread_generated_var_reader: &mut R,
    __binread_generated_var_options: &ReadOptions,
    __binread_generated_var_arguments: Self::Args
) -> BinResult<Self>

Read the type from the reader

fn read<R>(reader: &mut R) -> Result<Self, Error> where
    R: Read + Seek, 

Read the type from the reader while assuming no arguments have been passed

fn read_args<R>(reader: &mut R, args: Self::Args) -> Result<Self, Error> where
    R: Read + Seek, 

Read the type from the reader using the specified arguments

fn after_parse<R>(
    &mut self,
    &mut R,
    &ReadOptions,
    Self::Args
) -> Result<(), Error> where
    R: Read + Seek, 

fn args_default() -> Option<Self::Args>

The default arguments to be used when using the read shortcut method. Override this for any type that optionally requries arguments

impl Debug for Qcow2

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

Formats the value using the given formatter.