Struct devices::PciConfigIo

pub struct PciConfigIo {
    pci_root: Arc<Mutex<PciRoot>>,
    config_address: u32,
    break_linux_pci_config_io: bool,
    reset_evt_wrtube: SendTube,
}

Emulates PCI configuration access mechanism #1 (I/O ports 0xcf8 and 0xcfc).

Fields

pci_root: Arc<Mutex<PciRoot>>

PCI root bridge.

config_address: u32

Current address to read/write from (0xcf8 register, litte endian).

break_linux_pci_config_io: bool

Whether or not to actually function.

reset_evt_wrtube: SendTube

Tube to signal that the guest requested reset via writing to 0xcf9 register.

Implementations

impl PciConfigIo

const REGISTER_BITS_NUM: usize = 8usize

pub fn new( pci_root: Arc<Mutex<PciRoot>>, break_linux_pci_config_io: bool, reset_evt_wrtube: SendTube, ) -> Self

fn config_space_read(&self) -> u32

fn config_space_write(&mut self, offset: u64, data: &[u8])

fn set_config_address(&mut self, offset: u64, data: &[u8])

Trait Implementations

impl BusDevice for PciConfigIo

fn debug_label(&self) -> String

Returns a label suitable for debug output.

fn device_id(&self) -> DeviceId

Returns a unique id per device type suitable for metrics gathering.

fn read(&mut self, info: BusAccessInfo, data: &mut [u8])

Reads at offset from this device

fn write(&mut self, info: BusAccessInfo, data: &[u8])

Writes at offset into this device

fn config_register_write( &mut self, reg_idx: usize, offset: u64, data: &[u8], ) -> ConfigWriteResult

Sets a register in the configuration space. Only used by PCI.

fn config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the configuration space. Only used by PCI.

fn init_pci_config_mapping( &mut self, shmem: &SharedMemory, base: usize, len: usize, ) -> bool

Provides a memory region to back MMIO access to the configuration space. If the device can keep the memory region up to date, then it should return true, after which no more calls to config_register_read will be made. Otherwise the device should return false.

fn virtual_config_register_write(&mut self, reg_idx: usize, value: u32)

Sets a register in the virtual config space. Only used by PCI.

fn virtual_config_register_read(&self, reg_idx: usize) -> u32

Gets a register from the virtual config space. Only used by PCI.

fn on_sandboxed(&mut self)

Invoked when the device is sandboxed.

fn get_ranges(&self) -> Vec<(BusRange, BusType)>

Gets a list of all ranges registered by this BusDevice.

fn destroy_device(&mut self)

Invoked when the device is destroyed

fn is_bridge(&self) -> Option<u8>

Returns the secondary bus number if this bus device is pci bridge

impl Suspendable for PciConfigIo

fn sleep(&mut self) -> Result<()>

Stop all threads related to the device. Sleep should be idempotent.

fn wake(&mut self) -> Result<()>

Create/Resume all threads related to the device. Wake should be idempotent.

fn snapshot(&mut self) -> Result<AnySnapshot>

Save the device state in an image that can be restored.

fn restore(&mut self, data: AnySnapshot) -> Result<()>

Load a saved snapshot of an image.