Struct dbs_address_space::AddressSpace

pub struct AddressSpace { /* private fields */ }

An address space implementation with region hotplug capability.

The AddressSpace is a wrapper over AddressSpaceBase to support hotplug of address space regions.

Implementations

impl AddressSpace

pub fn convert_into_vm_as(
    gm: GuestMemoryMmap
) -> GuestMemoryAtomic<GuestMemoryMmap>

Convert a GuestMemoryMmap object into GuestMemoryAtomic<GuestMemoryMmap>.

pub fn from_regions(
    regions: Vec<Arc<AddressSpaceRegion>>,
    layout: AddressSpaceLayout
) -> Self

Create an instance of AddressSpace from an AddressSpaceRegion array.

To achieve better performance by using binary search algorithm, the regions vector will gotten sorted by guest physical address.

Note, panicking if some regions intersects with each other.

Arguments

• regions - prepared regions to managed by the address space instance.
• layout - prepared address space layout configuration.

pub fn insert_region(
    &mut self,
    region: Arc<AddressSpaceRegion>
) -> Result<(), AddressSpaceError>

Insert a new address space region into the address space.

Arguments

• region - the new region to be inserted.

pub fn walk_regions<F>(&self, cb: F) -> Result<(), AddressSpaceError>where
    F: FnMut(&Arc<AddressSpaceRegion>) -> Result<(), AddressSpaceError>,

Enumerate all regions in the address space.

Arguments

• cb - the callback function to apply to each region.

pub fn layout(&self) -> AddressSpaceLayout

Get address space layout associated with the address space.

pub fn last_addr(&self) -> GuestAddress

Get maximum of guest physical address in the address space.

pub fn is_dax_region(&self, guest_addr: GuestAddress) -> bool

Check whether the guest physical address guest_addr belongs to a DAX memory region.

Arguments

• guest_addr - the guest physical address to inquire

pub fn numa_node_id(&self, gpa: u64) -> Option<u32>

Get optional NUMA node id associated with guest physical address gpa.

Arguments

• gpa - guest physical address to query.

Trait Implementations

impl Clone for AddressSpace

fn clone(&self) -> AddressSpace

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.