Struct VfioPciDevice

pub struct VfioPciDevice { /* private fields */ }

Provides control over a PCI device using VFIO.

Implementations

impl VfioPciDevice

pub fn open<P: AsRef<Path>>(sysfs_path: P) -> Result<VfioPciDevice>

Creates a new VfioContainer containing only the group that contains the given vfio-pci device, then calls VfioPciDevice::open_in_container with the same path and the created container.

Note that this only works if no other VfioContainer already contains the device’s group, and so you must use VfioPciDevice::open_in_container if you want to drive several devices from the same VFIO group.

pub fn open_in_container<P: AsRef<Path>>( sysfs_path: P, container: Arc<VfioContainer>, ) -> Result<VfioPciDevice>

Opens a vfio-pci device and adds it to the given container.

sysfs_path must correspond to the device’s sysfs directory, e.g., /sys/bus/pci/devices/0000:00:01.0. container must contain the group to which the device belongs.

Returns a VfioPciDevice corresponding to the opened device.

pub fn container(&self) -> &Arc<VfioContainer>

Returns a reference to the container to which the device’s group belongs.

Trait Implementations

impl Debug for VfioPciDevice

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

Formats the value using the given formatter.

impl PciDevice for VfioPciDevice

fn config(&self) -> PciConfig<'_>

Returns a thing that lets you access the PCI configuration space.

fn bar(&self, index: usize) -> Option<OwningPciRegion>

Returns a region that corresponds to the Base Address Register (BAR) with the given index, or None if there is no such BAR or it is unused by the device.

fn rom(&self) -> Option<OwningPciRegion>

Returns a region that is the PCI Expansion ROM, or None if the device doesn’t have one.

fn iommu(&self) -> PciIommu<'_>

Returns a thing that lets you manage IOMMU mappings for DMA.

fn interrupts(&self) -> PciInterrupts<'_>

Returns a thing that lets you manage interrupts.

fn reset(&self) -> Result<()>

Reset this function, and only it.