_kvm_vz_restore_stimer(9)
π NAME π
_kvm_vz_restore_stimer β bestie, it restores the soft timer state. that's the whole vibe β¨
okay so real quick, before we dive in: this one lives in the Kernel API Manual, section 9 β yes, the kernel-functions chapter, we're in the big leagues now π. keep that in your back pocket for when you're citing it at 2am.
β¨ SYNOPSIS β¨
void _kvm_vz_restore_stimer (struct kvm_vcpu *vcpu , u32 compare , u32
cause );
that's the whole signature, no cap. returns void, so likeβ¦ nothing comes back. it just does the thing and leaves π
π ARGUMENTS π
vcpuβ the virtual CPU. it's astruct kvm_vcpu *, and it's the main character here, obviously π«Άcompareβ theCP0_Compareregister value. note that the caller restores this one, not us β we just get handed it πcauseβ theCP0_Causeregister, and this is the one we're restoring.
πΈ DESCRIPTION πΈ
so what it actually does: it restores the VZ state relating to the soft timer π°οΈβ¨
and the cute part? the hard timer can be enabled later β like, it's not invited to this party yet. soft timer only, htimer can come through whenever π
lowkey important: the caller is the one restoring theCP0_Comparevalue (compare). don't be out here thinking this function does it for you, because it does not π
π¦ SEE ALSO π¦
say it with me: the lore π§. also heads up, this whole little family lives in the kernel file ./arch/mips/kvm/vz.c β that's the source of truth, bestie, go read it iykyk π
kvm_vz_should_use_htimer(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)
like, that's the whole friend group right there. htimer siblings, eva girlies, gpa translators, trap handlers, vtlb resizer β everybody's invited π
and that's the page, bestie π stay hydrated, back up your configs, and remember: soft timer now, hard timer later. periodt π
sign-off time: this one's filed under ./arch/mips/kvm, dated October 2026, and the page itself is _kvm_vz_restore_stimer(9) β see you in the next manpage, love u π«Άπ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms