intel_gt_mcr_read(9)

💅 intel_gt_mcr_read(9) — the Kernel API Manual, bestie edition ✨

okay so picture this: you're deep in the i915 driver, you've got an MCR register, and you need one specific copy of it. that's literally this function. it lives in the intel_gt_mcr_read(9) manual page, and yes bb, we're reading it together 🫶

---

✨ NAME ✨

intel_gt_mcr_read — read a specific instance of an MCR register 🌸

---

✨ SYNOPSIS ✨

u32 intel_gt_mcr_read (struct intel_gt *gt , i915_mcr_reg_t reg , int
group , int instance );

look at that signature. u32 coming back at you. iconic behavior honestly 👑

---

✨ ARGUMENTS ✨

• gt — the GT structure ✨ like, the whole graphics tile vibe, that's what you're handing over.
• reg — the MCR register you wanna read 🎀 the actual one. the target.
• group — the MCR group 💫 yes, it's a thing, and you gotta name it.
• instance — the MCR instance 🦋 the specific one inside the group. be precise bestie.

---

✨ CONTEXT ✨

💅 heads up: this function takes and releases gt->mcr_lock. so like, it's handling the lock for you. no cap. you don't gotta do it yourself, but also don't be shocked when the lock gets grabbed — that's just the vibe 😌

---

✨ DESCRIPTION ✨

Returns the value read from an MCR register after steering toward a specific group/instance. like, it points the steering at the group + instance you asked for, reads the register, and hands you back the u32. that's the whole arc. main character energy from start to finish 🔥

---

✨ SEE ALSO ✨

• the kernel file itself: ./drivers/gpu/drm/i915/gt/intel_gt_mcr.c — go read the source, iykyk 💖
• GT Multicast/Replicated (MCR) Register Support(9) — the big picture, the lore 🌈
• intel_gt_mcr_lock(9)
• intel_gt_mcr_unlock(9)
• intel_gt_mcr_lock_sanitize(9)
• intel_gt_mcr_unicast_write(9)
• intel_gt_mcr_multicast_write(9)
• intel_gt_mcr_multicast_write_fw(9)
• intel_gt_mcr_multicast_rmw(9)
• intel_gt_mcr_get_nonterminated_steering(9)
• intel_gt_mcr_read_any_fw(9)
• intel_gt_mcr_read_any(9)
• intel_gt_mcr_get_ss_steering(9)
• intel_gt_mcr_wait_for_reg(9)

that's the whole friend group fr fr 🎀 go say hi to all of them.

---

and that's the page!! this lil gem came out of ./drivers/gpu/drm/i915/gt, dated October 2026 — so mark your calendar, bestie 📅💜 slay, go read some registers responsibly 💅✨