ttm_bo_get_unless_zero(9)

💖 ttm_bo_get_unless_zero(9) 💖

ok so bestie, welcome to the <pink>Kernel API Manual</pink> ✨ — this is ttm_bo_get_unless_zero, and it's lowkey one of those tiny functions that saves your whole entire life. let's get into it 🫶

---

🌸 NAME 🌸

ttm_bo_get_unless_zero — grab a reference to a struct ttm_buffer_object, but only if its refcount hasn't already hit zero. no cap, that "unless zero" part is the whole personality 💅

---

🦋 SYNOPSIS 🦋

struct ttm_buffer_object * ttm_bo_get_unless_zero (struct
ttm_buffer_object *bo );

---

🎀 ARGUMENTS 🎀

• bo — the buffer object. that's it. that's the whole argument list. she's simple, she's iconic 👑

---

🔥 DESCRIPTION 🔥

so here's the vibe check ✨ — you use this when you're doing lookups and you need to take a reference to a TTM buffer object, but with a little safety net. specifically:

• it's for lookups where the object gets removed from the lookup structure during the destructor, and
• it's for RCU lookups 👀

basically, if the refcount has already reached zero, don't touch it — that's the whole point. this function's got your back, fr fr 😭💜

---

⭐ RETURN ⭐

• bo — if the referencing was successful 💖
• NULL — otherwise 🙈

yes bestie, it can literally just hand you NULL. check for it. i'm serious. 🫶

---

🌈 SEE ALSO 🌈

• ttm_bo_get(9)
• Kernel file ./drivers/gpu/drm/ttm/ttm_bo_internal.h

---

ok that's the whole page, no notes 💅

./drivers/gpu/drm/ttm 🌸 October 2026 🌸 ttm_bo_get_unless_zero(9)

mwah, that's a wrap — go reference responsibly, bestie 🧚💖✨