Struct GuestMemorySharing 

pub struct GuestMemorySharing { /* private fields */ }

Opaque control object for accessing the shareable backing of guest memory. Not all GuestMemory instances support this — those backed by private memory or heap allocations return None.

Contract

• The regions returned by get_regions must have fully committed backing — the consumer will map them directly, without guestmem-managed fault handling.
• The set of regions is currently static for the lifetime of the VM. Hotplug and hot-remove of shareable regions are not yet supported; once they are, additional methods will be added here to notify consumers of changes.

Implementations

impl GuestMemorySharing

pub fn new(inner: impl ProvideShareableRegions + 'static) -> Self

Construct from a trait implementation. Called by GuestMemoryAccess implementations (e.g., VaMapper in membacking).

pub async fn get_regions( &self, ) -> Result<Vec<ShareableRegion>, ShareableRegionError>

Return the current set of shareable backing regions.