dmgwiz 1.1.0

Extract filesystem data from DMG files
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use std::fmt;

use super::ChunkType;

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

/// This type represents all possible errors that can occur when working with DMGs.
#[derive(Debug)]
pub enum Error {
    /// The was an IO error while reading or writing.
    Io(std::io::Error),
    /// There was an error parsing the DMG header or partition table. The file is most likely not a valid DMG.
    Parse(Box<dyn std::error::Error>),
    /// The DMG is encrypted. Use EncryptedDmgReader to read encrypted DMGs.
    Encrypted,
    /// The input is not a valid DMG file.
    InvalidInput(String),
    /// The partition number supplied is not valid.
    InvalidPartition(usize),
    /// There was an error while decompressing a data chunk.
    Decompress {
        partition_num: usize,
        chunk_num: usize,
        chunk_type: ChunkType,
    },
    /// The DMG uses an unsupported header version, encryption algorithm or key-derivation fucntion.
    UnsupportedEncryption(String),
    /// The DMG could not be decrypted using the given password.
    InvalidPassword,

    #[cfg(feature = "crypto")]
    /// There was an OpenSSL error during decryption.
    Decryption(openssl::error::ErrorStack),
}

impl std::error::Error for Error {
    fn cause(&self) -> Option<&dyn std::error::Error> {
        match *self {
            Error::Io(ref err) => Some(err),
            #[cfg(feature = "crypto")]
            Error::Decryption(ref err) => Some(err),
            _ => None,
        }
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            Error::Encrypted => write!(f, "DMG seems to encrypted"),
            Error::InvalidInput(ref str) => write!(f, "{}", str),
            Error::InvalidPartition(num_partition) => {
                write!(f, "partition {} does not exist", num_partition)
            }
            Error::UnsupportedEncryption(ref str) => {
                write!(f, "unsupported encryption parameters: {}", str)
            }
            Error::InvalidPassword => write!(f, "invalid password given"),
            Error::Decompress {
                partition_num,
                chunk_num,
                ref chunk_type,
            } => write!(
                f,
                "there was an error during decompression (partition={} chunk={} type={:?})",
                partition_num, chunk_num, chunk_type
            ),
            Error::Io(ref e) => e.fmt(f),
            Error::Parse(ref e) => write!(f, "parse error ({})", e),

            #[cfg(feature = "crypto")]
            Error::Decryption(_) => write!(f, "error during decryption"),
        }
    }
}

impl From<std::io::Error> for Error {
    fn from(err: std::io::Error) -> Error {
        Error::Io(err)
    }
}

impl From<Box<bincode::ErrorKind>> for Error {
    fn from(err: Box<bincode::ErrorKind>) -> Error {
        match *err {
            bincode::ErrorKind::Io(err) => Error::Io(err),
            err => Error::Parse(Box::new(err)),
        }
    }
}

impl From<plist::Error> for Error {
    fn from(err: plist::Error) -> Error {
        match err.into_io() {
            Ok(io_err) => Error::Io(io_err),
            Err(err) => Error::Parse(Box::new(err)),
        }
    }
}

#[cfg(feature = "crypto")]
impl From<openssl::error::ErrorStack> for Error {
    fn from(err: openssl::error::ErrorStack) -> Error {
        Error::Decryption(err)
    }
}