ttm_pool_backup(9)

🎀 NAME 🎀

okay so bestie, this page is ttm_pool_backup(9) from the Kernel API Manual, and it is literally about backing up or purging a struct ttm_tt 💖.

• ttm_pool_backup — back up or purge a struct ttm_tt.

---

✨ SYNOPSIS ✨

long ttm_pool_backup (struct ttm_pool *pool , struct ttm_tt *tt , const
struct ttm_backup_flags *flags );

---

🫶 ARGUMENTS 🫶

• pool — the pool used when allocating the struct ttm_tt.
• tt — the struct ttm_tt.
• flags — flags to govern the backup behaviour.

---

💅 DESCRIPTION 💅

Back up or purge a struct ttm_tt. No cap, that’s the whole vibe.

If purge is true, then all pages will be freed directly to the system rather than to the pool they were allocated from, making the function behave similarly to ttm_pool_free. If purge is false, the pages will be backed up instead, exchanged for handles ✨. A subsequent call to ttm_pool_restore_and_alloc will then read back the content, and a subsequent call to ttm_pool_drop_backed_up will drop it.

If backup of a page fails for whatever reason, ttm will still be partially backed up, retaining those pages for which backup fails. In that case, this function can be retried, possibly after freeing up memory resources. That part is important, bestie 🫶.

---

🌈 RETURN 🌈

Returns the number of pages actually backed up or freed, or a negative error code on error.

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/ttm/ttm_pool.c
• 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_alloc(9)
• ttm_pool_restore_and_alloc(9)
• ttm_pool_free(9)
• ttm_pool_drop_backed_up(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)

---

mwah 💋 this lil page came from source/version ./drivers/gpu/drm/ttm, dated October 2026, and it’s ttm_pool_backup(9) — bye bestie! 🫶✨