xe_guc_buf_reserve(9)

💅 xe_guc_buf_reserve 💅

okay bestie, welcome to the Kernel API Manual page for xe_guc_buf_reserve — this one is literally about reserving a new sub-allocation, no cap. ✨

🌸 NAME 🌸

xe_guc_buf_reserve — Reserve a new sub-allocation. 🎀

🦋 SYNOPSIS 🦋

struct xe_guc_buf xe_guc_buf_reserve (struct xe_guc_buf_cache *cache ,
u32 dwords );

🍓 ARGUMENTS 🍓

• cache — the xe_guc_buf_cache where you reserve the sub-allocation. 💖
• dwords — the requested size of the buffer in dwords. 👑

✨ DESCRIPTION ✨

Use xe_guc_buf_is_valid to check if the returned buffer reference is valid. ✅

You must use xe_guc_buf_release to release a sub-allocation — like, don’t just ghost it, bestie. 🫶

🔥 RETURN 🔥

a xe_guc_buf of new sub-allocation. 💅

🌈 SEE ALSO 🌈

The kernel file is ./drivers/gpu/drm/xe/xe_guc_buf.c, and the whole squad is:

• xe_guc_buf_cache_init(9)
• xe_guc_buf_cache_init_with_size(9)
• xe_guc_buf_cache_dwords(9)
• xe_guc_buf_from_data(9)
• xe_guc_buf_release(9)
• xe_guc_buf_sync_read(9)
• xe_guc_buf_flush(9)
• xe_guc_buf_cpu_ptr(9)
• xe_guc_buf_gpu_addr(9)
• xe_guc_cache_gpu_addr_from_ptr(9)

xoxo from the ./drivers/gpu/drm/xe source tree, dated October 2026, on the xe_guc_buf_reserve(9) page 💖✨