Struct VirtioNetDevice 

pub struct VirtioNetDevice {
    base_addr: usize,
    virtqueues: Mutex<[VirtQueue<'static>; 2]>,
    config: RwLock<Option<NetworkInterfaceConfig>>,
    features: RwLock<u32>,
    stats: Mutex<NetworkStats>,
    initialized: Mutex<bool>,
    rx_buffers: Mutex<Vec<Box<[u8]>>>,
    interrupt_id: Mutex<Option<InterruptId>>,
    interface_name: Mutex<Option<String>>,
}

VirtIO Network Device

Fields

base_addr: usize

virtqueues: Mutex<[VirtQueue<'static>; 2]>

config: RwLock<Option<NetworkInterfaceConfig>>

features: RwLock<u32>

stats: Mutex<NetworkStats>

initialized: Mutex<bool>

rx_buffers: Mutex<Vec<Box<[u8]>>>

interrupt_id: Mutex<Option<InterruptId>>

interface_name: Mutex<Option<String>>

Implementations

impl VirtioNetDevice

pub fn new(base_addr: usize) -> Self

Create a new VirtIO Network device

Arguments

• base_addr - The base address of the device

Returns

A new instance of VirtioNetDevice

pub fn register_interface(self: &Arc<Self>, name: &str)

fn read_device_config(&mut self, negotiated_features: u32)

Read device configuration from the VirtIO config space

fn get_header_size(&self) -> usize

Get the appropriate header size based on device features

fn setup_rx_buffers(&self) -> Result<(), &'static str>

Setup receive buffers in the RX queue

fn transmit_packet(&self, packet: &DevicePacket) -> Result<(), &'static str>

Process a single packet transmission

fn process_received_packets(&self) -> Result<Vec<DevicePacket>, &'static str>

Process received packets from RX queue

fn check_link_status(&self) -> bool

Check link status from device configuration

pub fn enable_interrupts( &self, interrupt_id: InterruptId, ) -> Result<(), &'static str>

Enable interrupts for this device

pub fn set_interface_name(&self, name: &str)

Set interface name for interrupt dispatch

Trait Implementations

impl ControlOps for VirtioNetDevice

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 VirtioNetDevice

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_network_device(&self) -> Option<&dyn NetworkDevice>

Cast to NetworkDevice if this device is a network 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_block_device(&self) -> Option<&dyn BlockDevice>

Cast to BlockDevice if this device is a block device

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

Cast to GraphicsDevice if this device is a graphics 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 EthernetDevice for VirtioNetDevice

fn mac_address(&self) -> Result<MacAddress, &'static str>

Get the Ethernet MAC address for this device.

impl InterruptCapableDevice for VirtioNetDevice

fn handle_interrupt(&self) -> InterruptResult<()>

fn interrupt_id(&self) -> Option<InterruptId>

impl MemoryMappingOps for VirtioNetDevice

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 NetworkDevice for VirtioNetDevice

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

Get the network interface name

fn get_mac_address(&self) -> Result<MacAddress, &'static str>

Get the MAC address of the interface

fn get_mtu(&self) -> Result<usize, &'static str>

Get the MTU (Maximum Transmission Unit) of the interface

fn get_interface_config(&self) -> Result<NetworkInterfaceConfig, &'static str>

Get the full interface configuration

fn send_packet(&self, packet: DevicePacket) -> Result<(), &'static str>

Send a packet

fn receive_packets(&self) -> Result<Vec<DevicePacket>, &'static str>

Receive packets (non-blocking) Returns all currently available packets

fn set_promiscuous_mode(&self, _enabled: bool) -> Result<(), &'static str>

Set promiscuous mode (receive all packets on the network)

fn init_network(&mut self) -> Result<(), &'static str>

Initialize the network device

fn is_link_up(&self) -> bool

Check if the link is up

fn get_stats(&self) -> NetworkStats

Get network device statistics

impl Selectable for VirtioNetDevice

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.

impl VirtioDevice for VirtioNetDevice

fn get_base_addr(&self) -> usize

fn get_virtqueue_count(&self) -> usize

fn get_virtqueue_size(&self, queue_idx: usize) -> usize

fn get_supported_features(&self, device_features: u32) -> u32

Get device features supported by this driver

fn get_queue_desc_addr(&self, queue_idx: usize) -> Option<u64>

Get the descriptor address for a virtqueue

fn get_queue_driver_addr(&self, queue_idx: usize) -> Option<u64>

Get the driver area address for a virtqueue

fn get_queue_device_addr(&self, queue_idx: usize) -> Option<u64>

Get the device area address for a virtqueue

fn debug_dump_mmio_state(&self, tag: &'static str)

fn debug_log_status_transition( &self, tag: &'static str, old: u32, new: u32, readback: u32, )

fn wait_for_status_zero( &self, tag: &'static str, max_iters: usize, ) -> Result<(), &'static str>

fn init(&mut self) -> Result<u32, &'static str>

Initialize the device

fn is_modern_device(&self) -> bool

fn supports_feature(&self, feature: u32) -> bool

fn reset(&mut self) -> Result<(), &'static str>

Reset the device by writing 0 to the Status register

fn acknowledge(&mut self)

Set ACKNOWLEDGE status bit

fn driver(&mut self)

Set DRIVER status bit

fn driver_ok(&mut self)

Set DRIVER_OK status bit

fn set_failed(&mut self)

Set FAILED status bit

fn negotiate_features(&mut self) -> Result<u32, &'static str>

Negotiate device features

fn allow_ring_features(&self) -> bool

fn setup_queue(&mut self, queue_idx: usize, queue_size: usize) -> bool

Set up a virtqueue

fn read_config<T: Sized>(&self, offset: usize) -> T

Read device-specific configuration

fn write_config<T: Sized>(&self, offset: usize, value: T)

Write device-specific configuration

fn get_device_info(&self) -> (u32, u32)

Get device and vendor IDs

fn get_interrupt_status(&self) -> u32

Get interrupt status

fn process_interrupts(&mut self) -> u32

Process interrupts (polling method)

fn memory_barrier(&self)

Memory barrier for ensuring memory operations ordering

fn notify(&self, virtqueue_idx: usize)

Notify the device about new buffers in a specified virtqueue

fn read32_register(&self, register: Register) -> u32

Read a 32-bit value from a device register

fn write32_register(&self, register: Register, value: u32)

Write a 32-bit value to a device register

fn read64_register(&self, register: Register) -> u64

Read a 64-bit value from a device register

fn write64_register(&self, register: Register, value: u64)

Write a 64-bit value to a device register