xe_bo_is_purged(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… xe_bo_is_purged β€” check if a buffer object has been purged ✨

okay so this one is from the Kernel API Manual (kernel docs, we love her), and it's about asking one very important question: has this buffer object been purged? 🫢


🌸 NAME 🌸

xe_bo_is_purged β€” check if a buffer object has been purged πŸ’–


✨ SYNOPSIS ✨

bool xe_bo_is_purged (struct xe_bo *bo );

πŸŽ€ ARGUMENTS πŸŽ€

  • bo β€” the buffer object you're checking, bestie. that's the one.

πŸ¦‹ DESCRIPTION πŸ¦‹

so this function checks whether the buffer object's backing store has been discarded by the kernel because of memory pressure β€” and this only happens after the BO was marked as purgeable (DONTNEED). πŸ’€

⚠️ once it's purged, the BO cannot be restored, and any attempt to use it will fail. no cap, it's gone gone. 😭

πŸ’… CONTEXT πŸ’…

the caller must hold the BO's dma-resv lock. like, that's not optional, that's the vibe check. πŸ”’


⭐ RETURN ⭐

  • true if the BO has been purged πŸ‘‘
  • false otherwise 🌈

πŸ”₯ SEE ALSO πŸ”₯

Kernel file ./drivers/gpu/drm/xe/xe_bo.h enum


that's the whole page, icon, go check your BOs πŸ§šπŸ’œ

this lil gem lives at ./drivers/gpu/drm/xe, dated October 2026 β€” shoutout to the kernel api manual for keeping it cute βœ¨πŸ“

πŸ“¦ where this page comes from