xref: /linux/Documentation/ABI/testing/sysfs-firmware-plpks (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)
1What:		/sys/firmware/plpks/config
2Date:		February 2023
3Contact:	Nayna Jain <nayna@linux.ibm.com>
4Description:	This optional directory contains read-only config attributes as
5		defined by the PLPKS implementation. All data is in ASCII
6		format.
7
8What:		/sys/firmware/plpks/config/version
9Date:		February 2023
10Contact:	Nayna Jain <nayna@linux.ibm.com>
11Description:	Config version as reported by the hypervisor in ASCII decimal
12		format.
13
14What:		/sys/firmware/plpks/config/max_object_size
15Date:		February 2023
16Contact:	Nayna Jain <nayna@linux.ibm.com>
17Description:	Maximum allowed size of	objects in the keystore in bytes,
18		represented in ASCII decimal format.
19
20		This is not necessarily the same as the max size that can be
21		written to an update file as writes can contain more than
22		object data, you should use the size of the update file for
23		that purpose.
24
25What:		/sys/firmware/plpks/config/total_size
26Date:		February 2023
27Contact:	Nayna Jain <nayna@linux.ibm.com>
28Description:	Total size of the PLPKS in bytes, represented in ASCII decimal
29		format.
30
31What:		/sys/firmware/plpks/config/used_space
32Date:		February 2023
33Contact:	Nayna Jain <nayna@linux.ibm.com>
34Description:	Current space consumed by the key store, in bytes, represented
35		in ASCII decimal format.
36
37What:		/sys/firmware/plpks/config/supported_policies
38Date:		February 2023
39Contact:	Nayna Jain <nayna@linux.ibm.com>
40Description:	Bitmask of supported policy flags by the hypervisor, represented
41		as an 8 byte hexadecimal ASCII string. Consult the hypervisor
42		documentation for what these flags are.
43
44What:		/sys/firmware/plpks/config/signed_update_algorithms
45Date:		February 2023
46Contact:	Nayna Jain <nayna@linux.ibm.com>
47Description:	Bitmask of flags indicating which algorithms the hypervisor
48		supports for signed update of objects, represented as a 16 byte
49		hexadecimal ASCII string. Consult the hypervisor documentation
50		for what these flags mean.
51
52What:		/sys/firmware/plpks/config/wrapping_features
53Date:		November 2025
54Contact:	Srish Srinivasan <ssrish@linux.ibm.com>
55Description:	Bitmask of the wrapping features indicating the wrapping
56		algorithms that are supported for the H_PKS_WRAP_OBJECT requests
57		, represented as a 8 byte hexadecimal ASCII string. Consult the
58		hypervisor documentation for what these flags mean.
59