calculate_fr...pages_locked(9)

✨ NAME ✨

okay so bestie, welcome to the Kernel API Manual, section 9 🎀 — this is calculate_free_list_ready_pages_locked, and honestly? her whole job is iconic: she works out how many free list pages you need to reserve for growing within the FW so you never have to sit around waiting for the host to progress a grow request 😭 no cap, she's the reason you don't stall.

---

🌸 SYNOPSIS 🌸

u32 calculate_free_list_ready_pages_locked (struct pvr_free_list
*free_list , u32 pages );

---

🦋 ARGUMENTS 🦋

• free_list — a pointer to the free list, periodt. That's the one, that's the girl 💅
• pages — the total pages currently chillin' in the free list.

---

💜 DESCRIPTION 💜

so here's the tea ☕ — if the threshold or the grow size means less than the alignment size, then the feature is just... not used 🙈. And ngl, the alignment size is 4 pages on Rogue, so keep that number in your head bestie, it matters ✨

🚨 LOCKING VIBE CHECK 🚨 — the caller must hold free_list->lock. Like, literally must. Don't come for her without the lock, fr fr 🔥

---

⭐ RETURN ⭐

the number of pages to reserve 🫶 that's it, that's the whole answer, slay.

---

🌈 SEE ALSO 🌈

• the kernel file itself, main character energy: ./drivers/gpu/drm/imagination/pvr_free_list.c
• pvr_get_free_list_min_pages(9)
• pvr_free_list_create(9)
• pvr_destroy_free_lists_for_file(9)
• pvr_free_list_put(9)

go read them, iykyk 👑

---

mwah 💋 this page lives in ./drivers/gpu/drm/imagination, dated October 2026 — catch you in the next section of the Kernel API Manual, love u, bye 🧚💖