xe_guc_log_snapshot_capture(9)

📦 version 7.3.1, in nixpkgs unstable

💖 xe_guc_log_snapshot_capture — Kernel API Manual (9) 💖

okay so bestie, welcome to the xe_guc_log_snapshot_capture page 💅 this is a kernel API manual, and we're about to make a whole copy of the GuC log so you can dump it later. yes, it's giving "screenshot before the crash" energy and honestly? obsessed 🫶

✨ NAME ✨

xe_guc_log_snapshot_capture — create a new snapshot copy of the GuC log for later dumping 🌸

like, it snatches a copy of the log right now and holds onto it, so you can print it out at your own pace later. main character energy fr fr 👑

🎀 SYNOPSIS 🎀

struct xe_guc_log_snapshot * xe_guc_log_snapshot_capture (struct xe_guc_log *log , bool atomic );

that's the whole signature, no cap — it takes a struct xe_guc_log *log and a bool atomic, and hands you back a struct xe_guc_log_snapshot * ✨

🦋 ARGUMENTS 🦋

  • log — the GuC log structure 💖 this is the log you're snapshotting, the whole reason we're here.
  • atomic — is the call inside an atomic section of some kind? 🤔 like, are you in atomic context right now? answer honestly, bestie.

🌈 RETURN 🌈

it returns a pointer to a newly allocated snapshot object 🎀 — or null if we're out of memory 😭 (yes, NULL is a real possibility, don't @ me).

⚠️ heads up, gorgeous: the caller is responsible for calling xe_guc_log_snapshot_free when done with the snapshot. it's literally yours to clean up. don't leave it hanging, that's not the vibe 💀

🧚 SEE ALSO 🧚

and that's the page, bestie 💜 that's a wrap from ./drivers/gpu/drm/xe, dated October 2026, xe_guc_log_snapshot_capture(9) — go forth, snapshot responsibly, and free your snapshots 🌸🎀👑

📦 where this page comes from