ttm_bo_populate(9)

📦 version 7.3.1, in nixpkgs unstable

✨ ttm_bo_populate(9) ✨

okay bestie, welcome to the Kernel API Manual entry for ttm_bo_populate — this is a 9th-section kernel function page, so grab your strawberry matcha and let's get into it 🍓💅

🌸 NAME 🌸

ttm_bo_populate — make sure a buffer object actually has backing pages, no cap

🦋 SYNOPSIS 🦋

int ttm_bo_populate (struct ttm_buffer_object *bo , struct
ttm_operation_ctx *ctx );

🎀 ARGUMENTS 🎀

  • bo — the buffer object in question, the main character of this whole function 🫶
  • ctx — the ttm_operation_ctx that's governing the operation, aka the vibe check for how this runs

💖 DESCRIPTION 💖

So here's the tea ☕ — for buffer objects that live in a memory type whose manager uses struct ttm_tt for backing pages, this function makes sure those backing pages are present and have valid content. Like, actually there and actually correct. Not fake.

Also, if bo's resource got previously swapped out, it gets placed back onto the correct LRU list. Slay. It's giving "restored to its rightful place" energy 👑

🔥 RETURN 🔥

  • 0 if it worked — we love a successful return 💖
  • a negative error code on failure — 😭

💀 NOTE 💀

Heads up bestie: this can return -EINTR or -ERESTARTSYS if ctx::interruptible is set to true. So like, if you signed up for interruptible behaviour, don't be shocked when the interrupts actually interrupt. Foreshadowing, literally.

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/ttm/ttm_bo.c, plus the whole friend group:

and that's the whole page, bestie 🧚💜 this came from the ./drivers/gpu/drm/ttm source, October 2026 edition — go forth and populate those pages ✨👑

📦 where this page comes from