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

//! Block-device open handles: platform-specific readers and writers.

use anyhow::Result;
use std::io::{Read, Write};

/// Trait for reading from a device in a platform-specific way.
pub trait DeviceReader: Read {
    /// Open a device for reading.
    fn open(device_path: &str) -> Result<Self>
    where
        Self: Sized;

    /// Size of the device in bytes.
    fn device_size(&self) -> Result<u64>;
}

/// Trait for writing to a device in a platform-specific way.
pub trait DeviceWriter: Write {
    /// Open a device for writing.
    fn open(device_path: &str) -> Result<Self>
    where
        Self: Sized;

    /// Flush and sync so data is durable on the device.
    fn flush_and_sync(&mut self) -> Result<()>;

    /// Whether the writer can durably sync ranges during the write loop.
    fn supports_incremental_sync(&self) -> bool {
        false
    }

    /// Durably sync a byte range already written to the device.
    fn sync_written_range(&mut self, offset: u64, len: u64) -> Result<()> {
        let _ = (offset, len);
        Ok(())
    }

    /// Flush and sync, reporting progress as ranges complete.
    fn flush_and_sync_with_progress(
        &mut self,
        sync_bytes: u64,
        mut on_progress: Option<&mut dyn FnMut(u64, u64)>,
    ) -> Result<()> {
        if let Some(callback) = on_progress.as_mut() {
            callback(0, sync_bytes);
        }
        self.flush_and_sync()?;
        if let Some(callback) = on_progress.as_mut() {
            callback(sync_bytes, sync_bytes);
        }
        Ok(())
    }

    /// Size of the device in bytes.
    fn device_size(&self) -> Result<u64>;

    /// Write bytes at an absolute byte offset on the device.
    fn write_at(&mut self, offset: u64, buf: &[u8]) -> Result<()> {
        let _ = (offset, buf);
        anyhow::bail!("write_at is not supported on this platform")
    }

    /// Whether post-write verification can read back through this open handle.
    fn supports_inline_verify(&self) -> bool {
        false
    }

    /// Rewind the device offset before inline verification.
    fn rewind_for_verify(&mut self) -> Result<()> {
        anyhow::bail!("rewind_for_verify is not supported on this platform")
    }

    /// Read bytes during inline verification.
    fn read_for_verify(&mut self, buf: &mut [u8]) -> std::io::Result<usize> {
        let _ = buf;
        Err(std::io::Error::new(
            std::io::ErrorKind::Unsupported,
            "read_for_verify is not supported on this platform",
        ))
    }
}