walk_guest_tables(9)

💅 walk_guest_tables(9) — from the Kernel API Manual ✨

okay bestie, buckle up, because this one's a whole little s390 situation. we're looking at walk_guest_tables(9) — the kernel API manual page, no big deal, only iconic behavior 💖

---

🎀 NAME 🎀

walk_guest_tables — literally walks the guest page table and pins the dat tables. that's it, that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

int walk_guest_tables (struct gmap *sg , unsigned long saddr , struct
pgtwalk *w , bool wr );

like, look at her. four args, one int return, absolute main character energy 👑

---

🌸 ARGUMENTS 🌸

• sg — pointer to the shadow guest address space structure. yes bb, the shadow guest one 🫶
• saddr — the faulting address in the shadow gmap. that's the address that's out here causing drama 💀
• w — this one gets filled with all the info on the pinned pages. she's an output param, she's booked and busy ✨
• wr — indicates a write access when it's true. so like, true = we're writing, no cap ✍️

---

🌈 RETURN 🌈

here's the vibe check on what you get back:

• 0 in case of success — slay, we ate 💅
• a PIC code > 0 in case the address translation fails — not us failing, the translation failing, important distinction 🙈
• an error code < 0 if other errors happen in the host — the host said no 💀

lowkey important: those three are different flavors, don't go treating a positive PIC code like it's just "an error" — the sign matters, fr fr.

---

🦋 SEE ALSO 🦋

kernel file ./arch/s390/kvm/s390/gaccess.c, plus the whole friend group:

• guest_translate_gva(9)
• guest_range_to_gpas(9)
• __cmpxchg_with_key(9)
• cmpxchg_guest_abs_with_key(9)
• guest_translate_address_with_key(9)
• check_gva_range(9)
• check_gpa_range(9)
• kvm_s390_check_low_addr_prot_real(9)
• __gaccess_shadow_fault(9)

go read them, iykyk 🔥

---

k that's the page, bestie 🧚 this gem comes to you courtesy of ./arch/s390/kvm/s390, dated October 2026 — she's from the future and she still has her whole life together ⭐💜