Documentation/ABI/testing/sysfs-secvar

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