STRUCT DRM_V3D_WAIT_BO(9)

✨ struct drm_v3d_wait_bo(9) ✨

okay so bestie, we're in the Kernel API Manual today and the main character is struct drm_v3d_wait_bo — the ioctl argument for waiting for completion of the last DRM_V3D_SUBMIT_CL on a BO. yes, that's a lot of capital letters, we'll get through it together 🫶

---

🌸 NAME 🌸

struct drm_v3d_wait_bo — the ioctl argument for waiting for completion of the last DRM_V3D_SUBMIT_CL on a BO. literally what it says on the tin 💅

---

🎀 SYNOPSIS 🎀

struct drm_v3d_wait_bo {
    __u32 handle;
    __u32 pad;
    __u64 timeout_ns;
 };

(no cap, that trailing space before the closing brace is in the original and I'm not touching it, we respect the source 😌)

---

🦋 Members 🦋

so the manpage gives this section a heading and then... gives us nothing underneath it, iconic behaviour honestly 🙈 the fields themselves live up in the synopsis: handle, pad, and timeout_ns. that's the whole vibe — no per-member blurbs here, so we're not gonna make any up.

---

💜 Description 💜

okay here's the actual tea: this is useful for cases where multiple processes might be rendering to a BO and you want to wait for all rendering to be completed.

that's it, that's the whole mechanic. several processes, one buffer object, you just want everybody to be done before you do your thing. slay ✨

---

🔥 SEE ALSO 🔥

go read the kernel file ./include/uapi/drm/v3d_drm.h and also these absolute legends:

• struct drm_v3d_multi_sync(9)
• struct drm_v3d_submit_cl(9)
• struct drm_v3d_create_bo(9)
• struct drm_v3d_mmap_bo(9)
• struct drm_v3d_indirect_csd(9)
• struct drm_v3d_timestamp_query(9)
• struct drm_v3d_reset_timestamp_query(9)
• struct drm_v3d_copy_timestamp_query(9)
• struct drm_v3d_reset_performance_query(9)
• struct drm_v3d_copy_performance_query(9)
• struct drm_v3d_perfmon_get_counter(9)
• struct drm_v3d_perfmon_set_global(9)

---

that's the whole page, bestie, you ate that 🍓 this one lives under ./include/uapi/drm and the page is dated October 2026 — mwah, go wait on a BO responsibly 💖🧚