ttm_bo_shrink(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ttm_bo_shrink(9) — the Kernel API Manual, bestie edition 🎀

okay so bestie, welcome to ttm_bo_shrink from the kernel API manual — yes it's a real function, yes it's in the kernel, and yes we're gonna get into it 💖

✨ NAME ✨

ttm_bo_shrink — a lil helper that shrinks a ttm buffer object. that's the whole vibe, no cap 🦋

🌸 SYNOPSIS 🌸

long ttm_bo_shrink (struct ttm_operation_ctx *ctx , struct
ttm_buffer_object *bo , const struct ttm_bo_shrink_flags flags );

like literally just look at that signature, it's giving "i know exactly what i'm doing" 👑

🫶 ARGUMENTS 🫶

  • ctx — the struct ttm_operation_ctx that the shrinking operation rides on. context queen 💅
  • bo — the buffer object. the main character, honestly 🎀
  • flags — flags that govern how the shrinking behaves. it's giving ground rules ✨

🔥 DESCRIPTION 🔥

so here's the tea 🍓: this function uses the ttm_tt_back_up functionality to back up or purge a struct ttm_tt. iconic behaviour, honestly.

and if the bo is not in system, it gets moved there first. like, it literally relocates before doing anything else. respect the process 🙈

⭐ RETURN ⭐

it hands you back the number of pages shrunken or purged — and if things go sideways, a negative error code on failure. not me getting a negative error code 😭

🦋 SEE ALSO 🦋

kernel file ./drivers/gpu/drm/ttm/ttm_bo_util.c, plus the whole friend group:

that's the whole page, bestie, you ate 💜 and fr fr, this one lives at ./drivers/gpu/drm/ttm, dated October 2026, filed under ttm_bo_shrink(9) — slay 🌈👑

📦 where this page comes from