xe_sriov_pf_...save_consume(9)

💖 xe_sriov_pf_...save_consume(9) 💖

okay bestie, so this is a page straight out of the Kernel API Manual and it's literally about eating migration data packets, no cap. sit down, hydrate, and let's get into it 🫶

---

✨ NAME ✨

xe_sriov_pf_migration_save_consume — consume a VF migration data packet from the device. that's the whole job. it takes a packet off the device's hands so userspace can vibe with it 💅

---

🌸 SYNOPSIS 🌸

struct xe_sriov_packet * xe_sriov_pf_migration_save_consume (struct
xe_device *xe , unsigned int vfid );

look at that signature. iconic. it returns a pointer to a struct xe_sriov_packet, and it takes two things: your xe and your vfid. chef's kiss 🎀

---

🦋 ARGUMENTS 🦋

• xe — the xe_device. your main character. the device in question 🖥️✨
• vfid — the VF identifier. which virtual function we're talking about, bestie, don't mix them up 🙈

---

🔥 DESCRIPTION 🔥

so the save migration data consumer (that's userspace, hii 👋) calls this bad boy when it's processing migration data. it's giving "give me the next packet."

and here's the part where it's lowkey a little dramatic: if there is no migration data to process, it waits until more data is available. it does not just bounce. it sits there. patiently. like a bestie waiting outside the fitting room 💀

---

👑 RETURN 👑

what you get back, in three iconic flavours:

• a pointer to xe_sriov_packet on success — slay ✨
• NULL if the ring is empty and no more migration data is expected — that's it, that's the end, no crumbs left 🍓
• an ERR_PTR value in case of error — it's giving chaos, handle it 😭

fr fr, check the return value. NULL is not an error here, it's the "we're done" signal. ERR_PTR is the actual problem child.

---

🌈 SEE ALSO 🌈

the kernel source file, in all its glory:

./drivers/gpu/drm/xe/xe_sriov_pf_migration.c

and the whole friend group:

• xe_sriov_pf_migration_waitqueue(9)
• xe_sriov_pf_migration_supported(9)
• xe_sriov_pf_migration_disable(9)
• xe_sriov_pf_migration_init(9)
• xe_sriov_pf_migration_restore_produce(9)
• xe_sriov_pf_migration_read(9)
• xe_sriov_pf_migration_write(9)
• xe_sriov_pf_migration_size(9)

---

that's the whole page, bestie — you ate, you understood, you're basically a kernel dev now 💜

this one lives in ./drivers/gpu/drm/xe, it's dated October 2026, and it'll answer to xe_sriov_pf_...save_consume(9) whenever you need her. mwah! 💋🎀✨