luks2 0.5.0

Interact with LUKS2 partitions from Rust
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use thiserror::Error;

/// Enum for errors arising during parsing.
#[derive(Debug, Error)]
pub enum ParseError {
    #[error("Deserialization error: {0}")]
    BincodeError(#[from] Box<bincode::ErrorKind>),

    #[error("Invalid magic value in header: must be \"LUKS\\xba\\xbe\" or \"SKUL\\xba\\xbe\"")]
    InvalidHeaderMagic,

    #[error("Invalid header version: only version 2 is supported, found {0}")]
    InvalidHeaderVersion(u16),

    #[error("JSON deserialization error: {0}")]
    SerdeError(#[from] serde_json::Error),

    #[error(
        "Invalid stripes value in JSON: stripes value of the antiforensic splitter must be \
	4000"
    )]
    InvalidStripes,

    #[error("Invalid sector size in JSON: must be 512, 1024, 2048 or 4096")]
    InvalidSectorSize,

    #[error("Invalid keyslot size in JSON: must be aligned to 4096 bytes")]
    KeyslotNotAligned,

    #[error("Invalid reference in JSON: a nonexistent keyslot or segment was referenced")]
    InvalidReference,
}

/// Enum for errors arising during interaction with a [`LuksDevice`](crate::LuksDevice).
#[derive(Debug, Error)]
pub enum LuksError {
    #[error("IO error: {0}")]
    IoError(#[from] std::io::Error),

    #[error("Parsing error: {0}")]
    ParseError(#[from] self::ParseError),

    #[error("Invalid password")]
    InvalidPassword,

    #[error("Unsupported hash function used by anti-forensic splitter: {0}")]
    UnsupportedAfHash(String),

    #[error("Unsupported key size: {0}")]
    UnsupportedKeySize(u32),

    #[error("Could not deserialize base64: {0}")]
    Base64Error(#[from] base64::DecodeError),

    #[error("Could not apply hash function: {0}")]
    HashError(#[from] argon2::Error),

    #[error("Invalid key length: {0}. Valid lengths are 32 for AES-128-XTS or 64 for AES-256-XTS")]
    InvalidKeyLength(usize),

    #[error("Error during password input: {0}")]
    PasswordError(#[from] crossterm::ErrorKind),
}