STRUCT PV_VM_TO_BE_DESTROYED(9)

💅 struct pv_vm_to_be_destroyed(9) — like, the Kernel API Manual page you actually wanna read 🎀

okay bestie, so this is a page from the Kernel API Manual and it's literally about a struct that holds a protected VM which is, yes, marked for destruction 💀 — no cap, that's the whole vibe.

---

✨ NAME ✨

struct pv_vm_to_be_destroyed — the little container that represents a protected VM that needs to be destroyed 🫶

---

🌸 SYNOPSIS 🌸

struct pv_vm_to_be_destroyed {
    struct list_head list;
    unsigned long old_gmap_table;
    u64 handle;
    void *stor_var;
    unsigned long stor_base;
 };

like, that's the whole struct, copy-pasted with love, character for character 💖

---

🦋 Members 🦋

• list — the list head for the list of leftover VMs. it's giving "linked list main character energy" 👑
• old_gmap_table — the gmap table of the leftover protected VM. yes, old, don't come for her 🌈
• handle — the handle of the leftover protected VM, an actual u64, iconic ⭐
• stor_var — pointer to the variable storage of the leftover protected VM 🎀
• stor_base — the address of the base storage of the leftover protected VM, one unsigned long of pure responsibility 💅

---

💜 Description 💜

so this struct represents a protected VM that is still registered with the Ultravisor but which does not correspond any longer to an active KVM VM 😭 like it's on the books but nobody's home. it should be destroyed at some point later — either asynchronously, or when the process terminates. periodt. 🔥

ngl bestie, key detail: should be destroyed at some point later. it's not optional-cute, it's an actual pending cleanup situation 🙈

---

💀 SEE ALSO 💀

Kernel file ./arch/s390/kvm/s390/pv.c — and the whole friend group:

• should_export_before_import(9)
• kvm_s390_pv_make_secure(9)
• kvm_s390_pv_destroy_page(9)
• kvm_s390_pv_dispose_one_leftover(9)
• kvm_s390_pv_set_aside(9)
• kvm_s390_pv_deinit_vm(9)
• kvm_s390_pv_deinit_cleanup_all(9)
• kvm_s390_pv_deinit_aside_vm(9)
• kvm_s390_pv_dump_stor_state(9)
• kvm_s390_pv_dump_complete(9)

---

and that's the tea 🍓 this page came from ./arch/s390/kvm/s390, dated October 2026, and it's struct pv_vm...be_destroyed(9) if you ever need to find her again 💖✨🦋