check_gpa_range(9)

💅 check_gpa_range(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes we're in the kernel, yes it's giving big-brain energy, and yes this one is a little s390-specific gem 🦋

---

✨ NAME ✨

check_gpa_range — test a range of guest physical addresses for accessibility 👑

like, is this chunk of guest memory actually reachable or not? that's the whole vibe check 🔥

---

🌸 SYNOPSIS 🌸

int check_gpa_range (struct kvm *kvm , unsigned long gpa , unsigned long length , enum gacc_mode mode , u8 access_key );

that's the whole signature, no cap — copy it exactly, she's particular about her types 💅

---

🫶 ARGUMENTS 🫶

• kvm — the virtual machine instance, aka the main character we're doing all this for 💖
• gpa — guest physical address, the starting point of the range we're checking
• length — length of test range, so like how far the vibe extends from gpa ✨
• mode — the access mode to test, and heads up: this one's relevant for storage keys 🎀
• access_key — access key, which is what you use to match against the storage keys 🗝️

---

👀 SEE ALSO 👀

the kernel file is ./arch/s390/kvm/s390/gaccess.c — go read it, iykwim 🧚

and the whole friend group, all of them literal icons:

• 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)
• kvm_s390_check_low_addr_prot_real(9)
• walk_guest_tables(9)
• __gaccess_shadow_fault(9)

ngl bestie, if you're poking at guest address translation on s390, this whole list is your syllabus 📚 don't skip it 🙈

---

mwah 💜 this page lives in ./arch/s390/kvm/s390, dated October 2026, and it's literally titled check_gpa_range(9) — slay, go forth and check those ranges 🌈⭐