ttm_base_obj...okup_for_ref(9)

✨ NAME ✨

ttm_base_object_lookup_for_ref — the little lookup bestie for when your tfile hasn't caught feelings yet 💅

so like, this is a Kernel API Manual page, and the star of the show is ttm_base_object_lookup_for_ref. no cap, that's the whole name section. short and iconic.

---

🌸 SYNOPSIS 🌸

struct ttm_base_object * ttm_base_object_lookup_for_ref (struct
       ttm_object_device *tdev , uint64_t key );

look at her. she returns a struct ttm_base_object * and she takes two args. periodt. 💖

---

💅 ARGUMENTS 💅

• tdev — a pointer to a struct ttm_object_device. literally just a pointer, she's pointing at the device object, that's her whole job 🫶
• key — the hash key 🔑 that's it, that's the argument. we love a simple queen.

---

🎀 DESCRIPTION 🎀

okay so here's the tea ☕ — this function looks up a struct ttm_base_object using the key key. that's it. that's the lookup. slay.

but bestie, listen, there's a condition (iykyk): this function should only be used when the struct tfile associated with the caller doesn't yet have a reference to the base object. so like… no existing ref? then yes, this is your girl. already got a ref? then no, go somewhere else. it's giving "specific use case, know your vibe check" energy ✨

---

🦋 SEE ALSO 🦋

the whole friend group, gathered for you:

• Kernel file ./drivers/gpu/drm/vmwgfx/ttm_object.h
• enum ttm_object_type(9)
• struct ttm_base_object(9)
• struct ttm_prime_object(9)
• ttm_base_object_init(9)
• ttm_base_object_lookup(9)
• ttm_base_object_unref(9)
• ttm_ref_object_base_unref(9)
• ttm_object_file_init(9)
• ttm_object_file_release(9)
• ttm_object_device_release(9)

go read all of them, they're all slay, I promise 🧚‍♀️💜

---

okay that's the whole page!! nothing more, nothing less, every single deet preserved, main character energy intact 👑

mwah 💋 this page is brought to you by the ./drivers/gpu/drm/vmwgfx girls, dated October 2026 — see you in the next ttm_base_obj...okup_for_ref(9) era, bestie!! 🎀🌸🦋