Struct GetVmgsDisk

pub struct GetVmgsDisk { /* private fields */ }

An implementation of [DiskIo] backed by the GET.

Implementations

impl GetVmgsDisk

pub async fn new( get: GuestEmulationTransportClient, ) -> Result<Self, NewGetVmgsDiskError>

Returns a new disk instance, communicating read and write IOs over the get transport.

pub fn restore_with_meta( get: GuestEmulationTransportClient, meta: SavedBlockStorageMetadata, ) -> Result<Self, NewGetVmgsDiskError>

Create a disk using metadata previously-fetched via Self::save_meta.

Caution

This method does not confirm that the provided meta is what would be provided by get. Callers MUST ensure that the provided meta matches the provided get instance.

Failing to do so may result in data corruption/loss, though, notably: it will not result in any memory-unsafety (hence why the function isn’t marked unsafe).

pub fn save_meta(&self) -> SavedBlockStorageMetadata

Save the metadata for this disk, for use in passing to Self::restore_with_meta

Trait Implementations

impl Clone for GetVmgsDisk

fn clone(&self) -> GetVmgsDisk

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GetVmgsDisk

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

Formats the value using the given formatter.

impl DiskIo for GetVmgsDisk

async fn sync_cache(&self) -> Result<(), DiskError>

Issues an asynchronous flush operation to the disk.

fn disk_type(&self) -> &str

Returns the disk type name as a string.

fn sector_count(&self) -> u64

Returns the current sector count.

fn sector_size(&self) -> u32

Returns the logical sector size of the backing store.

fn disk_id(&self) -> Option<[u8; 16]>

Optionally returns a 16-byte identifier for the disk, if there is a natural one for this backing store.

fn physical_sector_size(&self) -> u32

Returns the physical sector size of the backing store.

fn is_fua_respected(&self) -> bool

Returns true if the fua parameter to [DiskIo::write_vectored] is respected by the backing store by ensuring that the IO is immediately committed to disk.

fn is_read_only(&self) -> bool

Returns true if the disk is read only.

async fn read_vectored( &self, buffers: &RequestBuffers<'_>, sector: u64, ) -> Result<(), DiskError>

Issues an asynchronous read-scatter operation to the disk.

async fn write_vectored( &self, buffers: &RequestBuffers<'_>, sector: u64, _fua: bool, ) -> Result<(), DiskError>

Issues an asynchronous write-gather operation to the disk.

async fn unmap( &self, _sector: u64, _count: u64, _block_level_only: bool, ) -> Result<(), DiskError>

Unmap sectors from the layer.

fn unmap_behavior(&self) -> UnmapBehavior

Returns the behavior of the unmap operation.

fn optimal_unmap_sectors(&self) -> u32

Returns the optimal granularity for unmaps, in sectors.

fn pr(&self) -> Option<&dyn PersistentReservation>

Optionally returns a trait object to issue persistent reservation requests.

fn eject(&self) -> impl Future<Output = Result<(), DiskError>> + Send

Issues an asynchronous eject media operation to the disk.

fn wait_resize(&self, sector_count: u64) -> impl Future<Output = u64> + Send

Waits for the disk sector size to be different than the specified value.

impl Inspect for GetVmgsDisk

fn inspect(&self, req: Request<'_>)

Inspects the object.