Struct gptman::GPTPartitionEntry

pub struct GPTPartitionEntry {
    pub partition_type_guid: [u8; 16],
    pub unique_partition_guid: [u8; 16],
    pub starting_lba: u64,
    pub ending_lba: u64,
    pub attribute_bits: u64,
    pub partition_name: PartitionName,
}

A GPT partition's entry in the partition array.

Examples

Basic usage:

let ss = 512;
let data = vec![0; 100 * ss as usize];
let mut cur = std::io::Cursor::new(data);
let mut gpt = gptman::GPT::new_from(&mut cur, ss as u64, [0xff; 16])
    .expect("could not create partition table");

// NOTE: partition entries starts at 1
gpt[1] = gptman::GPTPartitionEntry {
    partition_type_guid: [0xff; 16],
    unique_partition_guid: [0xff; 16],
    starting_lba: gpt.header.first_usable_lba,
    ending_lba: gpt.header.last_usable_lba,
    attribute_bits: 0,
    partition_name: "A Robot Named Fight!".into(),
};

assert_eq!(gpt[1].partition_name.as_str(), "A Robot Named Fight!");

Fields

partition_type_guid: [u8; 16]

16 bytes representing the UUID of the partition's type.

unique_partition_guid: [u8; 16]

16 bytes representing the UUID of the partition.

starting_lba: u64

The position (in sectors) of the first sector (used) of the partition.

ending_lba: u64

The position (in sectors) of the last sector (used) of the partition.

attribute_bits: u64

The attribute bits.

See Wikipedia's page for more information.

partition_name: PartitionName

The partition name.

Examples

Basic usage:

let name: gptman::PartitionName = "A Robot Named Fight!".into();

assert_eq!(name.as_str(), "A Robot Named Fight!");

Implementations

impl GPTPartitionEntry

pub fn empty() -> GPTPartitionEntry

Creates an empty partition entry

Examples

Basic usage:

let ss = 512;
let data = vec![0; 100 * ss as usize];
let mut cur = std::io::Cursor::new(data);
let mut gpt = gptman::GPT::new_from(&mut cur, ss as u64, [0xff; 16])
    .expect("could not create partition table");

gpt[1] = gptman::GPTPartitionEntry::empty();

// NOTE: an empty partition entry is considered as not allocated
assert!(gpt[1].is_unused());

pub fn read_from<R: ?Sized>(reader: &mut R) -> Result<GPTPartitionEntry> where
    R: Read, 

Read a partition entry from the reader at the current position.

pub fn is_unused(&self) -> bool

Returns true if the partition entry is not used (type GUID == [0; 16])

pub fn is_used(&self) -> bool

Returns true if the partition entry is used (type GUID != [0; 16])

pub fn size(&self) -> Result<u64>

Returns the number of sectors in the partition. A partition entry must always be 1 sector long at minimum.

Errors

This function will return an error if the ending_lba is lesser than the starting_lba.

Examples

Basic usage:

let ss = 512;
let data = vec![0; 100 * ss as usize];
let mut cur = std::io::Cursor::new(data);
let mut gpt = gptman::GPT::new_from(&mut cur, ss as u64, [0xff; 16])
    .expect("could not create partition table");

gpt[1] = gptman::GPTPartitionEntry {
    partition_type_guid: [0xff; 16],
    unique_partition_guid: [0xff; 16],
    starting_lba: gpt.header.first_usable_lba,
    ending_lba: gpt.header.last_usable_lba,
    attribute_bits: 0,
    partition_name: "A Robot Named Fight!".into(),
};

assert_eq!(
    gpt[1].size().ok(),
    Some(gpt.header.last_usable_lba + 1 - gpt.header.first_usable_lba)
);

Trait Implementations

impl Clone for GPTPartitionEntry

pub fn clone(&self) -> GPTPartitionEntry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GPTPartitionEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GPTPartitionEntry

pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Eq for GPTPartitionEntry

impl PartialEq<GPTPartitionEntry> for GPTPartitionEntry

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Serialize for GPTPartitionEntry

pub fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralEq for GPTPartitionEntry

impl StructuralPartialEq for GPTPartitionEntry