PF2GUC_VF_CONTROL(9)

💅 PF2GUC_VF_CONTROL 💅

okay bestie, welcome to the Kernel API Manual — this page is literally PF2GUC_VF_CONTROL(9), and the PF2GUC_VF_CONTROL message is used by the PF to trigger VF state change maintained by the GuC. No cap 🫶

this is an H2G message, so it must be sent as a CTB HXG Message. the vibe check says do not freestyle this one 💅

the request bits — the 0 row:

• bit 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_PF2GUC_VF_CONTROL_CMD = 0x5506

the payload bits — the 1 and 2 rows:

• 1, bits 31:0 — DATA1 = VFID — VF identifier
• 2, bits 31:0 — DATA2 = COMMAND — control command:
  • GUC_PF_TRIGGER_VF_PAUSE = 1
  • GUC_PF_TRIGGER_VF_RESUME = 2
  • GUC_PF_TRIGGER_VF_STOP = 3
  • GUC_PF_TRIGGER_VF_FLR_START = 4
  • GUC_PF_TRIGGER_VF_FLR_FINISH = 5

the success response bits — also the 0 row:

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

🌈 SEE ALSO 🌈

kernel file: ./drivers/gpu/drm/xe/abi/guc_actions_sriov_abi.h

go be nosy and read these too, bestie:

• 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)
• VF2GUC_MATCH_VERSION(9)
• PF2GUC_UPDATE_VGT_POLICY(9)
• PF2GUC_UPDATE_VF_CFG(9)
• VF2GUC_VF_RESET(9)
• VF2GUC_RESFIX_DONE(9)
• VF2GUC_QUERY_SINGLE_KLV(9)
• PF2GUC_SAVE_RESTORE_VF(9)
• VF2GUC_RESFIX_START(9)

source/version: ./drivers/gpu/drm/xe/abi · date: October 2026 · page: PF2GUC_VF_CONTROL(9) — bye bestie, ily, slay 🫶💖