Struct DriveInfo 

pub struct DriveInfo {
    pub name: String,
    pub mount_point: String,
    pub size_gb: f64,
    pub device_path: String,
    pub is_system: bool,
    pub is_read_only: bool,
    pub disabled: bool,
    pub usb_info: Option<UsbInfo>,
}

Information about a storage drive visible to the system.

Fields

name: String

Human-readable display name (model, vendor, or device node).

mount_point: String

Mount point of the drive or one of its partitions. Falls back to the device path when not mounted.

size_gb: f64

Drive capacity in gigabytes.

device_path: String

Kernel block device path, e.g. /dev/sdb.

is_system: bool

true when the drive (or one of its partitions) is mounted at a critical system location (/, /boot, /usr, …).

is_read_only: bool

true when the kernel reports the device as read-only (/sys/block/X/ro == 1).

disabled: bool

true when a constraint check determined this drive must not be selected (too small, read-only, source drive, …).

usb_info: Option<UsbInfo>

USB descriptor metadata — Some for USB drives, None for internal SATA / NVMe / eMMC devices.

Implementations

impl DriveInfo

pub fn new( name: String, mount_point: String, size_gb: f64, device_path: String, ) -> DriveInfo

Create a DriveInfo with the four essential fields.

is_system, is_read_only, disabled, and usb_info all default to false / None.

pub fn with_constraints( name: String, mount_point: String, size_gb: f64, device_path: String, is_system: bool, is_read_only: bool, ) -> DriveInfo

Create a DriveInfo with constraint flags set explicitly.

disabled defaults to false; usb_info defaults to None.

pub fn with_usb_info(self, info: UsbInfo) -> DriveInfo

Attach USB descriptor metadata to this drive and return self.

Intended for use in a builder chain:

let drive = DriveInfo::new(
    "SanDisk Ultra".into(), "/dev/sdb".into(), 32.0, "/dev/sdb".into(),
)
.with_usb_info(UsbInfo {
    vendor_id: 0x0781,
    product_id: 0x5581,
    manufacturer: Some("SanDisk".into()),
    product: Some("Ultra".into()),
    serial: Some("AA01234567890".into()),
    speed: Some("SuperSpeed (5 Gbps)".into()),
});
assert!(drive.usb_info.is_some());

pub fn is_usb(&self) -> bool

Return true if this is a USB-attached drive (has USB descriptor info).

Trait Implementations

impl Clone for DriveInfo

fn clone(&self) -> DriveInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DriveInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for DriveInfo

fn eq(&self, other: &DriveInfo) -> bool

Two drives are equal when they refer to the same kernel block device.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.