xref: /linux/Documentation/ABI/testing/sysfs-driver-qat_kpt (revision 9611c0ce215a66770ccbe5c126bf57ba8c31bcad)
1What:		/sys/bus/pci/devices/<BDF>/qat_kpt/
2Date:		August 2026
3KernelVersion:	7.2
4Contact:	qat-linux@intel.com
5Description:
6		Directory containing attributes related to the QAT Key Protection
7		Technology (KPT) feature. KPT allows cryptographic keys to be used
8		by the accelerator without being exposed in plaintext to the host.
9
10What:		/sys/bus/pci/devices/<BDF>/qat_kpt/enable
11Date:		August 2026
12KernelVersion:	7.2
13Contact:	qat-linux@intel.com
14Description:
15		(RW) Enables or disables Key Protection Technology (KPT).
16
17		Write 1 to enable KPT, or 0 to disable it.
18
19		Example usage::
20
21			# cat /sys/bus/pci/devices/<BDF>/qat_kpt/enable
22			0
23			# echo 1 > /sys/bus/pci/devices/<BDF>/qat_kpt/enable
24
25		This attribute is only available on devices that support KPT.
26
27What:		/sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_fn
28Date:		August 2026
29KernelVersion:	7.2
30Contact:	qat-linux@intel.com
31Description:
32		(RW) Configures the maximum number of KPT symmetric wrapping keys
33		(SWKs) that a Virtual Function (VF) may be associated with.
34
35		Valid values range from 0 to 128. A value of 0 indicates no limit.
36
37		Example usage::
38
39			# cat /sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_fn
40			128
41			# echo 128 > /sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_fn
42
43		This attribute is only available on devices that support KPT.
44
45What:		/sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_pasid
46Date:		August 2026
47KernelVersion:	7.2
48Contact:	qat-linux@intel.com
49Description:
50		(RW) Configures the maximum number of KPT symmetric wrapping keys
51		(SWKs) per Process Address Space ID (PASID).
52
53		Valid values range from 0 to 128. A value of 0 indicates no limit.
54
55		Example usage::
56
57			# cat /sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_pasid
58			128
59			# echo 128 > /sys/bus/pci/devices/<BDF>/qat_kpt/swk_cnt_per_pasid
60
61		This attribute is only available on devices that support KPT.
62
63What:		/sys/bus/pci/devices/<BDF>/qat_kpt/swk_max_ttl
64Date:		August 2026
65KernelVersion:	7.2
66Contact:	qat-linux@intel.com
67Description:
68		(RW) Configures the maximum Time To Live (TTL) for KPT symmetric
69		wrapping keys (SWK).
70
71		Valid values range from 0 to 31536000 seconds. A value of 0
72		indicates that the SWK TTL is unlimited.
73
74		Example usage::
75
76			# cat /sys/bus/pci/devices/<BDF>/qat_kpt/swk_max_ttl
77			1000
78			# echo 1000 > /sys/bus/pci/devices/<BDF>/qat_kpt/swk_max_ttl
79
80		This attribute is only available on devices that support KPT.
81
82What:		/sys/bus/pci/devices/<BDF>/qat_kpt/swk_shared
83Date:		August 2026
84KernelVersion:	7.2
85Contact:	qat-linux@intel.com
86Description:
87		(RW) Controls shared mode for KPT symmetric wrapping keys (SWK).
88
89		Write 1 to enable shared mode, or 0 to disable it (non-shared mode).
90
91		Example usage::
92
93			# cat /sys/bus/pci/devices/<BDF>/qat_kpt/swk_shared
94			0
95			# echo 1 > /sys/bus/pci/devices/<BDF>/qat_kpt/swk_shared
96
97		This attribute is only available on devices that support KPT.
98