psb_gem_fault(9)

✨ NAME ✨

Okay so bestie, welcome to the Kernel API Manual entry for psb_gem_fault(9) — and the name is literally giving pagefault handler for GEM objects. That’s the whole assignment, no cap. 💅

🎀 SYNOPSIS 🎀

vm_fault_t psb_gem_fault (struct vm_fault *vmf );

🌸 ARGUMENTS 🌸

• vmf — the fault detail. That’s the whole little argument moment, slay. 🦋

🦋 DESCRIPTION 🦋

So this handler gets invoked when a fault happens on an mmap of a GEM managed area. GEM is out here doing most of the work for us — including the actual map/unmap calls — but we still have to do the actual page work. Iconic division of labor, honestly. ✨

This code eventually needs to handle faulting objects in and out of the GTT and repacking it when we run out of space. We can put that off for now — and, like, for our simple uses. 💀

The VMA was set up by GEM. And in doing so, it also made sure that vma->vm_private_data points to the GEM object that is backing this mapping. Main character pointer energy, fr fr. 👑

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/gma500/gem.c
• psb_gem_dumb_create(9)

This cutie is brought to you by the source/version path ./drivers/gpu/drm/gma500, stamped October 2026. 🫶💜🎀