linux/include/drm/ttm
Thomas Hellström 425a783e1b drm/ttm: Hook up a cgroup-aware reclaim callback for the dmem controller
Add ttm_bo_evict_cgroup() to evict buffer objects charged to a specific
dmem cgroup pool from a resource manager's LRU until a byte target is
met.  Add ttm_resource_manager_set_dmem_region() to associate a dmem
cgroup region with a resource manager; drivers supply their own
dmem_cgroup_ops with ttm_resource_manager_dmem_reclaim as the reclaim
function and the manager pointer as reclaim_priv in the dmem_cgroup_init
to wire up TTM eviction as the reclaim callback.

The eviction context is interruptible; signals abort the operation and
propagate back through the write() syscall.

Introduce a new mode for the bo LRU walker so that sleeping locks
can be taken. This can be used when the caller doesn't hold any
previous dma_resv locks, and where it intends to hold at most
one lock at a time.

Like the rest of the TTM eviction this should sooner than later
be converted to full WW transactions.

v3:
- Fix ttm_resource_manager_set_dmem_region() storing an error pointer
  in man->cg unconditionally. (Sashiko-bot)
- Fix kernel-doc function name format for ttm_bo_evict_cgroup() and
  ttm_resource_manager_set_dmem_region().

v5:
- Rebased on the introduction of struct dmem_cgroup_init.
- Handle NULL region in ttm_resource_manager_set_dmem_region() to clear
  the reclaim callback, preventing use-after-free when the manager is
  torn down while the dmem region outlives it. (Sashiko-bot)
- Return 0 on any progress (even partial eviction), -ENOSPC only when
  nothing was freed; fixes callers that expected 0 on partial success.
- Document that the reclaim callback should return 0 if some progress
  was made, -ENOSPC if no progress at all, or another error for fatal
  failures.

v8:
- Fix ttm_resource_manager_set_dmem_region() using IS_ERR_OR_NULL(),
  which skipped the assignment for a NULL region and thus never
  cleared man->cg. Use IS_ERR() so that a NULL region detaches the
  region as the kernel-doc and the v5 changelog intended. (Sashiko-bot)

v9:
- Don't leak cgroup charges for bos that may have survived dmemcg
  region fini.
- Drop the misleading "Capture size before eviction in case res is
  cleared" comment in ttm_bo_evict_cb(). (Maarten Lankhorst)

Assisted-by: GitHub_Copilot:claude-sonnet-4.6
Signed-off-by: Thomas Hellström <thomas.hellstrom@linux.intel.com>
Reviewed-by: Maarten Lankhorst <maarten.lankhorst@linux.intel.com> #v7
Tested-by: Thadeu Lima de Souza Cascardo <cascardo@igalia.com>
Link: https://patch.msgid.link/20260725100036.2372-5-thomas.hellstrom@linux.intel.com
Signed-off-by: Maarten Lankhorst <dev@lankhorst.se>
2026-08-06 23:38:04 +02:00
..
ttm_allocation.h drm/ttm: Add an allocation flag to propagate -ENOSPC on OOM 2025-10-31 09:27:28 +00:00
ttm_backup.h drm/ttm: Avoid invoking the OOM killer when reading back swapped content 2026-03-20 10:38:10 +01:00
ttm_bo.h drm/ttm: Hook up a cgroup-aware reclaim callback for the dmem controller 2026-08-06 23:38:04 +02:00
ttm_caching.h drm/ttm: make ttm_caching.h self-contained 2024-03-11 11:47:06 +02:00
ttm_device.h drm/ttm: Fix @alloc_flags description 2025-11-06 10:35:47 +00:00
ttm_execbuf_util.h drm/ttm: fix ttm_execbuf_util.h kernel-doc warnings 2024-03-11 11:47:06 +02:00
ttm_kmap_iter.h drm/ttm: fix ttm_kmap_iter.h kernel-doc warnings 2024-03-11 11:47:06 +02:00
ttm_placement.h drm/ttm: Support 52-bit PAs in ttm_place 2026-05-13 20:14:24 +05:30
ttm_pool.h ttm/pool: port to list_lru. (v2) 2026-04-08 06:52:47 +10:00
ttm_range_manager.h drm/ttm: Try to check if new ttm man out of bounds during compile 2021-09-13 10:14:28 +02:00
ttm_resource.h drm/ttm: Hook up a cgroup-aware reclaim callback for the dmem controller 2026-08-06 23:38:04 +02:00
ttm_tt.h drm/ttm: Remove the struct ttm_backup abstraction 2025-05-06 10:57:27 +02:00