i915_gem_obj...to_wc_domain(9)

💅 i915_gem_obj...to_wc_domain(9) 💅

okay so bestie, welcome to the Kernel API Manual 🎀 (yes, that's the manual name, it's giving very "the docs are the main character energy"). today we're learning about one very specific little function and honestly? she's iconic, she's niche, she does exactly one thing and she does it well. ✨

---

🌸 NAME 🌸

i915_gem_object_set_to_wc_domain — moves a single object to the WC read, and possibly write domain.

like. one object. one domain. no cap, that's the whole vibe. 💫

---

🦋 SYNOPSIS 🦋

int i915_gem_object_set_to_wc_domain (struct drm_i915_gem_object *obj ,
bool write );

she takes a struct drm_i915_gem_object *obj and a bool write, and she returns an int. that's her whole signature. slay. 💅

---

🎀 ARGUMENTS 🎀

• obj — the object we're acting on 🫶 like, this is the actual thing being moved. the star of the show.
• write — are we asking for write access, or is this a read-only situation? 🔥 you literally just tell her which one.

---

⭐ DESCRIPTION ⭐

so here's the tea ☕: this function returns when the move is complete, and that includes waiting on flushes to occur. 😭

translation? she does not come back early. she does not do "eh, close enough." she waits. she flushes. she returns. periodt. 💀✨

---

👑 SEE ALSO 👑

• the kernel file ./drivers/gpu/drm/i915/gem/i915_gem_domain.c — go read the source, iykyk 🧚
• i915_gem_object_set_to_gtt_domain(9)
• i915_gem_object_set_cache_level(9)
• i915_gem_object_set_to_cpu_domain(9)
• i915_gem_set_domain_ioctl(9)

her whole friend group fr fr 🌈 all the domain-setting besties, linked up together.

---

🫶 friendly reminder: this page is specifically about the WC read (and maybe write) domain move. if you're looking for a different domain, check the SEE ALSO list above before you come for her.

---

okay that's the whole page, bestie, you ate that 💖 now go forth and set some domains. this little gem lives over in ./drivers/gpu/drm/i915/gem and the docs are dated October 2026 — so like, future vibes only. 🌸🦋⭐ see you in the next manpage!! 🎀💜