guest_transl...ess_with_key(9)

💅 guest_transl...ess_with_key(9) — like, the Kernel API Manual glow-up ✨

okay so bestie, welcome to the Kernel API Manual entry for guest_transl...ess_with_key(9) — yes the title is truncated with ... and no we don't know why, it's giving mysterious main character energy 🎀 but the actual function is guest_translate_address_with_key and she is iconic. Let's get into it fr fr.

---

✨ NAME ✨

guest_translate_address_with_key — she translates a guest logical address into a guest absolute address. that's it, that's the whole vibe 💫

🦋 SYNOPSIS 🦋

int guest_translate_address_with_key (struct kvm_vcpu *vcpu , unsigned
long gva , u8 ar , unsigned long *gpa , enum gacc_mode mode , u8
access_key );

like, copy that exactly bestie, no cap, every character matters 🙈

🌸 ARGUMENTS 🌸

• vcpu — the virtual cpu, aka the little guy we're doing all this for 👑
• gva — Guest virtual address, the address we start with 💖
• ar — Access register, yes it's there, yes it matters ✨
• gpa — Guest physical address, this is where the translated result lands 🎯
• mode — Translation access mode, the vibe check for how we're translating 🌈
• access_key — the access key that gets matched against the storage key 🔑

💜 DESCRIPTION 💜

so the parameter semantics are literally the same as the ones from guest_translate. same energy, same meanings, no notes 🫶

and the important part: the memory contents at the guest address are not changed. she's just translating, not touching anything. purely vibes 💅

🔥 NOTE 🔥

okay so this is the part you actually need to read bestie 😭 the IPTE lock is not taken during this function — so the caller has to take care of that themselves. no hand-holding, no auto-lock, it's giving "you're on your own, good luck, slay" 💀 don't forget it 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)
• check_gva_range(9)
• check_gpa_range(9)
• kvm_s390_check_low_addr_prot_real(9)
• walk_guest_tables(9)
• __gaccess_shadow_fault(9)

---

and that's the page bestie 🎀 this one lives in ./arch/s390/kvm/s390, dated October 2026, and the header/footer both say guest_transl...ess_with_key(9) because it's committed to the truncated-name aesthetic 💖 mwah, go translate something 🦋✨