VF2GUC_MATCH_VERSION(9)

💅 VF2GUC_MATCH_VERSION 💅

okay bestie, welcome to a section 9 man page — this is the Kernel API Manual, so it's giving kernel-devs-only, but like… we can absolutely make it slay. ✨

---

🦋 DESCRIPTION 🦋

so this action is literally the vibe-check for version numbers: it's used to match the VF interface version used by VF and GuC. like, "hey, are we on the same page or not" energy. 💖

⚠️ heads up: this message must be sent as MMIO HXG Message. no cap, that part is not optional.

---

🎀 REQUEST MESSAGE 🎀

word 0 📨

• bits 31 — ORIGIN = GUC_HXG_ORIGIN_HOST_
• bits 30:28 — TYPE = GUC_HXG_TYPE_REQUEST_
• bits 27:16 — DATA0 = MBZ
• bits 15:0 — ACTION = GUC_ACTION_VF2GUC_MATCH_VERSION = 0x5500

word 1 📨

• bits 31:24 — BRANCH — branch ID of the VF interface (use BRANCH_ANY to request latest version supported by GuC)
• bits 23:16 — MAJOR — major version of the VF interface (use MAJOR_ANY to request latest version supported by GuC)
• bits 15:8 — MINOR — minor version of the VF interface (use MINOR_ANY to request latest version supported by GuC)
• bits 7:0 — MBZ

---

🌸 RESPONSE MESSAGE 🌸

word 0 💌

• bits 31 — ORIGIN = GUC_HXG_ORIGIN_GUC_
• bits 30:28 — TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_
• bits 27:0 — DATA0 = MBZ

word 1 💌

• bits 31:24 — BRANCH — branch ID of the VF interface
• bits 23:16 — MAJOR — major version of the VF interface
• bits 15:8 — MINOR — minor version of the VF interface
• bits 7:0 — PATCH — patch version of the VF interface 👑

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/xe/abi/guc_actions_sriov_abi.h
• GUC2PF_RELAY_FROM_VF(9)
• PF2GUC_RELAY_TO_VF(9)
• GUC2VF_RELAY_FROM_PF(9)
• VF2GUC_RELAY_TO_PF(9)
• GUC2PF_ADVERSE_EVENT(9)
• GUC2PF_VF_STATE_NOTIFY(9)
• PF2GUC_UPDATE_VGT_POLICY(9)
• PF2GUC_UPDATE_VF_CFG(9)
• PF2GUC_VF_CONTROL(9)
• VF2GUC_VF_RESET(9)
• VF2GUC_RESFIX_DONE(9)
• VF2GUC_QUERY_SINGLE_KLV(9)
• PF2GUC_SAVE_RESTORE_VF(9)
• VF2GUC_RESFIX_START(9)

---

and that's the whole page, bestie — go read those SEE ALSOs, they're all in the same friend group fr fr 🫶

this masterpiece lives in ./drivers/gpu/drm/xe/abi, dated October 2026, and yes it ate. periodt. 💅✨