vhdx-core 0.2.0

Pure-Rust VHDX (Hyper-V) virtual-disk container library — reader (writer planned), hardened for forensic use
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use thiserror::Error;

#[derive(Debug, Error)]
pub enum VhdxError {
    #[error("not a VHDX file (bad magic)")]
    BadMagic,
    #[error("no valid VHDX header found")]
    NoValidHeader,
    #[error("region table not found or invalid")]
    InvalidRegionTable,
    #[error("BAT region not found in region table")]
    BatRegionMissing,
    #[error("metadata region not found in region table")]
    MetadataRegionMissing,
    #[error("required metadata item missing: {0}")]
    MetadataMissing(&'static str),
    #[error("metadata value is outside valid range: {0}")]
    InvalidMetadata(&'static str),
    #[error("container is too small to be a valid VHDX (minimum {0} bytes required)")]
    ContainerTooSmall(u64),
    #[error("region or BAT file offset is outside the container bounds")]
    OffsetOutOfBounds,
    #[error("BAT entry file offset calculation overflows u64")]
    AddressOverflow,
    #[error("sector out of range (sector {sector}, virtual disk size {size})")]
    SectorOutOfRange { sector: u64, size: u64 },
    #[error("BAT entry not present for sector {0}")]
    BlockNotPresent(u64),
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),
    #[error("VHDX has a parent locator (differencing disk not supported)")]
    DifferencingNotSupported,
}

pub type Result<T> = std::result::Result<T, VhdxError>;