get_dma_buf_unless_doomed(9)

💖 get_dma_buf_unless_doomed(9) 💖

okay so this is the Kernel API Manual page for get_dma_buf_unless_doomed(9), and it's giving very specific kernel-internals energy. buckle up, bestie 🫶

🌸 NAME 🌸

• get_dma_buf_unless_doomed — get a dma_buf reference if possible. that's the whole vibe. ✨

✨ SYNOPSIS ✨

bool get_dma_buf_unless_doomed (struct dma_buf *dmabuf );

🎀 ARGUMENTS 🎀

• dmabuf — a non-refcounted pointer to a struct dma-buf. yes, non-refcounted. don't come for me, that's literally what it says 💅

💅 DESCRIPTION 💅

okay so the actual mechanics: obtain a file reference from a lookup structure that doesn't refcount the file, but synchronizes with its release method to make sure it has not been freed yet. see for example kref_get_unless_zero documentation. it returns true if refcounting succeeds, false otherwise. it's giving iconic behavior, no cap 🔥

and the tea: nobody really wants this as a public API yet, so let it mature here for some time... 💀 it's lowkey in its quiet era. let it cook. 🍓

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/vmwgfx/ttm_object.c — struct ttm_object_file(9)
• ttm_prime_refcount_release(9)
• ttm_prime_dmabuf_release(9)
• ttm_prime_fd_to_handle(9)
• ttm_prime_handle_to_fd(9)
• ttm_prime_object_init(9)

go read those if you're deep in the vmwgfx lore, iykyk 👑

xoxo, your kernel bestie 💖 — source/version: ./drivers/gpu/drm/vmwgfx; date: October 2026.