What:		/sys/bus/pci/drivers/xe/.../sriov_admin/
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		This directory appears for the particular Intel Xe device when:

		 - device supports SR-IOV, and
		 - device is a Physical Function (PF), and
		 - driver support for the SR-IOV PF is enabled on given device.

		This directory is used as a root for all attributes required to
		manage both Physical Function (PF) and Virtual Functions (VFs).


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/pf/
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		This directory holds attributes related to the SR-IOV Physical
		Function (PF).


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf1/
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf2/
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<N>/
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		These directories hold attributes related to the SR-IOV Virtual
		Functions (VFs).

		Note that the VF number <N> is 1-based as described in PCI SR-IOV
		specification as the Xe driver follows that naming schema.

		There could be "vf1", "vf2" and so on, up to "vf<N>", where <N>
		matches the value of the "sriov_totalvfs" attribute.


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/exec_quantum_ms
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/preempt_timeout_us
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/pf/profile/sched_priority
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/exec_quantum_ms
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/preempt_timeout_us
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/sched_priority
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		These files expose scheduling parameters for the PF and its VFs, and
		are visible only on Intel Xe platforms that use time-sliced GPU sharing.
		They can be changed even if VFs are enabled and running and reflect the
		settings of all tiles/GTs assigned to the given function.

		exec_quantum_ms: (RW) unsigned integer
			The GT execution quantum (EQ) in [ms] for the given function.
			Actual quantum value might be aligned per HW/FW requirements.

			Default is 0 (unlimited).

		preempt_timeout_us: (RW) unsigned integer
			The GT preemption timeout in [us] of the given function.
			Actual timeout value might be aligned per HW/FW requirements.

			Default is 0 (unlimited).

		sched_priority: (RW/RO) string
			The GT scheduling priority of the given function.

			"low" - function will be scheduled on the GPU for its EQ/PT
				only if function has any work already submitted.

			"normal" - functions will be scheduled on the GPU for its EQ/PT
				irrespective of whether it has submitted a work or not.

			"high" - function will be scheduled on the GPU for its EQ/PT
				in the next time-slice after the current one completes
				and function has a work submitted.

			Default is "low".

			When read, this file will display the current and available
			scheduling priorities. The currently active priority level will
			be enclosed in square brackets, like:

				[low] normal high

			This file can be read-only if changing the priority is not
			supported.

		Writes to these attributes may fail with errors like:
			-EINVAL if provided input is malformed or not recognized,
			-EPERM if change is not applicable on given HW/FW,
			-EIO if FW refuses to change the provisioning.

		Reads from these attributes may fail with:
			-EUCLEAN if value is not consistent across all tiles/GTs.


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/exec_quantum_ms
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/preempt_timeout_us
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/sched_priority
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		These files allows bulk reconfiguration of the scheduling parameters
		of the PF or VFs and are available only for Intel Xe platforms with
		GPU sharing based on the time-slice basis. These scheduling parameters
		can be changed even if VFs are enabled and running.

		exec_quantum_ms: (WO) unsigned integer
			The GT execution quantum (EQ) in [ms] to be applied to all functions.
			See sriov_admin/{pf,vf<N>}/profile/exec_quantum_ms for more details.

		preempt_timeout_us: (WO) unsigned integer
			The GT preemption timeout (PT) in [us] to be applied to all functions.
			See sriov_admin/{pf,vf<N>}/profile/preempt_timeout_us for more details.

		sched_priority: (WO) string
			The GT scheduling priority to be applied for all functions.
			See sriov_admin/{pf,vf<N>}/profile/sched_priority for more details.

		Writes to these attributes may fail with errors like:
			-EINVAL if provided input is malformed or not recognized,
			-EPERM if change is not applicable on given HW/FW,
			-EIO if FW refuses to change the provisioning.


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/vram_quota
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/vram_quota
Date:		February 2026
KernelVersion:	7.0
Contact:	intel-xe@lists.freedesktop.org
Description:
		These files allow to perform initial VFs VRAM provisioning prior to VFs
		enabling or to change VFs VRAM provisioning once the VFs are enabled.
		Any non-zero initial VRAM provisioning will block VFs auto-provisioning.
		Without initial VRAM provisioning those files will show result of the
		VRAM auto-provisioning performed by the PF once the VFs are enabled.
		Once the VFs are disabled, all VRAM provisioning will be released.
		These files are visible only on discrete Intel Xe platforms with VRAM
		and are writeable only if dynamic VFs VRAM provisioning is supported.

		.bulk_profile/vram_quota: (WO) unsigned integer
			The amount of the provisioned VRAM in [bytes] for each VF.
			Actual quota value might be aligned per HW/FW requirements.

		profile/vram_quota: (RW) unsigned integer
			The amount of the provisioned VRAM in [bytes] for this VF.
			Actual quota value might be aligned per HW/FW requirements.

			Default is 0 (unprovisioned).

		Writes to these attributes may fail with errors like:
			-EINVAL if provided input is malformed or not recognized,
			-EPERM if change is not applicable on given HW/FW,
			-EIO if FW refuses to change the provisioning.


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/stop
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		This file allows to control scheduling of the VF on the Intel Xe GPU
		platforms. It allows to implement custom policy mechanism in case VFs
		are misbehaving or triggering adverse events above defined thresholds.

		stop: (WO) bool
			All GT executions of given function shall be immediately stopped.
			To allow scheduling this VF again, the VF FLR must be triggered.

		Writes to this attribute may fail with errors like:
			-EINVAL if provided input is malformed or not recognized,
			-EPERM if change is not applicable on given HW/FW,
			-EIO if FW refuses to change the scheduling.


What:		/sys/bus/pci/drivers/xe/.../sriov_admin/pf/device
What:		/sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/device
Date:		October 2025
KernelVersion:	6.19
Contact:	intel-xe@lists.freedesktop.org
Description:
		These are symlinks to the underlying PCI device entry representing
		given Xe SR-IOV function. For the PF, this link is always present.
		For VFs, this link is present only for currently enabled VFs.
