kvm_pgd_alloc(9)

💖 NAME 💖

kvm_pgd_alloc — bestie, this is the one that allocates and initialises a KVM GPA page directory ✨

---

🦋 SYNOPSIS 🦋

pgd_t * kvm_pgd_alloc (void );

---

🎀 ARGUMENTS 🎀

• void — literally no arguments, she takes nothing, she needs nothing, she simply arrives 💅

---

🌸 DESCRIPTION 🌸

okay so picture this: you need a blank KVM GPA page directory — a PGD — and this function is the one who hands it to you, freshly allocated, already initialised, no cap 💜

what's it for? representing guest physical to host physical page mappings. that's the whole vibe. it's giving "translator between two worlds" and honestly? iconic 👑

---

⭐ RETURN ⭐

• on the slay side: a pointer to your brand-new KVM GPA page directory 🫶
• on the not-so-slay side: NULL when the allocation fails 😭 (yes, she can fail, always check, fr fr)

---

🌈 SEE ALSO 🌈

kernel file ./arch/mips/kvm/mmu.c is right there holding it down, plus the whole friend group:

• kvm_pgd_init(9)
• kvm_mips_walk_pgd(9)
• kvm_mips_flush_gpa_pt(9)
• kvm_mips_mkclean_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)

iykyk 💫

---

and that's the whole page, bestie — brought to you from the kvm_pgd_alloc(9) section of the Kernel API Manual, filed under ./arch/mips/kvm, dated October 2026 🎀 go forth and allocate responsibly, mwah 💖🧚