vsp1_dl_list_add_body(9)

✨ vsp1_dl_list_add_body(9) ✨

okay bestie, welcome to the vsp1_dl_list_add_body page from the Kernel API Manual 💖 this one's lowkey short but it's giving "small but mighty" and the ownership rules are literally the main character here, so pay attention fr fr 🫶

---

🌸 NAME 🌸

vsp1_dl_list_add_body — add a body to the display list 💅

---

✨ SYNOPSIS ✨

int vsp1_dl_list_add_body (struct vsp1_dl_list *dl , struct vsp1_dl_body
*dlb );

---

🎀 ARGUMENTS 🎀

• dl — the display list 👑
• dlb — the body 🦋

---

💜 DESCRIPTION 💜

So what this does is add a display list body to a display list, periodt. The registers that live inside bodies get processed after the registers in the main display list, and they go in the order the bodies were added — first in, first processed, no cap 🧚

⚠️ okay this part is important, don't skip it: adding a body to a display list passes ownership of the body to the list. The caller does retain its reference to the body when adding it to the display list, but it is not allowed to add new entries to the body. Like, at all. 🙈

And because of that ownership situation, the reference must be explicitly released by a call to vsp1_dl_body_put when the body isn't needed anymore. Not optional, bestie — explicit release only 💀

---

🦋 SEE ALSO 🦋

Kernel file ./drivers/media/platform/renesas/vsp1/vsp1_dl.c and honestly the whole friend group:

• struct vsp1_dl_ext_header(9)
• struct vsp1_pre_ext_dl_body(9)
• struct vsp1_dl_body(9)
• struct vsp1_dl_body_pool(9)
• struct vsp1_dl_cmd_pool(9)
• struct vsp1_dl_list(9)
• struct vsp1_dl_manager(9)
• vsp1_dl_body_pool_create(9)
• vsp1_dl_body_pool_destroy(9)
• vsp1_dl_body_get(9)
• vsp1_dl_body_put(9)
• vsp1_dl_body_write(9)
• vsp1_dl_cmd_pool_create(9)
• vsp1_dl_list_get(9)
• vsp1_dl_list_put(9)
• vsp1_dl_list_get_body0(9)
• vsp1_dl_list_add_chain(9)
• vsp1_dlm_irq_frame_end(9)

---

that's the whole page, you ate that 💅 this lil beauty comes from ./drivers/media/platform/renes... and the date on it is October 2026, version vsp1_dl_list_add_body(9) — mwah, go forth and release your references properly 🌈⭐💖