i915_syncmap_free(9)

💖 i915_syncmap_free(9) 💖

okay so bestie, welcome to the Kernel API Manual — yes we're reading kernel docs together, this is our bonding era 🫶

---

✨ NAME ✨

i915_syncmap_free — literally frees all the memory associated with the syncmap. all of it. every last byte. bye 💅

---

🌸 SYNOPSIS 🌸

void i915_syncmap_free (struct i915_syncmap **root );

like… that's the whole function signature. short, sweet, iconic 👑

---

🎀 ARGUMENTS 🎀

• root — a pointer to the #i915_syncmap. yes it's a double pointer, no we're not scared of it, we're built different 💪

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie ☕ there are exactly two moods where you'd call this:

1. the timeline is about to be freed and we genuinely no longer need the sync point tracking anymore, or
2. the fences are all known to be signaled and the sync point tracking is just redundant at this point (it's giving extra)

either way? you can free the #i915_syncmap to recover its allocations. slay, memory reclaimed ✨

and the part you cannot skip: it will reinitialise the root pointer so that the #i915_syncmap is ready for reuse 🔁 like it doesn't just leave you hanging — it resets things so you can go again. main character energy fr fr

---

💀 SEE ALSO 💀

• Kernel file ./drivers/gpu/drm/i915/i915_syncmap.c
• i915_syncmap_init(9)
• i915_syncmap_is_later(9)
• i915_syncmap_set(9)

iykyk — go read the whole friend group 🌈

---

and that's the page!! 💜 this lil masterpiece lives in ./drivers/gpu/drm/i915, dated October 2026 — no cap, see you in the future bestie 🧚⭐🎀