Partitions

The hypervisor supports isolation in terms of a partition. A partition is a logical unit of isolation, supported by the hypervisor, in which operating systems execute.

Partition Privilege Flags

Each partition has a set of privileges assigned by the hypervisor. Privileges control access to synthetic registers or hypercalls.

On x64 platforms, a partition can query its privileges through the "Hypervisor Feature Identification" CPUID Leaf (0x40000003).

On ARM64 platforms, a partition can query its privileges through the HvRegisterPrivilegesAndFeaturesInfo register using HvCallGetVpRegisters.

See HV_PARTITION_PRIVILEGE_MASK for a description of all privileges.

Partition Crash Enlightenment

The hypervisor provides guest partitions with a crash enlightenment facility. This interface allows the operating system running in a guest partition the option of providing forensic information about fatal OS conditions to the hypervisor as part of its crash dump procedure. Options include preserving the contents of the guest crash parameter registers and specifying a crash message. The hypervisor then makes this information available to the root partition for logging. This mechanism allows the virtualization host administrator to gather information about the guest OS crash event without needing to inspect persistent storage attached to the guest partition for crash dump or core dump information that may be stored there by the crashing guest OS.

On x64 platforms, the availability of this mechanism is indicated via CPUID.0x40000003.EDX:10, the GuestCrashMsrsAvailable flag. On ARM64 platforms, the availability is indicated in bit 105 of HvRegisterPrivilegesAndFeaturesInfo. Refer to feature discovery for details.

Guest Crash Enlightenment Interface

On x64 platforms, the guest crash enlightenment interface is provided through six synthetic MSRs, as defined below.

#define HV_X64_MSR_CRASH_P0 0x40000100
#define HV_X64_MSR_CRASH_P1 0x40000101
#define HV_X64_MSR_CRASH_P2 0x40000102
#define HV_X64_MSR_CRASH_P3 0x40000103
#define HV_X64_MSR_CRASH_P4 0x40000104
#define HV_X64_MSR_CRASH_CTL 0x40000105

On ARM64 platforms, the guest crash enlightenment interface is provided through six synthetic registers accessed via HvCallGetVpRegisters and HvCallSetVpRegisters:

• HvRegisterGuestCrashP0
• HvRegisterGuestCrashP1
• HvRegisterGuestCrashP2
• HvRegisterGuestCrashP3
• HvRegisterGuestCrashP4
• HvRegisterGuestCrashCtl

Guest Crash Control Register

The guest crash control register (HV_X64_MSR_CRASH_CTL on x64, HvRegisterGuestCrashCtl on ARM64) may be used by guest partitions to determine the hypervisor's guest crash capabilities, and to invoke the specified action to take. The HV_CRASH_CTL_REG_CONTENTS data structure defines the contents of the register.

Determining Guest Crash Capabilities

To determine the guest crash capabilities, guest partitions may read the guest crash control register. The supported set of actions and capabilities supported by the hypervisor is reported.

Invoking Guest Crash Capabilities

To invoke a supported hypervisor guest crash action, a guest partition writes to the guest crash control register, specifying the desired action. Two variations are supported: CrashNotify by itself, and CrashMessage in combination with CrashNotify. For each occurrence of a guest crash, at most a single write to the guest crash control register should be performed, specifying one of the two variations.