Struct GenericPcieRootComplex 

pub struct GenericPcieRootComplex { /* private fields */ }

A generic PCI Express root complex emulator.

Implementations

impl GenericPcieRootComplex

pub fn builder<'a>( register_mmio: &'a mut dyn RegisterMmioIntercept, bus_range: RangeInclusive<u8>, ecam_range: MemoryRange, ) -> GenericPcieRootComplexBuilder<'a>

Returns a builder for constructing a new GenericPcieRootComplex.

pub fn add_pcie_device( &mut self, port_devfn: u8, name: impl AsRef<str>, dev: Box<dyn GenericPciBusDevice>, ) -> Result<(), Arc<str>>

Attach the provided GenericPciBusDevice to the port identified by its devfn (device << 3 | function).

pub fn downstream_ports(&self) -> Vec<DownstreamPortInfo>

Enumerate the downstream ports of the root complex.

pub fn hotplug_add_device( &mut self, port_name: &str, device_name: &str, device: Box<dyn GenericPciBusDevice>, ) -> Result<()>

Hot-add a device to a named port.

pub fn hotplug_remove_device(&mut self, port_name: &str) -> Result<()>

Hot-remove the device from a named port.

pub fn add_rciep( &mut self, devfn: u8, name: impl Into<Arc<str>>, dev: Box<dyn GenericPciBusDevice>, ) -> Result<(), Arc<str>>

Attach a Root Complex Integrated Endpoint (RCiEP) at the given devfn (device << 3 | function) on the start bus of this root complex.

RCiEPs are Type 0 PCI functions that appear directly on the start bus alongside root ports (e.g., an AMD IOMMU at device 0). They do not sit behind a downstream port and have a fixed BDF.

Most RCiEPs should be registered at function 0. Config space accesses to other functions of the same device will be forwarded to the function 0 device via pci_cfg_read_with_routing, whose default implementation returns all-1s (no device present). A multi-function RCiEP should override pci_cfg_read_with_routing and pci_cfg_write_with_routing to handle non-zero functions.

Trait Implementations

impl ChangeDeviceState for GenericPcieRootComplex

fn start(&mut self)

Starts a device, allowing it to interact with the guest asynchronously.

async fn stop(&mut self)

Stops a device’s asynchronous work.

async fn reset(&mut self)

Resets the device state to its initial state, for a fresh boot.

impl ChipsetDevice for GenericPcieRootComplex

fn supports_mmio(&mut self) -> Option<&mut dyn MmioIntercept>

Optionally returns a trait object to send MMIO port intercepts to.

fn supports_pio(&mut self) -> Option<&mut (dyn PortIoIntercept + 'static)>

Optionally returns a trait object to send IO port intercepts to.

fn supports_pci(&mut self) -> Option<&mut (dyn PciConfigSpace + 'static)>

Optionally returns a trait object to send PCI config space accesses to.

fn supports_poll_device(&mut self) -> Option<&mut dyn PollDevice>

Optionally returns a trait object to send poll requests to.

fn supports_line_interrupt_target( &mut self, ) -> Option<&mut dyn LineInterruptTarget>

Optionally returns a trait object to send interrupt line changes to.

fn supports_handle_eoi(&mut self) -> Option<&mut dyn HandleEoi>

Optionally returns a trait object to send EOI requests to.

fn supports_acknowledge_pic_interrupt( &mut self, ) -> Option<&mut dyn AcknowledgePicInterrupt>

Optionally returns a trait object with which to acknowledge PIC interrupts.

fn supports_tdisp(&mut self) -> Option<&mut dyn TdispHostDeviceTarget>

Optionally returns a trait object which implements TDISP host communication.

impl InspectMut for GenericPcieRootComplex

fn inspect_mut(&mut self, req: Request<'_>)

Inspects the object.

impl MmioIntercept for GenericPcieRootComplex

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

Dispatch an MMIO read to the device with the given address.

fn mmio_write(&mut self, addr: u64, data: &[u8]) -> IoResult

Dispatch an MMIO write to the device with the given address.

fn get_static_regions(&mut self) -> &[(&str, RangeInclusive<u64>)]

Report a set of static static mmio regions (region_name, gpa_range) that cannot be remapped at runtime and are always registered.

impl SaveRestore for GenericPcieRootComplex

type SavedState = SavedState

The concrete saved state type.

fn save(&mut self) -> Result<Self::SavedState, SaveError>

Saves the object’s state.

fn restore(&mut self, state: Self::SavedState) -> Result<(), RestoreError>

Restores the object’s state.