Struct FileDisk

pub struct FileDisk { /* private fields */ }

Implementations

impl FileDisk

pub fn open(file: File, read_only: bool) -> Result<Self, Error>

pub fn with_metadata(file: File, metadata: Metadata) -> Self

Opens the disk using the specified metadata.

This ensures that no metadata queries are made to the file, which may be appropriate if this is wrapped in another disk implementation that retrieves metadata in another way.

pub fn into_inner(self) -> File

impl FileDisk

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

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

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

Trait Implementations

impl Debug for FileDisk

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

Formats the value using the given formatter.

impl DiskIo for FileDisk

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 is_read_only(&self) -> bool

Returns true if the disk is read only.

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.

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 sync_cache(&self) -> Result<(), DiskError>

Issues an asynchronous flush 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 FileDisk

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

Inspects the object.