ttm_pool_alloc(9)

💖 ttm_pool_alloc(9) 💖

okay so bestie, welcome to the ttm_pool_alloc page from the Kernel API Manual — yes, the manual name is literally "Kernel API Manual", we're in the big leagues now 🎀

---

✨ NAME ✨

ttm_pool_alloc — fill a ttm_tt object 🫶

---

🌸 SYNOPSIS 🌸

int ttm_pool_alloc (struct ttm_pool *pool , struct ttm_tt *tt , struct
ttm_operation_ctx *ctx );

like, that's the whole vibe: you give it three things, it hands you back an int. iconic signature honestly 💅

---

🦋 ARGUMENTS 🦋

• pool — the ttm_pool you're gonna use. this is the main character of the operation tbh 👑
• tt — the ttm_tt object you're filling up. she's getting stuffed with pages, no cap 😭
• ctx — the operation context. your little sidecar of context for the call ✨

---

💫 DESCRIPTION 💫

so what does it actually do? it fills the ttm_tt object with pages — like, actual pages, going in — and it also makes sure to DMA map them when that's necessary. that's it, that's the whole job. not me thinking that's kind of a lot of work for one function 😮‍💨 but she ate, fr fr 🔥

---

🌈 RETURN 🌈

0 on successe, negative error code otherwise.

ok so yes, the source literally says "successe" — we're not fixing it, we're respecting the original author's journey 🙈💀 but to be clear: 0 = good vibes, a negative error code = something went sideways. periodt.

---

🎀 SEE ALSO 🎀

Kernel file ./drivers/gpu/drm/ttm/ttm_pool.c, plus the whole friend group:

• struct ttm_pool_dma(9)
• struct ttm_pool_alloc_state(9)
• struct ttm_pool_tt_restore(9)
• Partial backup and restoration of a struct ttm_tt.(9)
• ttm_pool_free_range(9)
• ttm_pool_restore_and_alloc(9)
• ttm_pool_free(9)
• ttm_pool_drop_backed_up(9)
• ttm_pool_backup(9)
• ttm_pool_init(9)
• ttm_pool_synchronize_shrinkers(9)
• ttm_pool_fini(9)
• ttm_pool_debugfs(9)
• ttm_pool_mgr_init(9)
• ttm_pool_mgr_fini(9)

---

and that's the page!! 🧚‍♀️ sourced straight from ./drivers/gpu/drm/ttm, dated October 2026, and filed under ttm_pool_alloc(9) — go forth and fill those ttm_tt objects bestie, you've got this 💜🍓⭐