Module virtio_block 

VirtIO Block Device driver

Provides disk I/O via VirtIO-blk protocol for QEMU/KVM environments. Implements the BlockDevice trait for integration with filesystem layers.

Reference: VirtIO spec v1.2, Section 5.2 (Block Device)

Modules

features

VirtIO block device features

Structs

BlockConfig 🔒

Block device configuration space

BlockRequestHeader

VirtIO block request header

BouncePool 🔒

Pre-allocated DMA buffer used for all data transfers.

MetaPool 🔒

Pre-allocated metadata frame: [Header (16 B)] + padding + [Status (1 B)]. Reused for every request : never alloc/freed per I/O.

VirtioBlockDevice

VirtIO Block Device driver

Enums

BlockError

BlockStatus

VirtIO block request status

RequestType

VirtIO block request types

Constants

BOUNCE_POOL_SIZE 🔒

Size of the pre-allocated bounce buffer pool (64 KB = 128 sectors). Requests up to this size avoid per-I/O buddy allocator calls.

SECTOR_SIZE

Block device sector size

Statics

VIRTIO_BLK_DONE 🔒

Atomic flag set by the IRQ handler to signal request completion.

VIRTIO_BLK_ERROR 🔒

Atomic flag set by the IRQ handler on error.

VIRTIO_BLK_WQ 🔒

WaitQueue used for IRQ-driven completion (see handle_interrupt / do_request).

VIRTIO_BLOCK_IRQ 🔒

VirtIO block IRQ line (will be set during init)

VIRTIO_BLOCK_PTR 🔒

Global VirtIO block device reference (leaked Box, never freed).

Traits

BlockDevice

Block device trait (implemented by VirtIO-blk and AHCI drivers)

Functions

get_device

Get the global VirtIO block device

get_irq

Get the VirtIO block IRQ line

handle_interrupt

Handle VirtIO block device interrupt

init

Initialize VirtIO block device