kvm_mips_mkclean_gpa_pt(9)

🦋 kvm_mips_mkclean_gpa_pt(9) — the Kernel API Manual moment 🦋

okay so bestie, we're in the kvm_mips_mkclean_gpa_pt(9) page rn, and it's literally about making guest physical addresses clean ✨ like yes we're doing laundry for memory, periodt.

---

💅 NAME 💅

kvm_mips_mkclean_gpa_pt — Make a range of guest physical addresses clean.

no cap, that's the whole vibe. a whole range of GPAs, freshly laundered 🧺

---

✨ SYNOPSIS ✨

int kvm_mips_mkclean_gpa_pt (struct kvm *kvm , gfn_t start_gfn , gfn_t end_gfn );

it's giving "one function, three arguments, zero chill" 💀

---

🎀 ARGUMENTS 🎀

• kvm — the KVM pointer. your main character struct, the whole reason we're here 🫶
• start_gfn — the guest frame number of the first page in the GPA range we're flushing. where the party starts 🎉
• end_gfn — the guest frame number of the last page in the GPA range we're flushing. where the party ends, sadly 😭

like, inclusive range energy. start_gfn to end_gfn, that's the assignment 🔥

---

🌸 DESCRIPTION 🌸

so what does it actually do?? it makes a range of GPA mappings clean so that guest writes will fault and trigger dirty page logging. like, intentionally making them fault. iconic behavior honestly 👑

⚠️ the caller must hold the kvm->mmu_lock spinlock. not optional, bestie. not "if you feel like it". HOLD. THE. LOCK. 🔒 this is the no-cap rule of the whole page.

---

⭐ RETURN ⭐

it returns whether any GPA mappings were modified — and like, that matters because it means derived mappings (that's GVA page tables & TLB enties 👀) need to be invalidated. so yeah, true-ish means "girl go invalidate things" 💅

(also yes, the original page says "enties". we're respecting the typo, it's canon now 🎀)

---

🌈 SEE ALSO 🌈

• the kernel file ./arch/mips/kvm/mmu.c 👑
• kvm_pgd_init(9)
• kvm_pgd_alloc(9)
• kvm_mips_walk_pgd(9)
• kvm_mips_flush_gpa_pt(9)
• kvm_arch_mmu_enable_log_dirty_pt_masked(9)
• _kvm_mips_map_page_fast(9)
• kvm_mips_map_page(9)
• kvm_mips_migrate_count(9)

whole friend group fr fr 🫶 read them all, iykyk

---

and that's the page!! 🌸 mwah 💖 source: ./arch/mips/kvm, dated October 2026, and we're signing off from kvm_mips_mkclean_gpa_pt(9) — stay clean, stay locked, stay slaying ✨💅🦋