_kvm_mips_map_page_fast(9)

📦 version 7.3.1, in nixpkgs unstable

💅 _kvm_mips_map_page_fast(9) 💅

okay so this is from the Kernel API Manual, and bestie, it's literally the fast lane for guest page faults on MIPS KVM. buckle up 🎀

✨ NAME ✨

_kvm_mips_map_page_fast — the Fast path GPA fault handler. yes, "fast" is right there in the name, it's giving main character energy ⚡

🦋 SYNOPSIS 🦋

int _kvm_mips_map_page_fast (struct kvm_vcpu *vcpu , unsigned long gpa ,
bool write_fault , pte_t *out_entry , pte_t *out_buddy );

🌸 ARGUMENTS 🌸

  • vcpu — the VCPU pointer. your little virtual cpu baby 🫶
  • gpa — Guest physical address of fault. like, where the fault happened, address-wise 💫
  • write_fault — Whether the fault was due to a write. write or nah, that's the question ✍️
  • out_entry — New PTE for gpa (written on success unless NULL). ngl, if you pass NULL she just won't fill it in, no cap 🙈
  • out_buddy — New PTE for gpa's buddy (written on success unless NULL). yes, the page has a buddy, they're besties too 💖

🔥 DESCRIPTION 🔥

So the whole vibe here is: perform fast path GPA fault handling, doing all that can be done without calling into KVM. like, we're handling this ourselves, no need to bother the big kernel about it, periodt 💅

What does it actually do on this fast path? two iconic jobs:

  • marking old pages young (for idle page tracking) — glow-up era ⭐
  • dirtying of clean pages (for dirty page logging) — messy era 💀

that's it, that's the whole fast path. in and out, no KVM phone call needed.

🌈 RETURN 🌈

  • 0 on success — in which case we can update derived mappings and resume guest execution. slay, back to the guest 🎉
  • -EFAULT on failure due to absent GPA mapping or write to read-only page — in which case KVM must be consulted. yeah, this one's out of our hands, gotta escalate 🙈
fr fr, -EFAULT is the "not me, go ask KVM" signal. don't try to handle it yourself.

👑 SEE ALSO 👑

Kernel file ./arch/mips/kvm/mmu.c plus all these icons:

okay that's the whole page bestie, you ate it 💖✨

source: ./arch/mips/kvm · dated October 2026 · this was _kvm_mips_map_page_fast(9), manual name Kernel API Manual — mwah, go read the SEE ALSO list, iykyk 🧚‍♀️🎀

📦 where this page comes from