host1x_bo_unpin(9)

✨ host1x_bo_unpin(9) ✨

okay so bestie, welcome to the Kernel API Manual 🫶 — this one's a little function with big "clean up after yourself" energy.

---

💅 NAME

host1x_bo_unpin — release an established DMA mapping of a buffer object. literally the undo button for a pin 🎀

---

🌸 SYNOPSIS

void host1x_bo_unpin (struct host1x_bo_mapping *mapping );

no return value, no drama. it's void, it just does the thing ✨

---

🦋 ARGUMENTS

• mapping — the mapping to release. that's it, that's the whole vibe. hand it over and let it go 🫶

---

🎀 DESCRIPTION

so what actually happens 👀 — it unmaps the given mapping, unless it's cached. cached ones get to stay cozy, no cap. (lowkey important detail, don't forget it 💀)

then it decreases the refcount on the underlying buffer object. one less thing holding on, we love a clean exit 💖

not me stressing the "unless it is cached" part — if your mapping is cached, bestie, it is NOT getting unmapped here. periodt.

---

🔥 SEE ALSO

kernel file ./drivers/gpu/host1x/bus.c — and the whole friend group:

• host1x_subdev_add(9)
• host1x_subdev_del(9)
• host1x_device_parse_dt(9)
• host1x_device_init(9)
• host1x_device_exit(9)
• host1x_register(9)
• host1x_unregister(9)
• host1x_driver_register_full(9)
• host1x_driver_unregister(9)
• __host1x_client_init(9)
• host1x_client_exit(9)
• __host1x_client_register(9)
• host1x_client_unregister(9)
• host1x_bo_pin(9)
• host1x_bo_clear_cached_mappings(9)

(yes host1x_bo_pin(9) is right there — the pin/unpin duo, iconic pairing 👑)

---

and that's the whole page, bestie 🌈 this lil gem lives in ./drivers/gpu/host1x, dropped October 2026, and it's filed under host1x_bo_unpin(9) — go unpin something responsibly 💜✨