kvm_riscv_vcpu_virtual_insn(9)

💅 kvm_riscv_vcpu_virtual_insn(9) 💅

okay so bestie, welcome to the Kernel API Manual — section 9, the good section, the "we're talking about kernel functions now" section. This page is all about kvm_riscv_vcpu_virtual_insn, and literally the whole vibe is: it handles the virtual instruction trap. That's it, that's the job. 🎀

---

✨ NAME ✨

kvm_riscv_vcpu_virtual_insn — handle virtual instruction trap. no cap, that's the entire name-and-purpose combo right there 🦋

---

🌸 SYNOPSIS 🌸

int kvm_riscv_vcpu_virtual_insn (struct kvm_vcpu *vcpu , struct kvm_run
*run , struct kvm_cpu_trap *trap );

so it returns an int, and it takes three things: a struct kvm_vcpu * called vcpu, a struct kvm_run * called run, and a struct kvm_cpu_trap * called trap. that's the whole signature, she's not complicated 💅

---

🦋 ARGUMENTS 🦋

• vcpu — the VCPU pointer. iconic. the main character of this whole little function 🫶
• run — the VCPU run struct that's carrying the mmio data. it's giving "I hold the data, you handle the logic" ✨
• trap — the trap details. everything you ever wanted to know about the trap, right here 🌸

---

💖 DESCRIPTION 💖

okay so here's the return-value situation, and honestly it's a whole mood board:

• returns > 0 — continue the run-loop, we're so back, keep going bestie 🔥
• returns 0 — exit the run-loop and handle it in user-space. stepping out, doing it elsewhere, still slay 💀
• returns < 0 — report failure and exit the run-loop. not the vibe, but we said it clearly 😭

that's genuinely the whole description. three outcomes, zero fluff, she ate 🍓

---

👑 SEE ALSO 👑

• the kernel file ./arch/riscv/kvm/vcpu_insn.c — go read the source, iykyk 💜
• kvm_riscv_vcpu_wfi(9)
• kvm_riscv_vcpu_csr_return(9)
• kvm_riscv_vcpu_mmio_load(9)
• kvm_riscv_vcpu_mmio_store(9)
• kvm_riscv_vcpu_mmio_return(9)

the whole friend group 🧚 the mmio siblings are lowkey all here and they're iconic

---

fr fr bestie, it's just a trap handler with three return paths — read it, love it, cite it in your commit message 🌈

---

and that's a wrap on our little kernel-API hangout 💖 this page lives in ./arch/riscv/kvm, it's dated October 2026, and it's filed under kvm_riscv_vcpu_virtual_insn(9) — go off, and remember: highkey always check your return values ⭐