Struct Device 

pub struct Device {

    pub name: String,
    pub serial: Option<String>,
    pub model: Option<String>,
    pub partlabel: Option<String>,
    pub parttype: Option<String>,
    pub partuuid: Option<String>,
    pub partn: Option<u32>,
    pub children: Option<Vec<Device>>,
    pub size: u64,
    pub maj_min: Option<String>,
    pub start: Option<u64>,
    pub label: Option<String>,
    pub fstype: Option<String>,
    pub uuid: Option<String>,
    pub path: Option<String>,
    pub pttype: Option<String>,
}

Fields

name: String

serial: Option<String>

model: Option<String>

partlabel: Option<String>

parttype: Option<String>

partuuid: Option<String>

partn: Option<u32>

Partition number (1-indexed). None for whole disk devices.

children: Option<Vec<Device>>

size: u64

maj_min: Option<String>

start: Option<u64>

label: Option<String>

fstype: Option<String>

uuid: Option<String>

path: Option<String>

pttype: Option<String>

Partition table type (e.g., “gpt”, “dos”). Only present on whole disk devices.

Implementations

impl Device

pub fn path(&self) -> String

pub fn node(&self) -> String

Alias for path() for compatibility

pub fn has_children(&self) -> bool

pub fn is_mpath(&self) -> Result<bool>

pub fn get_esp_partition_number(&self) -> Result<String>

Get the numeric partition index of the ESP (e.g. “1”, “2”).

We read /sys/class/block/<name>/partition rather than parsing device names because naming conventions vary across disk types (sd, nvme, dm, etc.). On multipath devices the sysfs partition attribute doesn’t exist, so we fall back to the partn field reported by lsblk.

pub fn find_partition_of_bios_boot(&self) -> Option<&Device>

Find BIOS boot partition among children.

pub fn find_colocated_esps(&self) -> Result<Option<Vec<Device>>>

Find all ESP partitions across all root devices backing this device. Calls find_all_roots() to discover physical disks, then searches each for an ESP. Returns None if no ESPs are found.

pub fn find_colocated_bios_boot(&self) -> Result<Option<Vec<Device>>>

Find all BIOS boot partitions across all root devices backing this device. Calls find_all_roots() to discover physical disks, then searches each for a BIOS boot partition. Returns None if no BIOS boot partitions are found.

pub fn find_partition_of_type(&self, parttype: &str) -> Option<&Device>

Find a child partition by partition type (case-insensitive).

pub fn find_partition_of_esp(&self) -> Result<&Device>

Find the EFI System Partition (ESP) among children.

For GPT disks, this matches by the ESP partition type GUID. For MBR (dos) disks, this matches by the MBR partition type IDs (0x06 or 0xEF).

pub fn find_device_by_partno(&self, partno: u32) -> Result<&Device>

Find a child partition by partition number (1-indexed).

pub fn refresh(&mut self) -> Result<()>

Re-query this device’s information from lsblk, updating all fields. This is useful after partitioning when the device’s children have changed.

pub fn backfill_missing(&mut self) -> Result<()>

Older versions of util-linux may be missing some properties. Backfill them if they’re missing.

pub fn list_parents(&self) -> Result<Option<Vec<Device>>>

Query parent devices via lsblk --inverse.

Returns Ok(None) if this device is already a root device (no parents). In the returned Vec<Device>, each device’s children field contains its own parents (grandparents, etc.), forming the full chain to the root device(s). A device can have multiple parents (e.g. RAID, LVM).

pub fn require_single_root(&self) -> Result<Device>

Walk the parent chain to find all root (whole disk) devices, and fail if more than one root is found.

This is a convenience wrapper around find_all_roots for callers that expect exactly one backing device (e.g. non-RAID setups).

pub fn find_all_roots(&self) -> Result<Vec<Device>>

Walk the parent chain to find all root (whole disk) devices.

Returns all root devices with their children (partitions) populated. This handles devices backed by multiple parents (e.g. RAID arrays) by following all branches of the parent tree. If this device is already a root device, returns a single-element list.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Device

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Device

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.