read_guest_instr(9)

💖 NAME 💖

okay so bestie, this is the manual page for read_guest_instr(9), from the Kernel API Manual — and it's literally here to copy instruction data from guest space to kernel space. no cap. 🫶

---

✨ SYNOPSIS ✨

the signature, served fresh, commas and all:

int read_guest_instr (struct kvm_vcpu *vcpu , unsigned long ga , void
       *data , unsigned long len );

---

🎀 ARGUMENTS 🎀

• vcpu — virtual cpu. the main character vcpu, iykyk.
• ga — guest address. where we're reading from, bestie.
• data — destination address in kernel space. that's the glow-up location.
• len — number of bytes to copy. the exact amount, periodt.

---

🦋 DESCRIPTION 🦋

Copy len bytes from the given address (guest space) to data (kernel space). simple, iconic, done.

The behaviour of read_guest_instr is identical to read_guest, except that instruction data will be read from primary space when in home-space or address-space mode. that's the whole twist — lowkey crucial, highkey specific, so don't sleep on it. 💅

---

🌸 SEE ALSO 🌸

Kernel file ./arch/s390/kvm/s390/gaccess.h — go read, bestie:

• kvm_s390_real_to_abs(9)
• _kvm_s390_logical_to_effective(9)
• kvm_s390_logical_to_effective(9)
• put_guest_lc(9)
• write_guest_lc(9)
• read_guest_lc(9)
• write_guest_with_key(9)
• write_guest(9)
• read_guest_with_key(9)
• read_guest(9)
• write_guest_abs(9)
• read_guest_abs(9)
• write_guest_real(9)
• read_guest_real(9)

---

byeee, this little page comes from ./arch/s390/kvm/s390, dated October 2026, and it's read_guest_instr(9) — mwah 💋✨