kvm_mips_flush_gpa_pt(9)

📦 version 7.3.1, in nixpkgs unstable

💅 kvm_mips_flush_gpa_pt(9) — like, the Kernel API Manual page, bestie 🎀

okay so picture this: you're deep in the MIPS KVM code, it's the Kernel API Manual, and this one little function is out here doing the most — it's kvm_mips_flush_gpa_pt, and it's genuinely iconic.

✨ NAME ✨

kvm_mips_flush_gpa_pt — flushes a whole range of guest physical addresses. that's it, that's the vibe, it's giving "clean slate" energy 🧹💖

🌸 SYNOPSIS 🌸

bool kvm_mips_flush_gpa_pt (struct kvm *kvm , gfn_t start_gfn , gfn_t end_gfn );

yeah she takes three things and hands you back a bool. short king behavior, no cap 👑

🦋 ARGUMENTS 🦋

  • kvm — the KVM pointer. your main character struct, literally the whole world of this VM 🫶
  • start_gfn — the guest frame number of the first page in the GPA range you wanna flush. where the party starts 🎉
  • end_gfn — the guest frame number of the last page in the GPA range. where it wraps up. inclusive, she's generous like that 🌈

💜 DESCRIPTION 💜

so what does it actually do?? it flushes a range of GPA mappings right outta the GPA page tables. bye bye mappings, we don't know them anymore ✨

⚠️ bestie, IMPORTANT: the caller must hold the kvm->mmu_lock spinlock. like, you literally have to. this is not a suggestion, it's the rules. hold the lock, or don't come to the function 💀🔒

🔥 RETURN 🔥

it returns whether it's safe to remove the top level page directory — which is only true because all the lower levels have already been removed. so like, it's telling you "yeah the whole tree underneath is gone, you can yeet the top now" 🌳➡️🗑️

👑 SEE ALSO 👑

kernel file ./arch/mips/kvm/mmu.c — that's the home turf, the source of truth 🏠

and the whole friend group, fr fr:

anyway, that's the whole page, mwah 💋 this little number lives over in ./arch/mips/kvm, and the version we're serving you is dated October 2026 — October 2026 said "let me serve cunt" and it ATE 🍓🧚‍♀️💖 no notes, periodt.

📦 where this page comes from