v3d_lookup_bos(9)

💖 NAME 💖

okay bestie, welcome to v3d_lookup_bos(9) from the Kernel API Manual 🎀 — this one sets up job->bo[] with the GEM objects referenced by the job. That's the whole name-section tea. ✨

✨ SYNOPSIS ✨

the signature is literally this, no cap:

int v3d_lookup_bos (struct drm_file *file_priv , struct v3d_job *job ,
       u64 bo_handles , u32 bo_count );

🎀 ARGUMENTS 🎀

• file_priv — DRM file for this fd 💅
• job — V3D job being set up 🛠️
• bo_handles — GEM handles ✨
• bo_count — Number of GEM handles passed in 🔢

🦋 DESCRIPTION 🦋

The command validator needs to reference BOs by their index within the submitted job's BO list. This does the validation of the job's BO list and reference counting for the lifetime of the job. So like, it's giving “keep the BO list valid and keep the refs alive for the job's whole era” 👑.

Note that this function doesn't need to unreference the BOs on failure, because that will happen at v3d_job_free. So bestie, the failure cleanup for the BO unreference is not this function's job — v3d_job_free is gonna handle it 🫶.

🌈 SEE ALSO 🌈

go read these next, iykyk:

• Kernel file ./drivers/gpu/drm/v3d/v3d_submit.c
• v3d_job_reference_bos(9)
• v3d_submit_cl_ioctl(9)
• v3d_submit_tfu_ioctl(9)
• v3d_submit_csd_ioctl(9)
• v3d_submit_cpu_ioctl(9)

mwah 💋 this page's source is ./drivers/gpu/drm/v3d, its page/version is v3d_lookup_bos(9), and it's dated October 2026 — byeee, go slay your BO lookups 🦋💖