panthor_heap_grow(9)

💅 panthor_heap_grow(9) — like, the Kernel API Manual page, bestie 🎀

okay so real talk, this is a page from the Kernel API Manual and it's all about panthor_heap_grow — the little function whose whole entire job is to make a heap context grow. that's it. that's the vibe. main character energy fr fr ✨

---

🌸 NAME 🌸

panthor_heap_grow — Make a heap context grow.

like literally the name says it. we're growing a heap context. slay 💅

---

✨ SYNOPSIS ✨

int panthor_heap_grow (struct panthor_heap_pool *pool , u64 heap_gpu_va
, u32 renderpasses_in_flight , u32 pending_frag_count , u64
*new_chunk_gpu_va );

no cap, that's the whole signature. it returns an int and takes five things. we'll get into each one, don't worry 🫶

---

🦋 ARGUMENTS 🦋

okay bestie, here's the cast of characters, and each one matters:

• pool — The pool this heap belongs to. it's giving "your heap's home base," iykyk 🏠
• heap_gpu_va — The GPU address of the heap context. that's the u64 address situation, very GPU, very address ✨
• renderpasses_in_flight — Number of render passes currently in-flight. like, how many are literally airborne right now 🛫
• pending_frag_count — Number of fragment jobs waiting for execution/completion. they're in the queue, being patient, we love them for it 😭
• new_chunk_gpu_va — Pointer used to return the chunk VA. it's an out-param, so it hands the chunk VA back to you 🎁

---

🔥 RETURN 🔥

the return values, and yes we're listing all three because facts are facts:

• 0 if a new heap was allocated — a win, we ate, no crumbs 👑
• -ENOMEM if the tiler context reached the maximum number of chunks or if too many render passes are in-flight or if the allocation failed — yeah that's three separate ways to hit it, all one error code, that's just how it is 💀
• -EINVAL if any of the arguments passed to panthor_heap_grow is invalid — bad input, invalid vibes, blocked 🙈

---

🌈 SEE ALSO 🌈

here's the whole friend group, all of them, in order, no one left behind:

• Kernel file ./drivers/gpu/drm/panthor/panthor_heap.c struct
• panthor_heap_chunk_header(9)
• struct panthor_heap_chunk(9)
• struct panthor_heap(9)
• struct panthor_heap_pool(9)
• panthor_heap_destroy(9)
• panthor_heap_create(9)
• panthor_heap_return_chunk(9)
• panthor_heap_pool_put(9)
• panthor_heap_pool_get(9)
• panthor_heap_pool_create(9)
• panthor_heap_pool_destroy(9)
• panthor_heap_pool_size(9)

---

bestie reminder: -ENOMEM shows up for three whole reasons (max chunks reached, too many render passes in-flight, or the allocation straight-up failing) — don't forget any of them, okay? 💖

---

and that's the page!! source lives at ./drivers/gpu/drm/panthor, dated October 2026, and it's the panthor_heap_grow(9) page 🦋✨ mwah, go grow that heap, ily 🫶💜