Enum fidl_fuchsia_hardware_block_volume::VolumeManagerRequest

pub enum VolumeManagerRequest {
    AllocatePartition {
        slice_count: u64,
        type_: Guid,
        instance: Guid,
        name: String,
        flags: u32,
        responder: VolumeManagerAllocatePartitionResponder,
    },
    GetInfo {
        responder: VolumeManagerGetInfoResponder,
    },
    Activate {
        old_guid: Guid,
        new_guid: Guid,
        responder: VolumeManagerActivateResponder,
    },
    GetPartitionLimit {
        guid: Guid,
        responder: VolumeManagerGetPartitionLimitResponder,
    },
    SetPartitionLimit {
        guid: Guid,
        slice_count: u64,
        responder: VolumeManagerSetPartitionLimitResponder,
    },
    SetPartitionName {
        guid: Guid,
        name: String,
        responder: VolumeManagerSetPartitionNameResponder,
    },
}

VolumeManager controls a collection of Volumes.

Variants

AllocatePartition

Fields

slice_count: u64

type_: Guid

instance: Guid

name: String

flags: u32

responder: VolumeManagerAllocatePartitionResponder

Allocates a virtual partition with the requested features.

slice_count is the number of slices initially allocated to the partition, at offset zero. The number of slices allocated to a new partition must be at least one. type and value indicate type and instance GUIDs for the partition, respectively. name indicates the name of the new partition.

GetInfo

Fields

responder: VolumeManagerGetInfoResponder

Gets the VolumeManagerInfo describing this instance of the VolumeManager.

Activate

Fields

old_guid: Guid

new_guid: Guid

responder: VolumeManagerActivateResponder

Atomically marks a vpartition (by instance GUID) as inactive, while finding another partition (by instance GUID) and marking it as active.

If the “old” partition does not exist, the GUID is ignored. If the “old” partition is the same as the “new” partition, the “old” GUID is ignored. If the “new” partition does not exist, ZX_ERR_NOT_FOUND is returned.

This function does not destroy the “old” partition, it just marks it as inactive – to reclaim that space, the “old” partition must be explicitly destroyed. This destruction can also occur automatically when the FVM driver is rebound (i.e., on reboot).

This function may be useful for A/B updates within the FVM, since it will allow activating updated partitions.

GetPartitionLimit

Fields

guid: Guid

responder: VolumeManagerGetPartitionLimitResponder

Retrieves the allocation limit for the partition. A return value of 0 indicates that there is no limit and the partition can be extended as long as there is available space on the device.

The partition may be larger than this limit if a smaller limit was applied after the partition had already grown to the current size.

Currently the partition limit is not persisted across reboots but this may change in the future.

SetPartitionLimit

Fields

guid: Guid

slice_count: u64

responder: VolumeManagerSetPartitionLimitResponder

Sets the allocation limit for the partition. Partitions can not be extended beyond their allocation limit. The partition limit will never shrink partitions so if this value is less than the current partition size, it will keep the current size but prevent further growth.

The allocation limits are on the VolumeManager API rather than on the partition because they represent a higher capability level. These limits are designed to put guards on users of the block device (and hence the Volume API).

Currently the partition limit is not persisted across reboots but this may change in the future.

SetPartitionName

Fields

guid: Guid

name: String

responder: VolumeManagerSetPartitionNameResponder

Renames the specified partition. Any existing devices that include the name of the partition in their topological path might not reflect the name change until the next time that the device is instantiated.

Implementations

impl VolumeManagerRequest

pub fn into_allocate_partition( self ) -> Option<(u64, Guid, Guid, String, u32, VolumeManagerAllocatePartitionResponder)>

pub fn into_get_info(self) -> Option<VolumeManagerGetInfoResponder>

pub fn into_activate( self ) -> Option<(Guid, Guid, VolumeManagerActivateResponder)>

pub fn into_get_partition_limit( self ) -> Option<(Guid, VolumeManagerGetPartitionLimitResponder)>

pub fn into_set_partition_limit( self ) -> Option<(Guid, u64, VolumeManagerSetPartitionLimitResponder)>

pub fn into_set_partition_name( self ) -> Option<(Guid, String, VolumeManagerSetPartitionNameResponder)>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for VolumeManagerRequest

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

Formats the value using the given formatter.