linux-kernel - [PATCH v2 3/3] doc: Add ABI documentation for uio_pci

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <20250925104018.57053-3-guoyaxing@bosc.ac.cn>
Date: Thu, 25 Sep 2025 18:40:18 +0800
From: Yaxing Guo <guoyaxing@...c.ac.cn>
To: gregkh@...uxfoundation.org
Cc: linux-kernel@...r.kernel.org,
	wangran@...c.ac.cn,
	zhangjian@...c.ac.cn,
	anxu@...c.ac.cn,
	guoyaxing@...c.ac.cn
Subject: [PATCH v2 3/3] doc: Add ABI documentation for uio_pci_sva driver sysfs attributes

Add ABI documentation for the sysfs interface provided by the
uio_pci_sva driver, specifically the 'pasid' attribute.

The 'pasid' attribute exposes the Process Address Space ID (PASID)
assigned by the IOMMU to the device for use with Shared Virtual
Addressing (SVA). User-space UIO applications read this attribute
to obtain the PASID and program it into the device's configuration
registers, enabling the device to perform DMA using user-space
virtual addresses.

This attribute appears under:
/sys/bus/pci/drivers/uio_pci_sva/<pci_dev>/pasid

Signed-off-by: Yaxing Guo <guoyaxing@...c.ac.cn>
---
 .../ABI/testing/sysfs-driver-uio_pci_sva-pasid    | 15 +++++++++++++++
 1 file changed, 15 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-driver-uio_pci_sva-pasid

diff --git a/Documentation/ABI/testing/sysfs-driver-uio_pci_sva-pasid b/Documentation/ABI/testing/sysfs-driver-uio_pci_sva-pasid
new file mode 100644
index 000000000000..a6afa8c2775c
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-driver-uio_pci_sva-pasid
@@ -0,0 +1,15 @@
+What:		/sys/bus/pci/drivers/uio_pci_sva/<pci_dev>/pasid
+Date:		September 2025
+Contact:	Yaxing Guo <guoyaxing@...c.ac.cn>
+Description:
+		Process Address Space ID (PASID) assigned by IOMMU driver to
+		the device for use witch Shared Virtual Addressing (SVA).
+
+		This read-only attribute exposes the PASID allocated by the
+		IOMMU driver during sva device binding.
+
+		User-space UIO applications must read this attribute to
+		obtain the PASID and program it into the device's configuration
+		registers. This enables the device to perform DMA using
+		user-space virtual address, with address translation handled
+		by IOMMU.
-- 
2.34.1