pci-sim

pci-sim provides an out-of-tree build of the fake_pci_sriov Linux kernel module for DevStack and CI testing of SR-IOV PCI passthrough flows without physical SR-IOV hardware. It is included in the Cyborg repository under the top-level pci-sim/ directory and is built and loaded automatically by the Cyborg DevStack plugin.

• Overview
• pci-sim developer guide
  • How to read this guide
  • What pci-sim is and is not
  • Core mental model
  • Kernel concepts used by pci-sim
  • Why this approach works
  • Build and local test workflow
  • Source map
  • Lifecycle and data flows
  • Kernel references and design influences
  • Kernel maintenance conventions used here
  • Extension workflows
  • Troubleshooting
  • Limitations and future work
  • Related reading
• Build
  • Local build
• DevStack
  • Plugin settings
• Testing
  • Host loopback smoke test
  • QEMU/VFIO smoke test
  • DevStack Nova/Cyborg serial echo test
• Kernel dependencies
  • Required options
  • Runtime/test options
  • Compatibility targets
• Future migration work
  • Initial phases