Struct VirtioMem 

pub struct VirtioMem { /* private fields */ }

Implementations

impl VirtioMem

pub fn new( vm: Arc<Vm>, addr: GuestAddress, total_size_mib: usize, block_size_mib: usize, slot_size_mib: usize, ) -> Result<Self, VirtioMemError>

pub fn from_state( vm: Arc<Vm>, queues: Vec<Queue>, config: virtio_mem_config, slot_size: usize, plugged_blocks: BitVec, ) -> Result<Self, VirtioMemError>

pub fn id(&self) -> &str

pub fn guest_address(&self) -> GuestAddress

pub fn total_size_mib(&self) -> usize

Gets the total hotpluggable size.

pub fn block_size_mib(&self) -> usize

Gets the block size.

pub fn slot_size_mib(&self) -> usize

Gets the block size.

pub fn plugged_size_mib(&self) -> usize

Gets the total size of the plugged memory blocks.

pub fn requested_size_mib(&self) -> usize

Gets the requested size

pub fn status(&self) -> VirtioMemStatus

pub fn process_virtio_queues(&mut self) -> Result<(), VirtioMemError>

pub fn update_requested_size( &mut self, requested_size_mib: usize, ) -> Result<(), VirtioMemError>

Updates the requested size of the virtio-mem device.

Trait Implementations

impl Debug for VirtioMem

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

Formats the value using the given formatter.

impl MutEventSubscriber for VirtioMem

fn init(&mut self, ops: &mut EventOps<'_>)

Initialization called by the EventManager when the subscriber is registered.

fn process(&mut self, events: Events, ops: &mut EventOps<'_>)

Process events triggered in the event manager loop.

impl Persist<'_> for VirtioMem

type State = VirtioMemState

The type of the object representing the state of the component.

type ConstructorArgs = VirtioMemConstructorArgs

The type of the object holding the constructor arguments.

type Error = VirtioMemPersistError

The type of the error that can occur while constructing the object.

fn save(&self) -> Self::State

Returns the current state of the component.

fn restore( constructor_args: Self::ConstructorArgs, state: &Self::State, ) -> Result<Self, Self::Error>

Constructs a component from a specified state.

impl VirtioDevice for VirtioMem

fn const_device_type() -> u32

The virtio device type (as a constant of the struct).

fn device_type(&self) -> u32

The virtio device type.

fn queues(&self) -> &[Queue]

Returns the device queues.

fn queues_mut(&mut self) -> &mut [Queue]

Returns a mutable reference to the device queues.

fn queue_events(&self) -> &[EventFd]

Returns the device queues event fds.

fn interrupt_trigger(&self) -> &dyn VirtioInterrupt

fn avail_features(&self) -> u64

Get the available features offered by device.

fn acked_features(&self) -> u64

Get acknowledged features of the driver.

fn set_acked_features(&mut self, acked_features: u64)

Set acknowledged features of the driver. This function must maintain the following invariant:

fn read_config(&self, offset: u64, data: &mut [u8])

Reads this device configuration space at offset.

fn write_config(&mut self, offset: u64, _data: &[u8])

Writes to this device configuration space at offset.

fn is_activated(&self) -> bool

Checks if the resources of this device are activated.

fn activate( &mut self, mem: GuestMemoryMmap, interrupt: Arc<dyn VirtioInterrupt>, ) -> Result<(), ActivateError>

Performs the formal activation for a device, which can be verified also with is_activated.

fn kick(&mut self)

Kick the device, as if it had received external events.

fn has_feature(&self, feature: u64) -> bool

Check if virtio device has negotiated given feature.

fn interrupt_status(&self) -> Arc<AtomicU32>

Returns the current device interrupt status.

fn avail_features_by_page(&self, page: u32) -> u32

The set of feature bits shifted by page * 32.

fn ack_features_by_page(&mut self, page: u32, value: u32)

Acknowledges that this set of features should be enabled.

fn reset(&mut self) -> Option<(Arc<dyn VirtioInterrupt>, Vec<EventFd>)>

Optionally deactivates this device and returns ownership of the guest memory map, interrupt event, and queue events.

fn mark_queue_memory_dirty( &mut self, mem: &GuestMemoryMmap, ) -> Result<(), QueueError>

Mark pages used by queues as dirty.

fn as_cow_file_engine(&self) -> Option<&CowFileEngine>

Returns a COW file engine if the device exposes one (NYX extension).

fn nyx_handle_queue_event(&mut self, _queue_index: u16)

Handle a queue notification from an MMIO write (NYX extension).