Documentation / thunderbolt: Clean up entries
authorMika Westerberg <mika.westerberg@linux.intel.com>
Mon, 12 Apr 2021 11:12:47 +0000 (14:12 +0300)
committerMika Westerberg <mika.westerberg@linux.intel.com>
Mon, 31 May 2021 11:39:45 +0000 (14:39 +0300)
Align the "What" entries along with the rest and move
nvm_authenticate_on_disconnect to correct place.

Signed-off-by: Mika Westerberg <mika.westerberg@linux.intel.com>
Documentation/ABI/testing/sysfs-bus-thunderbolt

index c41c68f..05afeee 100644 (file)
@@ -1,4 +1,4 @@
-What: /sys/bus/thunderbolt/devices/.../domainX/boot_acl
+What:          /sys/bus/thunderbolt/devices/.../domainX/boot_acl
 Date:          Jun 2018
 KernelVersion: 4.17
 Contact:       thunderbolt-software@lists.01.org
@@ -21,7 +21,7 @@ Description:  Holds a comma separated list of device unique_ids that
                If a device is authorized automatically during boot its
                boot attribute is set to 1.
 
-What: /sys/bus/thunderbolt/devices/.../domainX/deauthorization
+What:          /sys/bus/thunderbolt/devices/.../domainX/deauthorization
 Date:          May 2021
 KernelVersion: 5.12
 Contact:       Mika Westerberg <mika.westerberg@linux.intel.com>
@@ -30,7 +30,7 @@ Description:  This attribute tells whether the system supports
                de-authorize PCIe tunnel by writing 0 to authorized
                attribute under each device.
 
-What: /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection
+What:          /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection
 Date:          Mar 2019
 KernelVersion: 4.21
 Contact:       thunderbolt-software@lists.01.org
@@ -39,7 +39,7 @@ Description:  This attribute tells whether the system uses IOMMU
                it is not (DMA protection is solely based on Thunderbolt
                security levels).
 
-What: /sys/bus/thunderbolt/devices/.../domainX/security
+What:          /sys/bus/thunderbolt/devices/.../domainX/security
 Date:          Sep 2017
 KernelVersion: 4.13
 Contact:       thunderbolt-software@lists.01.org
@@ -61,7 +61,7 @@ Description:  This attribute holds current Thunderbolt security level
                         the BIOS.
                =======  ==================================================
 
-What: /sys/bus/thunderbolt/devices/.../authorized
+What:          /sys/bus/thunderbolt/devices/.../authorized
 Date:          Sep 2017
 KernelVersion: 4.13
 Contact:       thunderbolt-software@lists.01.org
@@ -95,14 +95,14 @@ Description:        This attribute is used to authorize Thunderbolt devices
                    EKEYREJECTED if the challenge response did not match.
                ==  ========================================================
 
-What: /sys/bus/thunderbolt/devices/.../boot
+What:          /sys/bus/thunderbolt/devices/.../boot
 Date:          Jun 2018
 KernelVersion: 4.17
 Contact:       thunderbolt-software@lists.01.org
 Description:   This attribute contains 1 if Thunderbolt device was already
                authorized on boot and 0 otherwise.
 
-What: /sys/bus/thunderbolt/devices/.../generation
+What:          /sys/bus/thunderbolt/devices/.../generation
 Date:          Jan 2020
 KernelVersion: 5.5
 Contact:       Christian Kellner <christian@kellner.me>
@@ -110,7 +110,7 @@ Description:        This attribute contains the generation of the Thunderbolt
                controller associated with the device. It will contain 4
                for USB4.
 
-What: /sys/bus/thunderbolt/devices/.../key
+What:          /sys/bus/thunderbolt/devices/.../key
 Date:          Sep 2017
 KernelVersion: 4.13
 Contact:       thunderbolt-software@lists.01.org
@@ -226,6 +226,20 @@ Description:       When new NVM image is written to the non-active NVM
                based mailbox before the device is power cycled. Writing
                0 here clears the status.
 
+What:          /sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect
+Date:          Oct 2020
+KernelVersion: v5.9
+Contact:       Mario Limonciello <mario.limonciello@dell.com>
+Description:   For supported devices, automatically authenticate the new Thunderbolt
+               image when the device is disconnected from the host system.
+
+               This file will accept writing values "1" or "2"
+
+               - Writing "1" will flush the image to the storage
+                 area and prepare the device for authentication on disconnect.
+               - Writing "2" will run some basic validation on the image
+                 and flush it to the storage area.
+
 What:          /sys/bus/thunderbolt/devices/<xdomain>.<service>/key
 Date:          Jan 2018
 KernelVersion: 4.15
@@ -308,17 +322,3 @@ Date:              Oct 2020
 KernelVersion: v5.9
 Contact:       Mika Westerberg <mika.westerberg@linux.intel.com>
 Description:   Retimer vendor identifier read from the hardware.
-
-What:          /sys/bus/thunderbolt/devices/.../nvm_authenticate_on_disconnect
-Date:          Oct 2020
-KernelVersion: v5.9
-Contact:       Mario Limonciello <mario.limonciello@dell.com>
-Description:   For supported devices, automatically authenticate the new Thunderbolt
-               image when the device is disconnected from the host system.
-
-               This file will accept writing values "1" or "2"
-
-               - Writing "1" will flush the image to the storage
-                 area and prepare the device for authentication on disconnect.
-               - Writing "2" will run some basic validation on the image
-                 and flush it to the storage area.