1What: /sys/bus/thunderbolt/devices/.../domainX/boot_acl 2Date: Jun 2018 3KernelVersion: 4.17 4Contact: thunderbolt-software@lists.01.org 5Description: Holds a comma separated list of device unique_ids that 6 are allowed to be connected automatically during system 7 startup (e.g boot devices). The list always contains 8 maximum supported number of unique_ids where unused 9 entries are empty. This allows the userspace software 10 to determine how many entries the controller supports. 11 If there are multiple controllers, each controller has 12 its own ACL list and size may be different between the 13 controllers. 14 15 System BIOS may have an option "Preboot ACL" or similar 16 that needs to be selected before this list is taken into 17 consideration. 18 19 Software always updates a full list in each write. 20 21 If a device is authorized automatically during boot its 22 boot attribute is set to 1. 23 24What: /sys/bus/thunderbolt/devices/.../domainX/iommu_dma_protection 25Date: Mar 2019 26KernelVersion: 4.21 27Contact: thunderbolt-software@lists.01.org 28Description: This attribute tells whether the system uses IOMMU 29 for DMA protection. Value of 1 means IOMMU is used 0 means 30 it is not (DMA protection is solely based on Thunderbolt 31 security levels). 32 33What: /sys/bus/thunderbolt/devices/.../domainX/security 34Date: Sep 2017 35KernelVersion: 4.13 36Contact: thunderbolt-software@lists.01.org 37Description: This attribute holds current Thunderbolt security level 38 set by the system BIOS. Possible values are: 39 40 none: All devices are automatically authorized 41 user: Devices are only authorized based on writing 42 appropriate value to the authorized attribute 43 secure: Require devices that support secure connect at 44 minimum. User needs to authorize each device. 45 dponly: Automatically tunnel Display port (and USB). No 46 PCIe tunnels are created. 47 usbonly: Automatically tunnel USB controller of the 48 connected Thunderbolt dock (and Display Port). All 49 PCIe links downstream of the dock are removed. 50 51What: /sys/bus/thunderbolt/devices/.../authorized 52Date: Sep 2017 53KernelVersion: 4.13 54Contact: thunderbolt-software@lists.01.org 55Description: This attribute is used to authorize Thunderbolt devices 56 after they have been connected. If the device is not 57 authorized, no devices such as PCIe and Display port are 58 available to the system. 59 60 Contents of this attribute will be 0 when the device is not 61 yet authorized. 62 63 Possible values are supported: 64 1: The device will be authorized and connected 65 66 When key attribute contains 32 byte hex string the possible 67 values are: 68 1: The 32 byte hex string is added to the device NVM and 69 the device is authorized. 70 2: Send a challenge based on the 32 byte hex string. If the 71 challenge response from device is valid, the device is 72 authorized. In case of failure errno will be ENOKEY if 73 the device did not contain a key at all, and 74 EKEYREJECTED if the challenge response did not match. 75 76What: /sys/bus/thunderbolt/devices/.../boot 77Date: Jun 2018 78KernelVersion: 4.17 79Contact: thunderbolt-software@lists.01.org 80Description: This attribute contains 1 if Thunderbolt device was already 81 authorized on boot and 0 otherwise. 82 83What: /sys/bus/thunderbolt/devices/.../generation 84Date: Jan 2020 85KernelVersion: 5.5 86Contact: Christian Kellner <christian@kellner.me> 87Description: This attribute contains the generation of the Thunderbolt 88 controller associated with the device. It will contain 4 89 for USB4. 90 91What: /sys/bus/thunderbolt/devices/.../key 92Date: Sep 2017 93KernelVersion: 4.13 94Contact: thunderbolt-software@lists.01.org 95Description: When a devices supports Thunderbolt secure connect it will 96 have this attribute. Writing 32 byte hex string changes 97 authorization to use the secure connection method instead. 98 Writing an empty string clears the key and regular connection 99 method can be used again. 100 101What: /sys/bus/thunderbolt/devices/.../device 102Date: Sep 2017 103KernelVersion: 4.13 104Contact: thunderbolt-software@lists.01.org 105Description: This attribute contains id of this device extracted from 106 the device DROM. 107 108What: /sys/bus/thunderbolt/devices/.../device_name 109Date: Sep 2017 110KernelVersion: 4.13 111Contact: thunderbolt-software@lists.01.org 112Description: This attribute contains name of this device extracted from 113 the device DROM. 114 115What: /sys/bus/thunderbolt/devices/.../rx_speed 116Date: Jan 2020 117KernelVersion: 5.5 118Contact: Mika Westerberg <mika.westerberg@linux.intel.com> 119Description: This attribute reports the device RX speed per lane. 120 All RX lanes run at the same speed. 121 122What: /sys/bus/thunderbolt/devices/.../rx_lanes 123Date: Jan 2020 124KernelVersion: 5.5 125Contact: Mika Westerberg <mika.westerberg@linux.intel.com> 126Description: This attribute reports number of RX lanes the device is 127 using simultaneusly through its upstream port. 128 129What: /sys/bus/thunderbolt/devices/.../tx_speed 130Date: Jan 2020 131KernelVersion: 5.5 132Contact: Mika Westerberg <mika.westerberg@linux.intel.com> 133Description: This attribute reports the TX speed per lane. 134 All TX lanes run at the same speed. 135 136What: /sys/bus/thunderbolt/devices/.../tx_lanes 137Date: Jan 2020 138KernelVersion: 5.5 139Contact: Mika Westerberg <mika.westerberg@linux.intel.com> 140Description: This attribute reports number of TX lanes the device is 141 using simultaneusly through its upstream port. 142 143What: /sys/bus/thunderbolt/devices/.../vendor 144Date: Sep 2017 145KernelVersion: 4.13 146Contact: thunderbolt-software@lists.01.org 147Description: This attribute contains vendor id of this device extracted 148 from the device DROM. 149 150What: /sys/bus/thunderbolt/devices/.../vendor_name 151Date: Sep 2017 152KernelVersion: 4.13 153Contact: thunderbolt-software@lists.01.org 154Description: This attribute contains vendor name of this device extracted 155 from the device DROM. 156 157What: /sys/bus/thunderbolt/devices/.../unique_id 158Date: Sep 2017 159KernelVersion: 4.13 160Contact: thunderbolt-software@lists.01.org 161Description: This attribute contains unique_id string of this device. 162 This is either read from hardware registers (UUID on 163 newer hardware) or based on UID from the device DROM. 164 Can be used to uniquely identify particular device. 165 166What: /sys/bus/thunderbolt/devices/.../nvm_version 167Date: Sep 2017 168KernelVersion: 4.13 169Contact: thunderbolt-software@lists.01.org 170Description: If the device has upgradeable firmware the version 171 number is available here. Format: %x.%x, major.minor. 172 If the device is in safe mode reading the file returns 173 -ENODATA instead as the NVM version is not available. 174 175What: /sys/bus/thunderbolt/devices/.../nvm_authenticate 176Date: Sep 2017 177KernelVersion: 4.13 178Contact: thunderbolt-software@lists.01.org 179Description: When new NVM image is written to the non-active NVM 180 area (through non_activeX NVMem device), the 181 authentication procedure is started by writing 1 to 182 this file. If everything goes well, the device is 183 restarted with the new NVM firmware. If the image 184 verification fails an error code is returned instead. 185 186 When read holds status of the last authentication 187 operation if an error occurred during the process. This 188 is directly the status value from the DMA configuration 189 based mailbox before the device is power cycled. Writing 190 0 here clears the status. 191 192What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/key 193Date: Jan 2018 194KernelVersion: 4.15 195Contact: thunderbolt-software@lists.01.org 196Description: This contains name of the property directory the XDomain 197 service exposes. This entry describes the protocol in 198 question. Following directories are already reserved by 199 the Apple XDomain specification: 200 201 network: IP/ethernet over Thunderbolt 202 targetdm: Target disk mode protocol over Thunderbolt 203 extdisp: External display mode protocol over Thunderbolt 204 205What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias 206Date: Jan 2018 207KernelVersion: 4.15 208Contact: thunderbolt-software@lists.01.org 209Description: Stores the same MODALIAS value emitted by uevent for 210 the XDomain service. Format: tbtsvc:kSpNvNrN 211 212What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid 213Date: Jan 2018 214KernelVersion: 4.15 215Contact: thunderbolt-software@lists.01.org 216Description: This contains XDomain protocol identifier the XDomain 217 service supports. 218 219What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers 220Date: Jan 2018 221KernelVersion: 4.15 222Contact: thunderbolt-software@lists.01.org 223Description: This contains XDomain protocol version the XDomain 224 service supports. 225 226What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs 227Date: Jan 2018 228KernelVersion: 4.15 229Contact: thunderbolt-software@lists.01.org 230Description: This contains XDomain software version the XDomain 231 service supports. 232 233What: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns 234Date: Jan 2018 235KernelVersion: 4.15 236Contact: thunderbolt-software@lists.01.org 237Description: This contains XDomain service specific settings as 238 bitmask. Format: %x 239