Commit 9ca192cb authored by Michal Wajdeczko's avatar Michal Wajdeczko
Browse files

drm/xe/pf: Add documentation for vram_quota 



Add initial documentation for recently added VRAM provisioning
Xe driver specific SR-IOV sysfs files under device/sriov_admin.

Signed-off-by: default avatarMichal Wajdeczko <michal.wajdeczko@intel.com>
Cc: Rodrigo Vivi <rodrigo.vivi@intel.com>
Reviewed-by: default avatarPiotr Piórkowski <piotr.piorkowski@intel.com>
Acked-by: default avatarRodrigo Vivi <rodrigo.vivi@intel.com>
Link: https://patch.msgid.link/20260218205553.3561-11-michal.wajdeczko@intel.com
parent d039fa85

Documentation/ABI/testing/sysfs-driver-intel-xe-sriov

+31 −0
Original line number Diff line number Diff line
@@ -129,6 +129,37 @@ Description: 
			-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