liblitho 0.2.0

cli tool to flash/clone the images to storage devices
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
107
108
109
110
111
112
113

//! Fallback platform for unsupported targets.

mod privilege;

use crate::devices::{DeviceError, DeviceInfo, DeviceMount};
use crate::platform::traits::{
    DeviceInventory, DevicePathOps, DeviceReader, DeviceSafety, DeviceWriter, Platform, VolumeOps,
};
use anyhow::Result;
use std::io::{Read, Write};

pub struct UnsupportedPlatform;

impl DeviceInventory for UnsupportedPlatform {
    fn list_storage_devices() -> Result<Vec<DeviceInfo>> {
        Ok(Vec::new())
    }

    fn device_size_bytes(_: &str) -> Option<u64> {
        None
    }

    fn is_removable(_: &str) -> Result<bool> {
        anyhow::bail!("is_removable is not supported on this platform")
    }
}

impl DevicePathOps for UnsupportedPlatform {
    fn validate_whole_disk_path(_: &str) -> Result<(), DeviceError> {
        Err(DeviceError::unsupported(
            "Block device validation is not supported on this platform.",
        ))
    }

    fn paths_equivalent(a: &str, b: &str) -> bool {
        a == b
    }
}

impl DeviceSafety for UnsupportedPlatform {
    fn refuse_system_disk(_: &str) -> Result<(), DeviceError> {
        Ok(())
    }

    fn list_mounts(_: &str) -> Result<Vec<DeviceMount>, DeviceError> {
        Ok(Vec::new())
    }
}

impl VolumeOps for UnsupportedPlatform {
    type Guard = ();

    fn prepare_for_io(_: &str, _: bool) -> Result<Self::Guard, DeviceError> {
        Ok(())
    }

    fn unmount_volumes(_: &str) -> Result<Vec<String>, DeviceError> {
        Err(DeviceError::unsupported(
            "Automatic unmount is not supported on this platform",
        ))
    }
}

pub struct UnsupportedReader;
pub struct UnsupportedWriter;

impl DeviceReader for UnsupportedReader {
    fn open(_: &str) -> Result<Self> {
        anyhow::bail!("Unsupported platform")
    }
    fn device_size(&self) -> Result<u64> {
        anyhow::bail!("Unsupported platform")
    }
}

impl Read for UnsupportedReader {
    fn read(&mut self, _: &mut [u8]) -> std::io::Result<usize> {
        Err(std::io::Error::new(
            std::io::ErrorKind::Unsupported,
            "Unsupported platform",
        ))
    }
}

impl DeviceWriter for UnsupportedWriter {
    fn open(_: &str) -> Result<Self> {
        anyhow::bail!("Unsupported platform")
    }
    fn flush_and_sync(&mut self) -> Result<()> {
        anyhow::bail!("Unsupported platform")
    }
    fn device_size(&self) -> Result<u64> {
        anyhow::bail!("Unsupported platform")
    }
}

impl Write for UnsupportedWriter {
    fn write(&mut self, _: &[u8]) -> std::io::Result<usize> {
        Err(std::io::Error::new(
            std::io::ErrorKind::Unsupported,
            "Unsupported platform",
        ))
    }
    fn flush(&mut self) -> std::io::Result<()> {
        Ok(())
    }
}

impl Platform for UnsupportedPlatform {
    type Reader = UnsupportedReader;
    type BufferedReader = UnsupportedReader;
    type Writer = UnsupportedWriter;
}