Struct VirtioBlockDevice 

pub struct VirtioBlockDevice {
    device: VirtioDevice,
    queue: SpinLock<Virtqueue>,
    capacity: u64,
    block_size: u32,
    bounce_pool: BouncePool,
    meta_pool: MetaPool,
}

VirtIO Block Device driver

Fields

device: VirtioDevice

queue: SpinLock<Virtqueue>

capacity: u64

block_size: u32

bounce_pool: BouncePool

Pre-allocated DMA resources : no per-I/O alloc/free for common requests.

meta_pool: MetaPool

Implementations

impl VirtioBlockDevice

pub unsafe fn new(pci_dev: PciDevice) -> Result<Self, &'static str>

Initialize a VirtIO block device from a PCI device

Safety

The PCI device must be a valid VirtIO block device

fn acquire_dma_buffer( &self, buf_size: usize, is_write: bool, src: Option<&[u8]>, ) -> Result<(u64, u64, Option<(PhysFrame, u8)>), BlockError>

Determine the DMA buffer strategy: use the pre-allocated pool when the request fits; fall back to a per-I/O allocation for large transfers.

fn release_dma_buffer(&self, allocated: Option<(PhysFrame, u8)>)

fn do_request( &self, request_type: RequestType, sector: u64, data_buf: Option<(&mut [u8], bool)>, ) -> Result<(), BlockError>

Submit a block request and wait for completion

Trait Implementations

impl BlockDevice for VirtioBlockDevice

fn read_sector(&self, sector: u64, buf: &mut [u8]) -> Result<(), BlockError>

Reads sector.

fn write_sector(&self, sector: u64, buf: &[u8]) -> Result<(), BlockError>

Writes sector.

fn read_sectors( &self, sector: u64, count: u16, buf: &mut [u8], ) -> Result<(), BlockError>

Read multiple sectors in a single I/O.

VirtIO block uses a single descriptor whose length encodes the transfer size, so do_request naturally handles multi-sector transfers when given a large enough buffer.

fn write_sectors( &self, sector: u64, count: u16, buf: &[u8], ) -> Result<(), BlockError>

Write multiple sectors in a single I/O.

fn sector_count(&self) -> u64

Performs the sector count operation.

impl Send for VirtioBlockDevice

impl Sync for VirtioBlockDevice