Struct IoManager

pub struct IoManager { /* private fields */ }

IO manager to handle all trapped MMIO/PIO access requests.

All devices handling trapped MMIO/PIO accesses should register themself to the IO manager with trapped address ranges. When guest vm accesses those trapped MMIO/PIO address ranges, VM IO Exit events will be triggered and the VMM dispatches those events to IO manager. And then the registered callbacks will invoked by IO manager.

Implementations

impl IoManager

pub fn new() -> Self

Create a new instance of IoManager.

pub fn register_device_io( &mut self, device: Arc<dyn DeviceIo>, resources: &[Resource], ) -> Result<()>

Register a new device to the IoManager, with trapped MMIO/PIO address ranges.

Arguments

• device: device object to handle trapped IO access requests
• resources: resources representing trapped MMIO/PIO address ranges. Only MMIO/PIO address ranges will be handled, and other types of resource will be ignored. So the caller does not need to filter out non-MMIO/PIO resources.

pub fn unregister_device_io(&mut self, resources: &[Resource]) -> Result<()>

Unregister a device from IoManager.

Arguments

• resources: resource list containing all trapped address ranges for the device.

pub fn mmio_read(&self, addr: u64, data: &mut [u8]) -> Result<()>

Handle VM IO Exit events triggered by trapped MMIO read accesses.

Return error if failed to get the device.

pub fn mmio_write(&self, addr: u64, data: &[u8]) -> Result<()>

Handle VM IO Exit events triggered by trapped MMIO write accesses.

Return error if failed to get the device.

impl IoManager

pub fn pio_read(&self, addr: u16, data: &mut [u8]) -> Result<()>

Handle VM IO Exit events triggered by trapped PIO read accesses.

Return error if failed to get the device.

pub fn pio_write(&self, addr: u16, data: &[u8]) -> Result<()>

Handle VM IO Exit events triggered by trapped PIO write accesses.

Return error if failed to get the device.

Trait Implementations

impl Clone for IoManager

fn clone(&self) -> IoManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for IoManager

fn default() -> IoManager

Returns the “default value” for a type.

impl PartialEq for IoManager

fn eq(&self, other: &IoManager) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.