blkid 1.0.1

Safe blkid-sys wrapper
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

use crate::{error::c_result, partition::Partition, BlkIdResult};
use blkid_sys::*;
use std::{ffi::CStr, str::FromStr};
use strum_macros::{Display, EnumString};

/// Information about a partition table
#[derive(Debug)]
pub struct PartTable(pub(crate) blkid_parttable);

impl PartTable {
    /// Returns partition table ID (for example GPT disk UUID).
    ///
    /// The ID is GPT disk UUID or DOS disk ID (in hex format).
    #[cfg(blkid = "2.23")]
    pub fn get_id(&self) -> Option<String> {
        let ptr = unsafe { blkid_parttable_get_id(self.0) };
        if ptr.is_null() {
            None
        } else {
            Some(unsafe { CStr::from_ptr(ptr).to_string_lossy().to_string() })
        }
    }

    /// Returns position (in bytes) of the partition table.
    ///
    /// # NOTE
    ///
    /// The position is relative to begin of the device as defined by `Prober::set_device` for
    /// primary partition table, and relative to parental partition for nested partition tables.
    pub fn get_offset(&self) -> BlkIdResult<i64> {
        unsafe { c_result(blkid_parttable_get_offset(self.0)) }
    }

    /// Returns parent for nested partition tables
    pub fn get_parent(&self) -> Option<Partition> {
        let part = unsafe { blkid_parttable_get_parent(self.0) };
        if part.is_null() {
            None
        } else {
            Some(Partition(part))
        }
    }

    /// Returns partition table type (type name, e.g. "dos", "gpt", ...)
    pub fn get_type(&self) -> Option<PartitionTableType> {
        let ptr = unsafe { blkid_parttable_get_type(self.0) };
        if ptr.is_null() {
            None
        } else {
            let pt_type = unsafe { CStr::from_ptr(ptr).to_string_lossy() };
            let part_table_type = PartitionTableType::from_str(pt_type.as_ref())
                .unwrap_or_else(|_| PartitionTableType::Unknown(pt_type.to_string()));
            Some(part_table_type)
        }
    }
}

#[derive(Clone, Debug, Eq, PartialEq, Display, EnumString)]
#[strum(serialize_all = "lowercase")]
pub enum PartitionTableType {
    Aix,
    Atari,
    Bsd,
    Dos,
    Gpt,
    Mac,
    Minix,
    Sgi,
    Solaris,
    Sun,
    Ultrix,
    Unixware,
    #[strum(default)]
    Unknown(String),
}