panfrost_lookup_bos(9)

💅 panfrost_lookup_bos(9) — the kernel API manual, but make it make sense

okay so bestie, welcome to panfrost_lookup_bos(9) from the Kernel API Manual — this is literally the function that sets up job->bo[] with the GEM objects that your job is referencing ✨

---

🌸 NAME 🌸

panfrost_lookup_bos — sets up job->bo[] with the GEM objects referenced by the job. that's it, that's the whole vibe 🎀

---

🦋 SYNOPSIS 🦋

int panfrost_lookup_bos (struct drm_device *dev , struct drm_file
*file_priv , struct drm_panfrost_submit *args , struct panfrost_job *job
);

like… copy it exactly, don't come for me about the line breaks, that's how it's printed 💀

---

✨ ARGUMENTS ✨

• dev — the DRM device. main character of the whole DRM situation, honestly 👑
• file_priv — the DRM file for this fd. it's giving "your specific open file's whole personality" 🫶
• args — the IOCTL args. yes, the actual args from the ioctl, lowkey the reason we're all here
• job — the job being set up. this is the one getting its bo[] filled in, slay 💅

---

🔥 DESCRIPTION 🔥

so what does it actually do? it resolves handles from userspace into BOs and attaches them to the job. literally that's the whole job (pun intended, sorry 😭). handles go in, real BOs come out, and they get hooked up to job ✨

🎀 important caveat bestie: this function does not need to unreference the BOs on failure — because that cleanup happens later, at panfrost_job_cleanup time. so like… don't stress about doing it here, it's handled 🙈. no cap.

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/panfrost/panfrost_drv.c — go read the source, iykyk 📖
• panfrost_copy_in_sync(9) — its little sibling, go say hi 🦋

---

and that's the page!! 💖 this one came from ./drivers/gpu/drm/panfrost, version dated October 2026, and it's filed under panfrost_lookup_bos(9) — go off, you now know everything about resolving BOs, periodt ⭐🧚‍♀️