kvm_gpc_init(9)

💖 kvm_gpc_init(9) 💖

okay so bestie, welcome to the Kernel API Manual — this one's about kvm_gpc_init, and yes it's a (9) page so it's living its best life in the kernel docs ✨

---

🌸 NAME 🌸

kvm_gpc_init — initialize gfn_to_pfn_cache.

---

🎀 SYNOPSIS 🎀

void kvm_gpc_init (struct gfn_to_pfn_cache *gpc , struct kvm *kvm );

like. that's the whole call. two args. slay.

---

🦋 ARGUMENTS 🦋

• gpc — a struct gfn_to_pfn_cache object. this is the thing you're setting up, she's the main character 💅
• kvm — pointer to the kvm instance. yep, that kvm 🔥

---

💜 DESCRIPTION 💜

so what this does is it sets up a gfn_to_pfn_cache by initializing the locks and assigning the immutable attributes (the ones that never change, periodt — they get locked in at init and stay that way) 🫶

⚠️ bestie listen, this part matters: the cache must be zero-allocated (or zeroed by the caller before init). not optional, not a vibe, just do it. no cap 😭

---

⭐ SEE ALSO ⭐

• Kernel file ./include/linux/kvm_host.h
• guest_state_enter_irqoff(9)
• guest_state_exit_irqoff(9)
• kvm_gpc_activate(9)
• kvm_gpc_activate_hva(9)
• kvm_gpc_check(9)
• kvm_gpc_refresh(9)
• kvm_gpc_deactivate(9)
• kvm_stats_linear_hist_update(9)
• kvm_stats_log_hist_update(9)

like a whole friend group of kernel functions tbh, go say hi 🌈

---

okay that's the page!! this icon came from ./include/linux, dated October 2026 — mwah, love that for us 💖🧚‍♀️💫