Struct PartitionDevice

pub struct PartitionDevice { /* private fields */ }

A device implementation that represents a partition within a larger storage device.

This type wraps a base device and provides access to only a specific region (partition) of that device. It maintains its own position cursor and ensures all operations stay within the partition boundaries. This allows file systems to operate on individual partitions without needing to know about the partition layout.

Thread Safety

The partition device is thread-safe and uses atomic operations for position management. Multiple threads can safely access the same partition device simultaneously.

Examples

// Create a memory device for testing
let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));

// Create a partition device for sectors 100-199 (50KB partition)
let partition = Partition_device_type::New_from_lba(base_device, 100, 100);
let partition_device = create_device!(partition);

// Now you can use partition_device like any other device
let data = b"Hello, Partition!";
partition_device.Write(data).unwrap();

Implementations

impl PartitionDevice

pub fn new(base_device: Device, offset: u64, size: u64) -> Self

Create a new partition device with explicit byte offset and size.

Arguments

• base_device - The underlying storage device
• offset - Byte offset from the beginning of the base device
• size - Size of the partition in bytes

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
// Create a partition starting at 64KB with 128KB size
let partition = Partition_device_type::new(base_device, 64 * 1024, 128 * 1024);

pub fn new_from_lba( base_device: Device, start_lba: u32, sector_count: u32, ) -> Self

Create a partition device from LBA (Logical Block Address) parameters.

This is a convenience method for creating partition devices using standard disk partitioning terminology. It assumes 512-byte sectors.

Arguments

• base_device - The underlying storage device
• start_lba - Starting logical block address (sector number)
• sector_count - Number of 512-byte sectors in this partition

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
// Create a partition starting at sector 2048 with 1024 sectors (512KB)
let partition = Partition_device_type::New_from_lba(base_device, 2048, 1024);

pub fn get_offset(&self) -> u64

Get the byte offset of this partition within the base device.

Returns

The absolute byte offset from the beginning of the base device.

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
let partition = Partition_device_type::New_from_lba(base_device, 100, 50);
assert_eq!(partition.get_offset(), 100 * 512);

pub fn get_partition_size(&self) -> u64

Get the size of this partition in bytes.

Returns

The total size of the partition in bytes.

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
let partition = Partition_device_type::New_from_lba(base_device, 100, 50);
assert_eq!(partition.get_partition_size(), 50 * 512);

pub fn get_start_lba(&self) -> u32

Get the starting LBA (Logical Block Address) of this partition.

Returns

The sector number where this partition starts (assuming 512-byte sectors).

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
let partition = Partition_device_type::New_from_lba(base_device, 100, 50);
assert_eq!(partition.get_start_lba(), 100);

pub fn get_sector_count(&self) -> u32

Get the size in sectors of this partition.

Returns

The number of 512-byte sectors this partition contains.

Examples

let base_device = create_device!(Memory_device_type::<512>::new(1024 * 1024));
let partition = Partition_device_type::New_from_lba(base_device, 100, 50);
assert_eq!(partition.get_sector_count(), 50);

pub fn get_position(&self) -> u64

Get the current position within the partition

pub fn get_base_device(&self) -> &Device

Get the base device

pub fn is_valid(&self) -> bool

Check if the partition device is valid (non-zero size)

pub fn get_remaining_bytes(&self) -> u64

Get remaining bytes that can be read/written from current position

pub fn is_at_end(&self) -> bool

Check if we’re at the end of the partition

Trait Implementations

impl Clone for PartitionDevice

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartitionDevice

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

Formats the value using the given formatter.

impl DeviceTrait for PartitionDevice

fn read(&self, buffer: &mut [u8]) -> Result<Size>

Read data from the device at the current position.

fn write(&self, buffer: &[u8]) -> Result<Size>

Write data to the device at the current position.

fn get_size(&self) -> Result<Size>

Get the total size of the device in bytes.

fn set_position(&self, position: &Position) -> Result<Size>

Set the current position cursor for read/write operations.

fn flush(&self) -> Result<()>

Flush any buffered data to the underlying storage.

fn is_a_block_device(&self) -> bool

Check if this device is a block device.

fn get_block_size(&self) -> Result<usize>

Get the block size of the device in bytes.

fn is_a_terminal(&self) -> bool

Check if this device represents a terminal/console device.

fn erase(&self) -> Result<()>

Erase the entire device.

fn dump_device(&self) -> Result<Vec<u8>>

Create a complete dump of the device contents.

impl Display for PartitionDevice

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

Formats the value using the given formatter.