GUC2PF_VF_STATE_NOTIFY(9)

💖 GUC2PF_VF_STATE_NOTIFY(9) 💖

okay so this page is from the Kernel API Manual, and it's literally all about the GUC2PF_VF_STATE_NOTIFY message. No cap, the GuC uses it to notify PF about change of the VF state. 💅

🦋 DESCRIPTION 🦋

The GUC2PF_VF_STATE_NOTIFY message is used by the GuC to notify PF about change of the VF state.

This G2H message is sent as a CTB HXG Message. Periodt. ✨

The bits/description situation is giving:

• 0 / bit 31 — ORIGIN = GUC_HXG_ORIGIN_GUC_
• 0 / bits 30:28 — TYPE = GUC_HXG_TYPE_EVENT_
• 0 / bits 27:16 — DATA0 = MBZ
• 0 / bits 15:0 — ACTION = GUC_ACTION_GUC2PF_VF_STATE_NOTIFY = 0x5106

Then the payload bestie:

• 1 / bits 31:0 — DATA1 = VFID - VF identifier
• 2 / bits 31:0 — DATA2 = EVENT - notification event:
  • GUC_PF_NOTIFY_VF_ENABLE = 1 (only if VFID = 0)
  • GUC_PF_NOTIFY_VF_FLR = 1
  • GUC_PF_NOTIFY_VF_FLR_DONE = 2
  • GUC_PF_NOTIFY_VF_PAUSE_DONE = 3
  • GUC_PF_NOTIFY_VF_FIXUP_DONE = 4

👀 SEE ALSO 👀

Spilling the tea on the related pages:

• 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), VF2GUC_MATCH_VERSION(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)

mwah 💋 source/version is ./drivers/gpu/drm/xe/abi, dated October 2026, and this icon is GUC2PF_VF_STATE_NOTIFY(9) — bye bestie 🫶