PF2GUC_SAVE_RESTORE_VF(9)

💅 PF2GUC_SAVE_RESTORE_VF 💅

okay so bestie, this is the Kernel API Manual page for PF2GUC_SAVE_RESTORE_VF(9) — and it's literally the message the PF uses to migrate VF info state maintained by the GuC. 💖

This message must be sent as CTB HXG Message_.

Available since GuC version 70.25.0 ✨

Request bits — the 0 row, iykyk:

• bits 31 — ORIGIN = GUC_HXG_ORIGIN_HOST_
• bits 30:28 — TYPE = GUC_HXG_TYPE_REQUEST_
• bits 27:16 — DATA0 = OPCODE — operation to take:
  • GUC_PF_OPCODE_VF_SAVE = 0
  • GUC_PF_OPCODE_VF_RESTORE = 1
• bits 15:0 — ACTION = GUC_ACTION_PF2GUC_SAVE_RESTORE_VF = 0x550B

Next table entries, bestie 🎀:

• 1, bits 31:0 — VFID — VF identifier
• 2, bits 31:0 — ADDR_LO — lower 32-bits of GGTT offset to the buffer where the VF info will be save to or restored from.
• 3, bits 31:0 — ADDR_HI — upper 32-bits of GGTT offset to the buffer where the VF info will be save to or restored from.
• 4, bits 27:0 — SIZE — size of the buffer (in dwords)
• bits 31:28 — MBZ

Response table — no cap ✅:

• row 0, bits 31 — ORIGIN = GUC_HXG_ORIGIN_GUC_
• bits 30:28 — TYPE = GUC_HXG_TYPE_RESPONSE_SUCCESS_
• bits 27:0 — DATA0 = USED — size of used buffer space (in dwords)

👀 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)
• 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)
• VF2GUC_RESFIX_START(9)

that's the whole page, bestie 🫶 — source/version ./drivers/gpu/drm/xe/abi, dated October 2026, and the page is PF2GUC_SAVE_RESTORE_VF(9). periodt ✨