Struct CdevDevice 

pub struct CdevDevice { /* private fields */ }

A VFIO device opened via the cdev interface (/dev/vfio/devices/vfioN).

This is the modern per-device access path. After opening, the device must be bound to an iommufd fd via bind_iommufd and then attached to an IOAS or HWPT via attach_ioas before any DMA can occur.

Once bound and attached, call into_device to get the standard Device for config space, BAR, IRQ, and mmap operations.

Implementations

impl CdevDevice

pub fn from_file(file: File) -> Self

Wrap a pre-opened VFIO cdev file descriptor.

pub fn bind_iommufd(&self, iommufd_fd: RawFd) -> Result<u32>

Bind this device to an iommufd instance.

Returns the kernel-assigned device ID within the iommufd context. This must be called before any DMA operations.

pub fn attach_ioas(&self, pt_id: u32) -> Result<u32>

Attach the device to an IOAS or HWPT by its iommufd object ID.

Pass an IOAS ID for identity DMA translation, or a HWPT ID for nested translation.

Returns the attached page table ID (may differ from input if the kernel auto-created a HWPT for the IOAS).

pub fn detach_ioas(&self) -> Result<()>

Detach the device from its current IOAS/HWPT.

After detaching, the device is in a blocking DMA state.

pub fn into_device(self) -> Device

Convert to a standard Device for config space, BAR, IRQ, and mmap operations.

The cdev fd supports the same VFIO_DEVICE_* ioctls as the legacy group path, so the Device type works unchanged.

Trait Implementations

impl AsFd for CdevDevice

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl AsRef<File> for CdevDevice

fn as_ref(&self) -> &File

Converts this type into a shared reference of the (usually inferred) input type.