xref: /linux/Documentation/ABI/testing/sysfs-firmware-plpks (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)
140850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config
240850c90SSrish SrinivasanDate:		February 2023
340850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
440850c90SSrish SrinivasanDescription:	This optional directory contains read-only config attributes as
540850c90SSrish Srinivasan		defined by the PLPKS implementation. All data is in ASCII
640850c90SSrish Srinivasan		format.
740850c90SSrish Srinivasan
840850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/version
940850c90SSrish SrinivasanDate:		February 2023
1040850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
1140850c90SSrish SrinivasanDescription:	Config version as reported by the hypervisor in ASCII decimal
1240850c90SSrish Srinivasan		format.
1340850c90SSrish Srinivasan
1440850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/max_object_size
1540850c90SSrish SrinivasanDate:		February 2023
1640850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
1740850c90SSrish SrinivasanDescription:	Maximum allowed size of	objects in the keystore in bytes,
1840850c90SSrish Srinivasan		represented in ASCII decimal format.
1940850c90SSrish Srinivasan
2040850c90SSrish Srinivasan		This is not necessarily the same as the max size that can be
2140850c90SSrish Srinivasan		written to an update file as writes can contain more than
2240850c90SSrish Srinivasan		object data, you should use the size of the update file for
2340850c90SSrish Srinivasan		that purpose.
2440850c90SSrish Srinivasan
2540850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/total_size
2640850c90SSrish SrinivasanDate:		February 2023
2740850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
2840850c90SSrish SrinivasanDescription:	Total size of the PLPKS in bytes, represented in ASCII decimal
2940850c90SSrish Srinivasan		format.
3040850c90SSrish Srinivasan
3140850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/used_space
3240850c90SSrish SrinivasanDate:		February 2023
3340850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
3440850c90SSrish SrinivasanDescription:	Current space consumed by the key store, in bytes, represented
3540850c90SSrish Srinivasan		in ASCII decimal format.
3640850c90SSrish Srinivasan
3740850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/supported_policies
3840850c90SSrish SrinivasanDate:		February 2023
3940850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
4040850c90SSrish SrinivasanDescription:	Bitmask of supported policy flags by the hypervisor, represented
4140850c90SSrish Srinivasan		as an 8 byte hexadecimal ASCII string. Consult the hypervisor
4240850c90SSrish Srinivasan		documentation for what these flags are.
4340850c90SSrish Srinivasan
4440850c90SSrish SrinivasanWhat:		/sys/firmware/plpks/config/signed_update_algorithms
4540850c90SSrish SrinivasanDate:		February 2023
4640850c90SSrish SrinivasanContact:	Nayna Jain <nayna@linux.ibm.com>
4740850c90SSrish SrinivasanDescription:	Bitmask of flags indicating which algorithms the hypervisor
4840850c90SSrish Srinivasan		supports for signed update of objects, represented as a 16 byte
4940850c90SSrish Srinivasan		hexadecimal ASCII string. Consult the hypervisor documentation
5040850c90SSrish Srinivasan		for what these flags mean.
51*447eb1d5SSrish Srinivasan
52*447eb1d5SSrish SrinivasanWhat:		/sys/firmware/plpks/config/wrapping_features
53*447eb1d5SSrish SrinivasanDate:		November 2025
54*447eb1d5SSrish SrinivasanContact:	Srish Srinivasan <ssrish@linux.ibm.com>
55*447eb1d5SSrish SrinivasanDescription:	Bitmask of the wrapping features indicating the wrapping
56*447eb1d5SSrish Srinivasan		algorithms that are supported for the H_PKS_WRAP_OBJECT requests
57*447eb1d5SSrish Srinivasan		, represented as a 8 byte hexadecimal ASCII string. Consult the
58*447eb1d5SSrish Srinivasan		hypervisor documentation for what these flags mean.
59