ttm_bo_pin(9)
π ttm_bo_pin β the ttm_bo_pin(9) glow-up π
okay so bestie, welcome to the Kernel API Manual entry for ttm_bo_pin(9) β yes it's a 9 section page, yes it's about buffer objects, no you're not dreaming β¨
πΈ NAME πΈ
ttm_bo_pin β the one where you pin the buffer object π like literally just grab it and say "you're staying right here, bestie" π
β SYNOPSIS β
void ttm_bo_pin (struct ttm_buffer_object *bo );
no return value, no drama β it's void, it does the thing, it dips π
π¦ ARGUMENTS π¦
boβ the buffer object you're pinning π the actual star of the show, the main character, the one getting locked down π«Ά
β¨ DESCRIPTION β¨
okay so here's the tea β β ttm_bo_pin makes sure the buffer is not evicted any more during memory pressure. like, the system's stressed, memory's tight, everything's fighting for space, and your buffer is just sitting there unbothered because it's pinned π
iconic behaviour honestly π
β οΈ but bestie listen βbomust be unpinned again by callingttm_bo_unpin. that's not optional, that's not a vibe, that's a requirement π don't leave it pinned forever, that's how you get leaks and everyone's sad π
π SEE ALSO π
the whole friend group, fr fr β kernel file ./drivers/gpu/drm/ttm/ttm_bo.c and honestly the entire ttm_bo squad π:
ttm_bo_move_to_lru_tail(9)ttm_bo_set_bulk_move(9)ttm_bo_eviction_valuable(9)ttm_bo_evict_first(9)ttm_bo_alloc_at_place(9)struct ttm_bo_evict_walk(9)ttm_bo_evict_cgroup(9)ttm_bo_unpin(9)β the one you literally have to call, do not forget her π«Άttm_bo_alloc_resource(9)ttm_bo_validate(9)ttm_bo_init_reserved(9)ttm_bo_init_validate(9)ttm_bo_unmap_virtual(9)ttm_bo_wait_ctx(9)struct ttm_bo_swapout_walk(9)ttm_bo_swapout(9)ttm_bo_populate(9)
and that's the whole page bestie, go pin responsibly π
kisses from ./drivers/gpu/drm/ttm, dated October 2026, page ttm_bo_pin(9) β see you in the group chat π§ββοΈ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms