Struct NvmeFaultController 

pub struct NvmeFaultController { /* private fields */ }

An NVMe controller.

Implementations

impl NvmeFaultController

pub fn new( driver_source: &VmTaskDriverSource, guest_memory: GuestMemory, msi_target: &MsiTarget, register_mmio: &mut dyn RegisterMmioIntercept, caps: NvmeFaultControllerCaps, fault_configuration: FaultConfiguration, tdisp_interface: Option<Box<dyn TdispHostDeviceTarget>>, ) -> Self

Creates a new NVMe controller.

pub fn client(&self) -> NvmeFaultControllerClient

Returns a client for manipulating the NVMe controller at runtime.

pub fn read_bar0(&mut self, addr: u16, data: &mut [u8]) -> IoResult

Reads from the virtual BAR 0.

pub fn write_bar0(&mut self, addr: u16, data: &[u8]) -> IoResult

Writes to the virtual BAR 0.

pub fn fatal_error(&mut self)

Sets the CFS bit in the controller status register (CSTS), indicating that the controller has experienced “undefined” behavior.

Trait Implementations

impl ChangeDeviceState for NvmeFaultController

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 NvmeFaultController

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

The NVMe fault controller is repurposed for use in TDISP tests.

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

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

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

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

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

Optionally returns a trait object to send IO port intercepts 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.

impl InspectMut for NvmeFaultController

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

Inspects the object.

impl MmioIntercept for NvmeFaultController

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 PciConfigSpace for NvmeFaultController

fn pci_cfg_read(&mut self, offset: u16, value: &mut u32) -> IoResult

Dispatch a PCI config space read to the device with the given address.

fn pci_cfg_write(&mut self, offset: u16, value: u32) -> IoResult

Dispatch a PCI config space write to the device with the given address.

fn pci_cfg_read_forward( &mut self, _bus: u8, _device_function: u8, _offset: u16, _value: &mut u32, ) -> Option<IoResult>

Forward a PCI configuration space read to a downstream device.

fn pci_cfg_write_forward( &mut self, _bus: u8, _device_function: u8, _offset: u16, _value: u32, ) -> Option<IoResult>

Forward a PCI configuration space write to a downstream device.

fn suggested_bdf(&mut self) -> Option<(u8, u8, u8)>

Check if the device has a suggested (bus, device, function) it expects to be located at.

impl SaveRestore for NvmeFaultController

type SavedState = SavedStateNotSupported

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.