1What: /sys/bus/pci/drivers/xe/.../sriov_admin/ 2Date: October 2025 3KernelVersion: 6.19 4Contact: intel-xe@lists.freedesktop.org 5Description: 6 This directory appears for the particular Intel Xe device when: 7 8 - device supports SR-IOV, and 9 - device is a Physical Function (PF), and 10 - driver support for the SR-IOV PF is enabled on given device. 11 12 This directory is used as a root for all attributes required to 13 manage both Physical Function (PF) and Virtual Functions (VFs). 14 15 16What: /sys/bus/pci/drivers/xe/.../sriov_admin/pf/ 17Date: October 2025 18KernelVersion: 6.19 19Contact: intel-xe@lists.freedesktop.org 20Description: 21 This directory holds attributes related to the SR-IOV Physical 22 Function (PF). 23 24 25What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf1/ 26What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf2/ 27What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<N>/ 28Date: October 2025 29KernelVersion: 6.19 30Contact: intel-xe@lists.freedesktop.org 31Description: 32 These directories hold attributes related to the SR-IOV Virtual 33 Functions (VFs). 34 35 Note that the VF number <N> is 1-based as described in PCI SR-IOV 36 specification as the Xe driver follows that naming schema. 37 38 There could be "vf1", "vf2" and so on, up to "vf<N>", where <N> 39 matches the value of the "sriov_totalvfs" attribute. 40 41 42What: /sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/exec_quantum_ms 43What: /sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/preempt_timeout_us 44What: /sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/sched_priority 45What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/exec_quantum_ms 46What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/preempt_timeout_us 47What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/sched_priority 48Date: October 2025 49KernelVersion: 6.19 50Contact: intel-xe@lists.freedesktop.org 51Description: 52 These files expose scheduling parameters for the PF and its VFs, and 53 are visible only on Intel Xe platforms that use time-sliced GPU sharing. 54 They can be changed even if VFs are enabled and running and reflect the 55 settings of all tiles/GTs assigned to the given function. 56 57 exec_quantum_ms: (RW) unsigned integer 58 The GT execution quantum (EQ) in [ms] for the given function. 59 Actual quantum value might be aligned per HW/FW requirements. 60 61 Default is 0 (unlimited). 62 63 preempt_timeout_us: (RW) unsigned integer 64 The GT preemption timeout in [us] of the given function. 65 Actual timeout value might be aligned per HW/FW requirements. 66 67 Default is 0 (unlimited). 68 69 sched_priority: (RW/RO) string 70 The GT scheduling priority of the given function. 71 72 "low" - function will be scheduled on the GPU for its EQ/PT 73 only if function has any work already submitted. 74 75 "normal" - functions will be scheduled on the GPU for its EQ/PT 76 irrespective of whether it has submitted a work or not. 77 78 "high" - function will be scheduled on the GPU for its EQ/PT 79 in the next time-slice after the current one completes 80 and function has a work submitted. 81 82 Default is "low". 83 84 When read, this file will display the current and available 85 scheduling priorities. The currently active priority level will 86 be enclosed in square brackets, like: 87 88 [low] normal high 89 90 This file can be read-only if changing the priority is not 91 supported. 92 93 Writes to these attributes may fail with errors like: 94 -EINVAL if provided input is malformed or not recognized, 95 -EPERM if change is not applicable on given HW/FW, 96 -EIO if FW refuses to change the provisioning. 97 98 Reads from these attributes may fail with: 99 -EUCLEAN if value is not consistent across all tiles/GTs. 100 101 102What: /sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/exec_quantum_ms 103What: /sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/preempt_timeout_us 104What: /sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/sched_priority 105Date: October 2025 106KernelVersion: 6.19 107Contact: intel-xe@lists.freedesktop.org 108Description: 109 These files allows bulk reconfiguration of the scheduling parameters 110 of the PF or VFs and are available only for Intel Xe platforms with 111 GPU sharing based on the time-slice basis. These scheduling parameters 112 can be changed even if VFs are enabled and running. 113 114 exec_quantum_ms: (WO) unsigned integer 115 The GT execution quantum (EQ) in [ms] to be applied to all functions. 116 See sriov_admin/{pf,vf<N>}/profile/exec_quantum_ms for more details. 117 118 preempt_timeout_us: (WO) unsigned integer 119 The GT preemption timeout (PT) in [us] to be applied to all functions. 120 See sriov_admin/{pf,vf<N>}/profile/preempt_timeout_us for more details. 121 122 sched_priority: (RW/RO) string 123 The GT scheduling priority to be applied for all functions. 124 See sriov_admin/{pf,vf<N>}/profile/sched_priority for more details. 125 126 Writes to these attributes may fail with errors like: 127 -EINVAL if provided input is malformed or not recognized, 128 -EPERM if change is not applicable on given HW/FW, 129 -EIO if FW refuses to change the provisioning. 130 131 132What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/stop 133Date: October 2025 134KernelVersion: 6.19 135Contact: intel-xe@lists.freedesktop.org 136Description: 137 This file allows to control scheduling of the VF on the Intel Xe GPU 138 platforms. It allows to implement custom policy mechanism in case VFs 139 are misbehaving or triggering adverse events above defined thresholds. 140 141 stop: (WO) bool 142 All GT executions of given function shall be immediately stopped. 143 To allow scheduling this VF again, the VF FLR must be triggered. 144 145 Writes to this attribute may fail with errors like: 146 -EINVAL if provided input is malformed or not recognized, 147 -EPERM if change is not applicable on given HW/FW, 148 -EIO if FW refuses to change the scheduling. 149 150 151What: /sys/bus/pci/drivers/xe/.../sriov_admin/pf/device 152What: /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/device 153Date: October 2025 154KernelVersion: 6.19 155Contact: intel-xe@lists.freedesktop.org 156Description: 157 These are symlinks to the underlying PCI device entry representing 158 given Xe SR-IOV function. For the PF, this link is always present. 159 For VFs, this link is present only for currently enabled VFs. 160