Struct Namespace

pub struct Namespace { /* private fields */ }

An NVMe namespace.

Implementations

impl Namespace

pub fn block_count(&self) -> u64

Gets the current block count.

pub async fn wait_resize(&self, block_count: u64) -> u64

Wait for the block count to be different from block_count.

pub fn block_size(&self) -> u32

Gets the block size in bytes.

pub async fn read( &self, target_cpu: u32, lba: u64, block_count: u32, guest_memory: &GuestMemory, mem: PagedRange<'_>, ) -> Result<(), RequestError>

Reads from the namespace.

pub async fn write( &self, target_cpu: u32, lba: u64, block_count: u32, fua: bool, guest_memory: &GuestMemory, mem: PagedRange<'_>, ) -> Result<(), RequestError>

Writes to the namespace.

pub async fn flush(&self, target_cpu: u32) -> Result<(), RequestError>

Flushes the namespace to persistent media.

pub fn max_transfer_block_count(&self) -> u32

Returns the maximum size for a read or write, in blocks.

pub fn supports_dataset_management(&self) -> bool

Returns whether the namespace support dataset management, needed to call Self::deallocate.

pub fn preferred_deallocate_granularity(&self) -> u16

The preferred granularity for unmap requests.

pub fn dataset_management_range_limit(&self) -> usize

Returns the maximum number of ranges to pass to Self::deallocate.

pub fn dataset_management_range_size_limit(&self) -> u32

Returns the maximum size of a single range to pass to Self::deallocate.

pub async fn deallocate( &self, target_cpu: u32, ranges: &[DsmRange], ) -> Result<(), RequestError>

Issues a dataset management command to deallocate the specified ranges.

The device may ignore ranges or LBA counts beyond a certain point. Use Self::dataset_management_range_limit and Self::dataset_management_range_size_limit to get the controller-reported bounds.

pub fn reservation_capabilities(&self) -> ReservationCapabilities

Gets the namespace’s reservation capabilities.

pub async fn reservation_report_extended( &self, target_cpu: u32, ) -> Result<(ReservationReportExtended, Vec<RegisteredControllerExtended>), RequestError>

Gets the namespace’s reservation report.

pub async fn reservation_acquire( &self, target_cpu: u32, action: ReservationAcquireAction, crkey: u64, prkey: u64, reservation_type: ReservationType, ) -> Result<(), RequestError>

Acquires a reservation.

pub async fn reservation_release( &self, target_cpu: u32, action: ReservationReleaseAction, crkey: u64, reservation_type: ReservationType, ) -> Result<(), RequestError>

Releases a reservation.

pub async fn reservation_register( &self, target_cpu: u32, action: ReservationRegisterAction, crkey: Option<u64>, nrkey: u64, ptpl: Option<bool>, ) -> Result<(), RequestError>

Modifies a reservation registration.

pub fn nsid(&self) -> u32

Return Namespace ID.

pub fn save(&self) -> Result<SavedNamespaceData>

Save namespace object data for servicing. Initially we will re-query namespace state after restore to avoid possible contention if namespace was changed during servicing. TODO: Re-enable namespace save/restore once we confirm that we can process namespace change AEN.

Trait Implementations

impl Debug for Namespace

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

Formats the value using the given formatter.

impl Inspect for Namespace

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

Inspects the object.