STRUCT XE_DEVICE_PF(9)

🧚 struct xe_device_pf(9) — Xe PF related data

okay so bestie, welcome to the struct xe_device_pf(9) page from the Kernel API Manual 💖 this is the one that holds all the Xe PF related data, and honestly it's giving "backstage pass to the whole SR-IOV operation" energy 👑

---

✨ SYNOPSIS ✨

struct xe_device_pf {
    u16 device_total_vfs;
    u16 driver_max_vfs;
    struct xe_guard guard_vfs_enabling;
    struct mutex master_lock;
    struct xe_sriov_pf_provision provision;
    struct xe_sriov_pf_migration migration;
    struct xe_sriov_pf_service service;
    struct {
      struct kobject *root;
    } sysfs;
    struct xe_sriov_metadata *vfs;
};

like, just look at her 😭 everything a PF needs to keep track of its VFs, all in one struct, all in one vibe 🌸

---

🎀 Members 🎀

• device_total_vfs — the maximum number of VFs the device itself can support. the hardware's hard limit, no cap fr 💅
• driver_max_vfs — the maximum number of VFs the driver supports. yes bestie, these are two different numbers, and yes, you need both 🫶
• guard_vfs_enabling — literally guards VFs enabling. it's the bouncer at the door of the VF club 🚪✨
• master_lock — protects all VFs configurations across GTs. one lock to rule them all, periodt 🔒
• provision — device level provisioning data.
• migration — device level migration data.
• service — device level service data.
• sysfs — device level sysfs data.
• sysfs.root — the root kobject for all SR-IOV entries in sysfs. the mother of the sysfs tree, the main character 🌈
• vfs — metadata for all VFs. all of them. every single one 🦋

---

💜 Description 💜

ok this part is important, don't skip it 👀

the data in this structure is valid only if the driver is running in the XE_SRIOV_MODE_PF mode. that's it. that's the vibe check — wrong mode, and none of this means anything 😭 so fr fr, check your mode first 💀

---

⭐ SEE ALSO ⭐

• Kernel file ./drivers/gpu/drm/xe/xe_sriov_pf_types.h struct xe_sriov_metadata(9)

go read that one next bestie, it's the sister page and she slays too 👑💖

---

okay that's the whole page!! 🎀 this little beauty lives in ./drivers/gpu/drm/xe, and she's dated October 2026 — struct xe_device_pf(9), Kernel API Manual, that's a wrap, mwah 💋🦋✨