libfreemkv 0.25.14

Open source raw disc access library for optical drives
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

//! Platform-specific drive initialization and disc probing.

pub mod fs_type;
pub mod mt1959;

use crate::error::Result;
use crate::scsi::ScsiTransport;

pub(crate) trait PlatformDriver: Send {
    /// Unlock drive + upload firmware if needed.
    fn init(&mut self, scsi: &mut dyn ScsiTransport) -> Result<()>;

    /// Calibrate drive for this disc. Probes disc surface so the drive's
    /// firmware learns the optimal speed for each region. After probing
    /// the drive manages per-zone speeds internally — the host just reads
    /// at max speed.
    fn probe_disc(&mut self, scsi: &mut dyn ScsiTransport) -> Result<()>;

    /// True after successful init().
    fn is_ready(&self) -> bool;

    /// True if the drive is currently in raw-read mode (the per-drive
    /// runtime firmware has been uploaded AND the drive confirms
    /// active mode via the marker bytes in the unlock response). When
    /// true the host can read sectors without AACS bus encryption and
    /// retrieve VID without cert-based mutual auth — the cert/HRL gate
    /// on the drive's standard AACS path is effectively bypassed by
    /// the alternate data path.
    ///
    /// Default `false` — platforms that don't implement this mode are
    /// always reported as inactive.
    fn is_raw_read_active(&self) -> bool {
        false
    }
}