gmap_try_fixup_minor(9)

📦 version 7.3.1, in nixpkgs unstable

💅 gmap_try_fixup_minor(9) 💅

okay so bestie, we're in the Kernel API Manual today and the star of the show is gmap_try_fixup_minor — lowercase, snake_case, absolutely iconic naming, no notes. she's a function, she fixes things, let's get into it 🫶

✨ SYNOPSIS ✨

int gmap_try_fixup_minor (struct gmap *gmap , struct guest_fault *fault
);

that's the whole signature. two args, one int coming back at you. the way that she just *returns*… main character energy fr fr 😭

🎀 ARGUMENTS 🎀

  • gmap — the struct gmap * in question, aka the gmap whose fault needs to be resolved. this is the one we're fixing up. she's the subject of the whole operation 💅
  • fault — a struct guest_fault * that describes the fault that is being resolved. like, the receipts. the whole story of what went wrong 📝

🌸 DESCRIPTION 🌸

so what's a minor fault? great question bestie, glad you asked 💖

a minor fault is a fault that can be resolved quickly within gmap. quick little fix, no big production. and like, the reason it's "minor"?? the page is already mapped — the fault is only there because of dirty/young tracking. that's it. that's the whole drama. she's not lost, she just needs a vibe check on whether she's been touched recently 🦋

so gmap_try_fixup_minor rolls up, sees a minor fault, and is like "yeah I got this, no slow path needed" ✨

⭐ RETURN ⭐

the return value is doing a three-way thing, so pay attention bestie, this is important 👑

  • 0 — in case of success. we ate. 💅
  • < 0 — in case of error. something's wrong, and the number being negative is how she tells you 😭
  • > 0 — the fault could not be resolved and needs to go through the slow path. not a failure exactly, just a "this isn't a me problem, send it to the slow path" situation 🐢
no cap, that > 0 case is the one people skim past — but it is not an error, it just means slow path time. don't @ me.

🦋 SEE ALSO 🦋

the kernel file lives at ./arch/s390/kvm/gmap/gmap.c and here's the whole friend group, all in (9) form, all exactly as written:

go read them. iykyk 🌈

and that's the page!! 🌸 huge shoutout to the ./arch/s390/kvm/gmap crowd, dated October 2026 — mark your calendars bestie, this manual page is literally from the future 💀✨ mwah, love u, go fix some minor faults 🎀💜

📦 where this page comes from