Struct MshvVtl 

pub struct MshvVtl { /* private fields */ }

An open mshv_vtl device file.

Implementations

impl MshvVtl

pub fn get_realm_config(&self) -> Result<RsiRealmConfig, Error>

Get the realm-specific parameters from the RMM

pub fn rsi_sysreg_write( &self, vtl: GuestVtl, sysreg: u64, value: u64, ) -> Result<(), SetRegError>

Write the value of a system register for the given VTL

pub fn rsi_sysreg_read( &self, vtl: GuestVtl, sysreg: u64, value: &mut u64, ) -> Result<(), GetRegError>

Read the value of a system register for the given VTL.

pub fn rsi_set_mem_perm( &self, vtl: GuestVtl, range: &MemoryRange, ) -> Result<(), HvError>

Assign given memory range to the VTL.

pub fn rsi_get_ipa_state( &self, fipa: u64, ) -> Result<Option<u64>, GetIpaStateError>

Get the ipa RIPAS state

impl MshvVtl

pub fn pvalidate_pages( &self, range: MemoryRange, validate: bool, terminate_on_failure: bool, ) -> Result<(), SnpPageError>

Execute the pvalidate instruction on the specified memory range.

The range must not be mapped in the kernel as RAM.

pub fn rmpadjust_pages( &self, range: MemoryRange, value: SevRmpAdjust, terminate_on_failure: bool, ) -> Result<(), SnpPageError>

Execute the rmpadjust instruction on the specified memory range.

The range must not be mapped in the kernel as RAM.

pub fn rmpquery_page( &self, gpa: u64, vtl: GuestVtl, ) -> Result<SevRmpAdjust, SnpPageError>

Gets the current vtl permissions for a page. Note: only supported on Genoa+

impl MshvVtl

pub fn tdx_set_page_attributes( &self, range: MemoryRange, attributes: TdgMemPageGpaAttr, mask: TdgMemPageAttrWriteR8, ) -> Result<(), TdCallResultCode>

Issues a tdcall to set page attributes.

pub fn tdx_accept_pages( &self, range: MemoryRange, attributes: Option<(TdgMemPageGpaAttr, TdgMemPageAttrWriteR8)>, ) -> Result<(), AcceptPagesError>

Issues a tdcall to accept pages, optionally also setting attributes.

These operations are combined because this code tries accepting at 2MB granularity first and then falls back to 4KB. A separate call to Self::tdx_set_page_attributes has to re-derive the appropriate granularity.

pub fn tdx_release_pages( &self, range: MemoryRange, ) -> Result<(), TdgPageReleaseError>

Issues tdcalls to release pages.

pub fn tdx_get_config_flags(&self) -> TdConfigFlags

Issues tdcall to get TD-scoped config flags.

pub fn tdx_read_features0(&self) -> Result<TdxFeatures0, TdCallResult>

Reads the global-scope TDX_FEATURES0 metadata field via the TDG.SYS.RD TDCALL, which enumerates optional TDX module features (including hardware-bound sealing support).

Returns an error if the module does not support TDG.SYS.RD (older modules) or rejects the field.

pub fn tdx_enable_hw_seal_keys(&self) -> Result<bool, TdCallResult>

Attempts to opt this TD into hardware-bound seal keys by setting TD_CTLS.ENABLE_HW_SEAL_KEYS, enabling the TDG.MR.KEY.GET TDCALL that backs VMGS hardware key sealing.

Returns Ok(true) if the bit is set after the operation (sealing keys are available), or Ok(false) if the TDX module does not support sealing.

A TDX module that does not implement sealing treats ENABLE_HW_SEAL_KEYS as a reserved bit and may silently ignore the masked write while still returning success. The write status alone is therefore not sufficient, so this reads TD_CTLS back and reports whether the bit actually stuck.

impl MshvVtl

pub fn add_vtl0_memory( &self, mem_range: MemoryRange, shared: bool, ) -> Result<(), Error>

Adds the VTL0 memory as a ZONE_DEVICE memory (I/O) to support DMA from the guest.

Trait Implementations

impl Debug for MshvVtl

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

Formats the value using the given formatter.