amdgpu_debug...sidency_read(9)

📦 version 7.3.1, in nixpkgs unstable

💅 amdgpu_debugfs_gfxoff_residency_read — read GFXOFF residency (yes bestie, the whole thing)

okay so this little cutie lives in the Kernel API Manual and its full government name is amdgpu_debug...sidency_read(9) — but the actual function is amdgpu_debugfs_gfxoff_residency_read, and she is literally here to hand you a GFXOFF residency sample. slay. 🦋

✨ SYNOPSIS ✨

ssize_t amdgpu_debugfs_gfxoff_residency_read (struct file *f , char
__user *buf , size_t size , loff_t *pos );

that's the whole vibe. one function, four args, returns an ssize_t. no cap. 💜

🎀 ARGUMENTS 🎀

  • f — the open file handle. like, the file you already have open. main character energy.
  • buf — user buffer where the read data gets stored. this is where the data goes to live its best life. 🫶
  • size — number of bytes to read. how much you want, bestie.
  • pos — the offset to seek to. where you're starting from. iykyk.

🌸 DESCRIPTION 🌸

so the way that this works is: it reads a live GFXOFF residency sample from firmware. one sample. live. from firmware. 🔥

⚠️ but listen — one needs to start logging before getting the current value. like, do not come in here expecting a number if you haven't already started logging, because you will simply not get one. periodt. 💅

not me warning you again: start logging first. that's the whole trick. 🙈

🌈 SEE ALSO 🌈

the kernel file herself:

  • ./drivers/gpu/drm/amd/amdgpu/amdgpu_debugfs.c

and her whole friend group, all showing up to the group chat with their (9) in hand 🧚:

and that's the page!! mwah 💋 this icon is brought to you by the fine people at ./drivers/gpu/drm/amd/amdgpu, dated October 2026, living under the <rainbow>Kernel API Manual</rainbow> umbrella. go start that logging bestie 🍓✨

📦 where this page comes from