Struct UhPartition

pub struct UhPartition { /* private fields */ }

Underhill partition.

Implementations

impl UhPartition

Immutable access to useful bits of Partition state.

pub fn revoke_guest_vsm(&self) -> Result<(), RevokeGuestVsmError>

Revokes guest VSM.

pub fn reference_time(&self) -> u64

Returns the current hypervisor reference time, in 100ns units.

impl UhPartition

pub fn vtl0_guest_os_id(&self) -> Result<HvGuestOsId, Error>

Gets the guest OS ID for VTL0.

pub fn register_host_io_port_fast_path( &self, range: RangeInclusive<u16>, ) -> HostIoPortFastPathHandle

Configures guest accesses to IO ports in range to go directly to the host.

When the return value is dropped, the ports will be unregistered.

pub fn set_pm_timer_assist(&self, port: Option<u16>) -> Result<(), HvError>

Enables or disables the PM timer assist.

impl UhPartition

pub fn host_mmio_read(&self, addr: u64, data: &mut [u8])

Forward a (virtual) MMIO read to the host for handling.

pub fn host_mmio_write(&self, addr: u64, data: &[u8])

Forward a (virtual) MMIO write to the host for handling.

Trait Implementations

impl DeviceBuilder for UhPartition

fn build(&self, vtl: Vtl, device_id: u64) -> Result<Self::Device, Self::Error>

impl Hv1 for UhPartition

type Error = Error

type Device = ApicSoftwareDevice

fn new_virtual_device( &self, ) -> Option<&dyn DeviceBuilder<Device = Self::Device, Error = Self::Error>>

impl Inspect for UhPartition

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

Inspects the object.

impl Partition for UhPartition

fn supports_reset(&self) -> Option<&dyn ResetPartition<Error = Self::Error>>

Returns a trait object to reset the partition, if supported.

fn caps(&self) -> &PartitionCapabilities

Get the partition capabilities for this partition.

fn request_msi(&self, vtl: Vtl, request: MsiRequest)

Requests an MSI for the specified VTL.

fn request_yield(&self, _vp_index: VpIndex)

Forces the run_vp call to yield to the scheduler (i.e. return Poll::Pending).

fn supports_initial_accept_pages( &self, ) -> Option<&dyn AcceptInitialPages<Error = Self::Error>>

Returns a trait object to accept pages on behalf of the guest during the initial start import flow.

fn supports_vtl_scrub(&self) -> Option<&dyn ScrubVtl<Error = Self::Error>>

Returns a trait object to reset VTL state, if supported.

fn doorbell_registration( self: &Arc<Self>, minimum_vtl: Vtl, ) -> Option<Arc<dyn DoorbellRegistration>>

Returns an interface for registering MMIO doorbells for this partition.

fn msi_interrupt_target( self: &Arc<Self>, vtl: Vtl, ) -> Option<Arc<dyn MsiInterruptTarget>>

Returns an MSI interrupt target for this partition, which can be used to create MSI interrupts.

impl Synic for UhPartition

fn post_message( &self, vtl: Vtl, vp_index: VpIndex, sint: u8, typ: u32, payload: &[u8], )

Posts a message to the guest.

fn new_guest_event_port(&self) -> Box<dyn GuestEventPort>

Creates a [GuestEventPort] for signaling VMBus channels in the guest.

fn prefer_os_events(&self) -> bool

Returns whether callers should pass an OS event when creating event ports, as opposed to passing a function to call.

fn monitor_support(&self) -> Option<&dyn SynicMonitor>

Returns an object for manipulating the monitor page, or None if monitor pages aren’t supported.

fn new_host_event_port( &self, connection_id: u32, minimum_vtl: Vtl, event: &Event, ) -> Result<Option<Box<dyn Send + Sync>>, Error>

Adds a fast path to signal event when the guest signals connection_id from VTL >= minimum_vtl.

impl SynicMonitor for UhPartition

fn set_monitor_page(&self, gpa: Option<u64>) -> Result<()>

Sets the GPA of the monitor page currently in use.

fn register_monitor( &self, monitor_id: MonitorId, connection_id: u32, ) -> Box<dyn Send>

Registers a monitored interrupt. The returned struct will unregister the ID when dropped.

impl VtlMemoryProtection for UhPartition

fn modify_vtl_page_setting(&self, pfn: u64, flags: HvMapGpaFlags) -> Result<()>

TODO CVM GUEST_VSM: GH954: Review alternatives to dynamically allocating from VTL2 RAM (e.g. reserve pages for this purpose), or constrain it for more safety. The concern is freeing a page but forgetting to reset permissions. See PagesAccessibleToLowerVtl for a sample wrapper.

impl X86Partition for UhPartition

fn ioapic_routing(&self) -> Arc<dyn IoApicRouting>

Gets the IO-APIC routing control for VTL0.

fn pulse_lint(&self, vp_index: VpIndex, vtl: Vtl, lint: u8)

Pulses the specified APIC’s local interrupt line (0 or 1).