^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/firmware/secvar
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description: This directory is created if the POWER firmware supports OS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) secureboot, thereby secure variables. It exposes interface
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) for reading/writing the secure variables
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) What: /sys/firmware/secvar/vars
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Description: This directory lists all the secure variables that are supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) by the firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) What: /sys/firmware/secvar/format
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Description: A string indicating which backend is in use by the firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) This determines the format of the variable and the accepted
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) format of variable updates.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) What: /sys/firmware/secvar/vars/<variable name>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Description: Each secure variable is represented as a directory named as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) <variable_name>. The variable name is unique and is in ASCII
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) representation. The data and size can be determined by reading
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) their respective attribute files.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) What: /sys/firmware/secvar/vars/<variable_name>/size
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Description: An integer representation of the size of the content of the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) variable. In other words, it represents the size of the data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) What: /sys/firmware/secvar/vars/<variable_name>/data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) Contact: Nayna Jain h<nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Description: A read-only file containing the value of the variable. The size
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) of the file represents the maximum size of the variable data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) What: /sys/firmware/secvar/vars/<variable_name>/update
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Date: August 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) Contact: Nayna Jain <nayna@linux.ibm.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Description: A write-only file that is used to submit the new value for the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) variable. The size of the file represents the maximum size of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) the variable data that can be written.