STRUCT X86_HYPER_RUNTIME(9)

🌸 NAME 🌸

struct x86_hyper_runtime — x86 hypervisor specific runtime callbacks. okay so bestie, this is the Kernel API Manual page for that exact struct, and we're gonna go through every single member 💅 no skips, no cap.

✨ SYNOPSIS ✨

       struct x86_hyper_runtime {
           void (*pin_vcpu)(int cpu);
           void (*sev_es_hcall_prepare)(struct ghcb *ghcb, struct pt_regs
       *regs);
           bool (*sev_es_hcall_finish)(struct ghcb *ghcb, struct pt_regs
       *regs);
           bool (*is_private_mmio)(u64 addr);
        };

🫶 Members 🫶

• pin_vcpu — pin current vcpu to specified physical cpu (run rarely) 🫡
• sev_es_hcall_prepare — load additional hypervisor-specific state into the GHCB when doing a VMMCALL under SEV-ES. called from the #VC exception handler.
• sev_es_hcall_finish — copies state from the GHCB back into the processor (or pt_regs). also runs checks on the state returned from the hypervisor after a VMMCALL under SEV-ES. needs to return 'false' if the checks fail. called from the #VC exception handler.
• is_private_mmio — for CoCo VMs, must map MMIO address as private. used when device is emulated by a paravisor layer in the VM context.

👀 SEE ALSO 👀

Kernel file ./arch/x86/include/asm/x86_init.h — and the whole linked-up friend group:

• struct x86_init_mpparse(9)
• struct x86_init_resources(9)
• struct x86_init_irqs(9)
• struct x86_init_oem(9)
• struct x86_init_paging(9)
• struct x86_init_timers(9)
• struct x86_init_iommu(9)
• struct x86_init_pci(9)
• struct x86_hyper_init(9)
• struct x86_init_acpi(9)
• struct x86_guest(9)
• struct x86_init_ops(9)
• struct x86_cpuinit_ops(9)
• struct x86_legacy_devices(9)
• enum x86_legacy_i8042_state(9)
• struct x86_legacy_features(9)
• struct x86_platform_ops(9)

mwah 💋 that's the whole page, bestie. source/version: ./arch/x86/include/asm · date: October 2026 · title: struct x86_hyper_runtime(9). go forth and slay your hypervisor runtime callbacks ✨