Enum 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

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.

Fields

slice_count: u64

type_: Guid

instance: Guid

name: String

flags: u32

responder: VolumeManagerAllocatePartitionResponder

GetInfo

Gets the VolumeManagerInfo describing this instance of the VolumeManager.

NOTE: GetInfo() is used to synchronize child partition device visibility with devfs. Implementations must only respond once all child partitions of VolumeManager have been added to devfs, to guarantee clients can safely enumerate them.

See https://fxbug.dev/42077585 for more information.

Fields

responder: VolumeManagerGetInfoResponder

Activate

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.

Fields

old_guid: Guid

new_guid: Guid

responder: VolumeManagerActivateResponder

GetPartitionLimit

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.

Fields

guid: Guid

responder: VolumeManagerGetPartitionLimitResponder

SetPartitionLimit

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.

Fields

guid: Guid

slice_count: u64

responder: VolumeManagerSetPartitionLimitResponder

SetPartitionName

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.

Fields

guid: Guid

name: String

responder: VolumeManagerSetPartitionNameResponder

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.