Struct PciConfiguration 

pub struct PciConfiguration { /* private fields */ }

Contains the configuration space of a PCI node.

See the specification. The configuration space is accessed with DWORD reads and writes from the guest.

Implementations

impl PciConfiguration

pub fn new_type0( vendor_id: u16, device_id: u16, revision_id: u8, class_code: PciClassCode, subclass: &dyn PciSubclass, subsystem_vendor_id: u16, subsystem_id: u16, msix_config: Option<Arc<Mutex<MsixConfig>>>, ) -> Self

Create a new type 0 PCI configuration

pub fn type0_from_state( state: PciConfigurationState, msix_config: Option<Arc<Mutex<MsixConfig>>>, ) -> Self

Create a type 0 PCI configuration from snapshot state

pub fn state(&self) -> PciConfigurationState

Create PCI configuration space state

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

Reads a 32bit register from reg_idx in the register map.

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

Writes a 32bit register to reg_idx in the register map.

pub fn write_word(&mut self, offset: usize, value: u16)

Writes a 16bit word to offset. offset must be 16bit aligned.

pub fn write_byte(&mut self, offset: usize, value: u8)

Writes a byte to offset.

pub fn add_pci_bar(&mut self, bar_idx: usize, addr: u64, size: u64)

Add the [addr, addr + size) BAR region.

Configures the specified BAR to report this region and size to the guest kernel. Enforces a few constraints (i.e, region size must be power of two, register not already used).

pub fn get_bar_addr(&self, bar_idx: usize) -> u64

Returns the address of the given BAR region.

This assumes that bar_idx is a valid BAR register.

pub fn add_capability(&mut self, cap_data: &dyn PciCapability) -> usize

Adds the capability cap_data to the list of capabilities.

cap_data should not include the two-byte PCI capability header (type, next). Correct values will be generated automatically based on cap_data.id() and cap_data.len().

pub fn write_config_register( &mut self, reg_idx: usize, offset: u64, data: &[u8], )

Write a PCI configuration register

pub fn detect_bar_reprogramming( &mut self, reg_idx: usize, data: &[u8], ) -> Option<BarReprogrammingParams>

Detect whether the guest wants to reprogram the address of a BAR

Trait Implementations

impl Debug for PciConfiguration

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.