ttm_bo_swapout(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ttm_bo_swapout(9) — like, the whole page, bestie

okay so real talk: this is a page from the Kernel API Manual (yes, the kernel has a manual, she's iconic) and today's main character is ttm_bo_swapout. grab a strawberry drink 🍓 and let's get into it.

✨ NAME ✨

ttm_bo_swapout — swaps out buffer objects chilling on the LRU list, over to shmem. that's the whole vibe. no cap. 🦋

🌸 SYNOPSIS 🌸

s64 ttm_bo_swapout (struct ttm_device *bdev , struct ttm_operation_ctx
*ctx , struct ttm_resource_manager *man , gfp_t gfp_flags , s64 target
);

she returns an s64, she takes five args, she's booked and busy 💅

🎀 ARGUMENTS 🎀

okay so the five besties she needs:

  • bdev — the ttm device. like, THE device. the one and only 👑
  • ctx — the ttm_operation_ctx that governs the whole swapout operation. she's in charge, respectfully 🫶
  • man — the resource manager whose resources / buffer objects are goint to be swapped out. yes, that's a typo up in the original and we're keeping it, it's canon now 😭
  • gfp_flags — the gfp flags used for shmem page allocations. allocation mood ring, basically 🌈
  • target — the desired number of pages to swap out. desired!! as in a wish, a dream, a goal ✨

🔥 RETURN 🔥

she gives you back the number of pages actually swapped out — key word actually, the dream and the reality are not always the same — or a negative error code on error. so if it's negative, something went off, bestie 💀

🧚 SEE ALSO 🧚

literally the whole friend group. kernel file: ./drivers/gpu/drm/ttm/ttm_bo.c

ngl go read ttm_bo_evict_first(9) right after this one, they're giving sibling energy 👀

and that's the page!! mwah 💖 this one came straight out of ./drivers/gpu/drm/ttm, dated October 2026 — so yeah, future knowledge, we stay ahead of the timeline ⭐ periodt.

📦 where this page comes from