kvm_vz_should_use_htimer(9)

💅 kvm_vz_should_use_htimer(9) 💅

okay so bestie, welcome to the Kernel API Manual, section 9 — yes we're in the big-kid kernel docs today and honestly? iconic. this one's about a lil function that just wants to know if it should use the VZ hard guest timer. one question, one answer, no drama. let's get into it 🫶

---

✨ NAME ✨

kvm_vz_should_use_htimer — literally just figures out whether to use the VZ hard guest timer. that's it. that's the whole vibe check 🌸

---

🦋 SYNOPSIS 🦋

bool kvm_vz_should_use_htimer (struct kvm_vcpu *vcpu );

---

🎀 ARGUMENTS 🎀

• vcpu — the virtual CPU, aka the main character of this whole operation 👑

---

🌈 RETURN 🌈

so here's the tea:

• it returns true when the VZ GTOffset & the real guest CP0_Count should be used instead of software emulation of the guest timer 💖
• otherwise it returns false — no hard timer for you, bestie, software emulation it is 💀

lowkey a whole binary decision but she's valid fr fr

---

💜 SEE ALSO 💜

you want more? say less, I got you. these are all hanging out in the kernel file ./arch/mips/kvm/vz.c together, like one big happy friend group 🧚:

• _kvm_vz_restore_stimer(9)
• _kvm_vz_restore_htimer(9)
• kvm_vz_restore_timer(9)
• kvm_vz_acquire_htimer(9)
• _kvm_vz_save_htimer(9)
• kvm_vz_save_timer(9)
• kvm_vz_lose_htimer(9)
• is_eva_access(9)
• is_eva_am_mapped(9)
• kvm_vz_gva_to_gpa(9)
• kvm_vz_badvaddr_to_gpa(9)
• kvm_trap_vz_handle_cop_unusable(9)
• kvm_trap_vz_handle_msa_disabled(9)
• kvm_vz_resize_guest_vtlb(9)

---

and that's the whole page bestie, no cap, nothing else hiding in here 🍓

mwah 💋 — this one's from ./arch/mips/kvm, dated October 2026, and yes it's still kvm_vz_should_use_htimer(9) in case you forgot already 😭 slay ✨