Struct GenericBlockDevice 

pub struct GenericBlockDevice {
    disk_name: &'static str,
    disk_size: usize,
    request_fn: fn(&mut BlockIORequest) -> Result<(), &'static str>,
    request_queue: Mutex<Vec<Box<BlockIORequest>>>,
}

A generic implementation of a block device

Fields

disk_name: &'static str

disk_size: usize

request_fn: fn(&mut BlockIORequest) -> Result<(), &'static str>

request_queue: Mutex<Vec<Box<BlockIORequest>>>

Implementations

impl GenericBlockDevice

pub fn new( disk_name: &'static str, disk_size: usize, request_fn: fn(&mut BlockIORequest) -> Result<(), &'static str>, ) -> Self

Trait Implementations

impl BlockDevice for GenericBlockDevice

fn process_requests(&self) -> Vec<BlockIOResult>

Process all queued block I/O requests

This method processes all pending requests using a lock-efficient approach:

1. Acquires the request_queue lock once
2. Extracts all requests at once using mem::replace
3. Releases the lock immediately
4. Processes all requests without holding any locks

This approach minimizes lock contention and prevents deadlocks by:

• Never holding the lock during request processing
• Allowing other threads to enqueue requests while processing
• Avoiding any circular lock dependencies

Returns

Vector of BlockIOResult containing completed requests and their results

fn get_disk_name(&self) -> &'static str

Get the disk name

fn get_disk_size(&self) -> usize

Get the disk size in bytes

fn enqueue_request(&self, request: Box<BlockIORequest>)

Enqueue a block I/O request

impl ControlOps for GenericBlockDevice

fn control(&self, _command: u32, _arg: usize) -> Result<i32, &'static str>

Perform a control operation

fn supported_control_commands(&self) -> Vec<(u32, &'static str)>

Get a list of supported control commands

impl Device for GenericBlockDevice

fn device_type(&self) -> DeviceType

fn name(&self) -> &'static str

fn as_any(&self) -> &dyn Any

fn as_any_mut(&mut self) -> &mut dyn Any

fn as_block_device(&self) -> Option<&dyn BlockDevice>

Cast to BlockDevice if this device is a block device

fn capabilities(&self) -> &'static [DeviceCapability]

Optional capabilities exposed by this device (default: none)

fn as_event_capable(&self) -> Option<&dyn EventCapableDevice>

Cast to EventCapableDevice if this device can emit events

fn as_char_device(&self) -> Option<&dyn CharDevice>

Cast to CharDevice if this device is a character device

fn as_graphics_device(&self) -> Option<&dyn GraphicsDevice>

Cast to GraphicsDevice if this device is a graphics device

fn as_network_device(&self) -> Option<&dyn NetworkDevice>

Cast to NetworkDevice if this device is a network device

fn into_block_device(self: Arc<Self>) -> Option<Arc<dyn BlockDevice>>

Cast Arc to Arc if this device is a block device This allows direct ownership of the block device for efficient I/O operations

fn into_char_device(self: Arc<Self>) -> Option<Arc<dyn CharDevice>>

Cast Arc to Arc if this device is a character device This allows direct ownership of the char device for efficient I/O operations

fn into_graphics_device(self: Arc<Self>) -> Option<Arc<dyn GraphicsDevice>>

Cast Arc to Arc if this device is a graphics device This allows direct ownership of the graphics device for efficient operations

fn into_network_device(self: Arc<Self>) -> Option<Arc<dyn NetworkDevice>>

Cast Arc to Arc if this device is a network device This allows direct ownership of the network device for efficient operations

impl MemoryMappingOps for GenericBlockDevice

fn get_mapping_info( &self, _offset: usize, _length: usize, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information for a region of the object

fn on_mapped( &self, _vaddr: usize, _paddr: usize, _length: usize, _offset: usize, )

Notification that a mapping has been created

fn on_unmapped(&self, _vaddr: usize, _length: usize)

Notification that a mapping has been removed

fn supports_mmap(&self) -> bool

Check if memory mapping is supported

fn get_mapping_info_with( &self, offset: usize, length: usize, _is_shared: bool, ) -> Result<(usize, usize, bool), &'static str>

Get mapping information with sharing intent.

fn mmap_owner_name(&self) -> String

Diagnostic helper: return a short owner name for logging

fn resolve_fault( &self, access: &AccessKind, map: &VirtualMemoryMap, ) -> Result<ResolveFaultResult, ResolveFaultError>

impl Selectable for GenericBlockDevice

fn wait_until_ready( &self, _interest: ReadyInterest, _trapframe: &mut Trapframe, _timeout_ticks: Option<u64>, ) -> SelectWaitOutcome

Block the current task using the provided trapframe until the interest becomes ready or the optional timeout (in ticks) expires.

fn current_ready(&self, interest: ReadyInterest) -> ReadySet

Return current readiness for the given interest set.

fn set_nonblocking(&self, _enabled: bool)

Enable or disable non-blocking I/O semantics on this object.

fn is_nonblocking(&self) -> bool

Query whether non-blocking I/O semantics are enabled on this object.