Linux/Documentation/ABI/testing/sysfs-bus-thunderbolt

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

1 What: /sys/bus/thunderbolt/devices/. !! 1 What: /sys/bus/thunderbolt/devices/.../domainX/security 2 Date: Jun 2018 << 3 KernelVersion: 4.17 << 4 Contact: Mika Westerberg <mika.westerber << 5 Description: Holds a comma separated list o << 6 are allowed to be connected au << 7 startup (e.g boot devices). Th << 8 maximum supported number of un << 9 entries are empty. This allows << 10 to determine how many entries << 11 If there are multiple controll << 12 its own ACL list and size may << 13 controllers. << 14 << 15 System BIOS may have an option << 16 that needs to be selected befo << 17 consideration. << 18 << 19 Software always updates a full << 20 << 21 If a device is authorized auto << 22 boot attribute is set to 1. << 23 << 24 What: /sys/bus/thunderbolt/devices/. << 25 Date: May 2021 << 26 KernelVersion: 5.12 << 27 Contact: Mika Westerberg <mika.westerber << 28 Description: This attribute tells whether t << 29 de-authorization of devices. V << 30 de-authorize PCIe tunnel by wr << 31 attribute under each device. << 32 << 33 What: /sys/bus/thunderbolt/devices/. << 34 Date: Mar 2019 << 35 KernelVersion: 4.21 << 36 Contact: Mika Westerberg <mika.westerber << 37 Description: This attribute tells whether t << 38 for DMA protection. Value of 1 << 39 it is not (DMA protection is s << 40 security levels). << 41 << 42 What: /sys/bus/thunderbolt/devices/. << 43 Date: Sep 2017 2 Date: Sep 2017 44 KernelVersion: 4.13 3 KernelVersion: 4.13 45 Contact: Mika Westerberg <mika.westerber !! 4 Contact: thunderbolt-software@lists.01.org 46 Description: This attribute holds current T 5 Description: This attribute holds current Thunderbolt security level 47 set by the system BIOS. Possib 6 set by the system BIOS. Possible values are: 48 7 49 ======= ===================== !! 8 none: All devices are automatically authorized 50 none All devices are autom !! 9 user: Devices are only authorized based on writing 51 user Devices are only auth !! 10 appropriate value to the authorized attribute 52 appropriate value to !! 11 secure: Require devices that support secure connect at 53 secure Require devices that !! 12 minimum. User needs to authorize each device. 54 minimum. User needs t !! 13 dponly: Automatically tunnel Display port (and USB). No 55 dponly Automatically tunnel !! 14 PCIe tunnels are created. 56 PCIe tunnels are crea << 57 usbonly Automatically tunnel << 58 connected Thunderbolt << 59 PCIe links downstream << 60 nopcie USB4 system where PCI << 61 the BIOS. << 62 ======= ===================== << 63 15 64 What: /sys/bus/thunderbolt/devices/. !! 16 What: /sys/bus/thunderbolt/devices/.../authorized 65 Date: Sep 2017 17 Date: Sep 2017 66 KernelVersion: 4.13 18 KernelVersion: 4.13 67 Contact: Mika Westerberg <mika.westerber !! 19 Contact: thunderbolt-software@lists.01.org 68 Description: This attribute is used to auth 20 Description: This attribute is used to authorize Thunderbolt devices 69 after they have been connected 21 after they have been connected. If the device is not 70 authorized, no PCIe devices ar !! 22 authorized, no devices such as PCIe and Display port are >> 23 available to the system. 71 24 72 Contents of this attribute wil 25 Contents of this attribute will be 0 when the device is not 73 yet authorized. 26 yet authorized. 74 27 75 Possible values are supported: 28 Possible values are supported: 76 !! 29 1: The device will be authorized and connected 77 == ========================== << 78 0 The device will be de-auth << 79 deauthorization attribute << 80 1 The device will be authori << 81 == ========================== << 82 30 83 When key attribute contains 32 31 When key attribute contains 32 byte hex string the possible 84 values are: 32 values are: >> 33 1: The 32 byte hex string is added to the device NVM and >> 34 the device is authorized. >> 35 2: Send a challenge based on the 32 byte hex string. If the >> 36 challenge response from device is valid, the device is >> 37 authorized. In case of failure errno will be ENOKEY if >> 38 the device did not contain a key at all, and >> 39 EKEYREJECTED if the challenge response did not match. 85 40 86 == ========================== !! 41 What: /sys/bus/thunderbolt/devices/.../key 87 0 The device will be de-auth << 88 deauthorization attribute << 89 1 The 32 byte hex string is << 90 the device is authorized. << 91 2 Send a challenge based on << 92 challenge response from de << 93 authorized. In case of fai << 94 the device did not contain << 95 EKEYREJECTED if the challe << 96 == ========================== << 97 << 98 What: /sys/bus/thunderbolt/devices/. << 99 Date: Jun 2018 << 100 KernelVersion: 4.17 << 101 Contact: Mika Westerberg <mika.westerber << 102 Description: This attribute contains 1 if T << 103 authorized on boot and 0 other << 104 << 105 What: /sys/bus/thunderbolt/devices/. << 106 Date: Jan 2020 << 107 KernelVersion: 5.5 << 108 Contact: Christian Kellner <christian@ke << 109 Description: This attribute contains the ge << 110 controller associated with the << 111 for USB4. << 112 << 113 What: /sys/bus/thunderbolt/devices/. << 114 Date: Sep 2017 42 Date: Sep 2017 115 KernelVersion: 4.13 43 KernelVersion: 4.13 116 Contact: Mika Westerberg <mika.westerber !! 44 Contact: thunderbolt-software@lists.01.org 117 Description: When a devices supports Thunde 45 Description: When a devices supports Thunderbolt secure connect it will 118 have this attribute. Writing 3 46 have this attribute. Writing 32 byte hex string changes 119 authorization to use the secur 47 authorization to use the secure connection method instead. 120 Writing an empty string clears 48 Writing an empty string clears the key and regular connection 121 method can be used again. 49 method can be used again. 122 50 123 What: /sys/bus/thunderbolt/devices/. 51 What: /sys/bus/thunderbolt/devices/.../device 124 Date: Sep 2017 52 Date: Sep 2017 125 KernelVersion: 4.13 53 KernelVersion: 4.13 126 Contact: Mika Westerberg <mika.westerber !! 54 Contact: thunderbolt-software@lists.01.org 127 Description: This attribute contains id of 55 Description: This attribute contains id of this device extracted from 128 the device DROM. 56 the device DROM. 129 57 130 What: /sys/bus/thunderbolt/devices/. 58 What: /sys/bus/thunderbolt/devices/.../device_name 131 Date: Sep 2017 59 Date: Sep 2017 132 KernelVersion: 4.13 60 KernelVersion: 4.13 133 Contact: Mika Westerberg <mika.westerber !! 61 Contact: thunderbolt-software@lists.01.org 134 Description: This attribute contains name o 62 Description: This attribute contains name of this device extracted from 135 the device DROM. 63 the device DROM. 136 64 137 What: /sys/bus/thunderbolt/devices/. << 138 Date: Jul 2021 << 139 KernelVersion: 5.13 << 140 Contact: Mika Westerberg <mika.westerber << 141 Description: Only set for XDomains. The max << 142 supports as its input HopID. << 143 << 144 What: /sys/bus/thunderbolt/devices/. << 145 Date: Jan 2020 << 146 KernelVersion: 5.5 << 147 Contact: Mika Westerberg <mika.westerber << 148 Description: This attribute reports the dev << 149 All RX lanes run at the same s << 150 << 151 What: /sys/bus/thunderbolt/devices/. << 152 Date: Jan 2020 << 153 KernelVersion: 5.5 << 154 Contact: Mika Westerberg <mika.westerber << 155 Description: This attribute reports number << 156 using simultaneously through i << 157 << 158 What: /sys/bus/thunderbolt/devices/. << 159 Date: Jan 2020 << 160 KernelVersion: 5.5 << 161 Contact: Mika Westerberg <mika.westerber << 162 Description: This attribute reports the TX << 163 All TX lanes run at the same s << 164 << 165 What: /sys/bus/thunderbolt/devices/. << 166 Date: Jan 2020 << 167 KernelVersion: 5.5 << 168 Contact: Mika Westerberg <mika.westerber << 169 Description: This attribute reports number << 170 using simultaneously through i << 171 << 172 What: /sys/bus/thunderbolt/devices/. 65 What: /sys/bus/thunderbolt/devices/.../vendor 173 Date: Sep 2017 66 Date: Sep 2017 174 KernelVersion: 4.13 67 KernelVersion: 4.13 175 Contact: Mika Westerberg <mika.westerber !! 68 Contact: thunderbolt-software@lists.01.org 176 Description: This attribute contains vendor 69 Description: This attribute contains vendor id of this device extracted 177 from the device DROM. 70 from the device DROM. 178 71 179 What: /sys/bus/thunderbolt/devices/. 72 What: /sys/bus/thunderbolt/devices/.../vendor_name 180 Date: Sep 2017 73 Date: Sep 2017 181 KernelVersion: 4.13 74 KernelVersion: 4.13 182 Contact: Mika Westerberg <mika.westerber !! 75 Contact: thunderbolt-software@lists.01.org 183 Description: This attribute contains vendor 76 Description: This attribute contains vendor name of this device extracted 184 from the device DROM. 77 from the device DROM. 185 78 186 What: /sys/bus/thunderbolt/devices/. 79 What: /sys/bus/thunderbolt/devices/.../unique_id 187 Date: Sep 2017 80 Date: Sep 2017 188 KernelVersion: 4.13 81 KernelVersion: 4.13 189 Contact: Mika Westerberg <mika.westerber !! 82 Contact: thunderbolt-software@lists.01.org 190 Description: This attribute contains unique 83 Description: This attribute contains unique_id string of this device. 191 This is either read from hardw 84 This is either read from hardware registers (UUID on 192 newer hardware) or based on UI 85 newer hardware) or based on UID from the device DROM. 193 Can be used to uniquely identi 86 Can be used to uniquely identify particular device. 194 87 195 What: /sys/bus/thunderbolt/devices/. 88 What: /sys/bus/thunderbolt/devices/.../nvm_version 196 Date: Sep 2017 89 Date: Sep 2017 197 KernelVersion: 4.13 90 KernelVersion: 4.13 198 Contact: Mika Westerberg <mika.westerber !! 91 Contact: thunderbolt-software@lists.01.org 199 Description: If the device has upgradeable 92 Description: If the device has upgradeable firmware the version 200 number is available here. Form 93 number is available here. Format: %x.%x, major.minor. 201 If the device is in safe mode 94 If the device is in safe mode reading the file returns 202 -ENODATA instead as the NVM ve 95 -ENODATA instead as the NVM version is not available. 203 96 204 What: /sys/bus/thunderbolt/devices/. 97 What: /sys/bus/thunderbolt/devices/.../nvm_authenticate 205 Date: Sep 2017 98 Date: Sep 2017 206 KernelVersion: 4.13 99 KernelVersion: 4.13 207 Contact: Mika Westerberg <mika.westerber !! 100 Contact: thunderbolt-software@lists.01.org 208 Description: When new NVM image is written 101 Description: When new NVM image is written to the non-active NVM 209 area (through non_activeX NVMe 102 area (through non_activeX NVMem device), the 210 authentication procedure is st !! 103 authentication procedure is started by writing 1 to 211 this file. !! 104 this file. If everything goes well, the device is 212 If everything goes well, the d << 213 restarted with the new NVM fir 105 restarted with the new NVM firmware. If the image 214 verification fails an error co 106 verification fails an error code is returned instead. 215 107 216 This file will accept writing << 217 << 218 - Writing "1" will flush the i << 219 area and authenticate the im << 220 - Writing "2" will run some ba << 221 and flush it to the storage << 222 - Writing "3" will authenticat << 223 currently written in the sto << 224 supported with USB4 devices << 225 << 226 When read holds status of the 108 When read holds status of the last authentication 227 operation if an error occurred 109 operation if an error occurred during the process. This 228 is directly the status value f 110 is directly the status value from the DMA configuration 229 based mailbox before the devic 111 based mailbox before the device is power cycled. Writing 230 0 here clears the status. 112 0 here clears the status. 231 << 232 What: /sys/bus/thunderbolt/devices/. << 233 Date: Oct 2020 << 234 KernelVersion: v5.9 << 235 Contact: Mario Limonciello <mario.limonc << 236 Description: For supported devices, automat << 237 image when the device is disco << 238 << 239 This file will accept writing << 240 << 241 - Writing "1" will flush the i << 242 area and prepare the device << 243 - Writing "2" will run some ba << 244 and flush it to the storage << 245 << 246 What: /sys/bus/thunderbolt/devices/< << 247 Date: Jan 2018 << 248 KernelVersion: 4.15 << 249 Contact: Mika Westerberg <mika.westerber << 250 Description: This contains name of the prop << 251 service exposes. This entry de << 252 question. Following directorie << 253 the Apple XDomain specificatio << 254 << 255 ======== ==================== << 256 network IP/ethernet over Thu << 257 targetdm Target disk mode pro << 258 extdisp External display mod << 259 ======== ==================== << 260 << 261 What: /sys/bus/thunderbolt/devices/< << 262 Date: Jan 2018 << 263 KernelVersion: 4.15 << 264 Contact: Mika Westerberg <mika.westerber << 265 Description: Stores the same MODALIAS value << 266 the XDomain service. Format: t << 267 << 268 What: /sys/bus/thunderbolt/devices/< << 269 Date: Jan 2018 << 270 KernelVersion: 4.15 << 271 Contact: Mika Westerberg <mika.westerber << 272 Description: This contains XDomain protocol << 273 service supports. << 274 << 275 What: /sys/bus/thunderbolt/devices/< << 276 Date: Jan 2018 << 277 KernelVersion: 4.15 << 278 Contact: Mika Westerberg <mika.westerber << 279 Description: This contains XDomain protocol << 280 service supports. << 281 << 282 What: /sys/bus/thunderbolt/devices/< << 283 Date: Jan 2018 << 284 KernelVersion: 4.15 << 285 Contact: Mika Westerberg <mika.westerber << 286 Description: This contains XDomain software << 287 service supports. << 288 << 289 What: /sys/bus/thunderbolt/devices/< << 290 Date: Jan 2018 << 291 KernelVersion: 4.15 << 292 Contact: Mika Westerberg <mika.westerber << 293 Description: This contains XDomain service << 294 bitmask. Format: %x << 295 << 296 What: /sys/bus/thunderbolt/devices/u << 297 Date: April 2022 << 298 Contact: Heikki Krogerus <heikki.krogeru << 299 Description: << 300 Symlink to the USB Type-C conn << 301 created when USB Type-C Connec << 302 and only if the system firmwar << 303 describing the connection betw << 304 connector. << 305 << 306 What: /sys/bus/thunderbolt/devices/u << 307 Date: Sep 2021 << 308 KernelVersion: v5.14 << 309 Contact: Mika Westerberg <mika.westerber << 310 Description: Returns the current link mode. << 311 "usb4", "tbt" and "none". << 312 << 313 What: /sys/bus/thunderbolt/devices/u << 314 Date: Sep 2021 << 315 KernelVersion: v5.14 << 316 Contact: Rajmohan Mani <rajmohan.mani@in << 317 Description: Writing 1 to this attribute pu << 318 offline mode. Only allowed whe << 319 connected to the port (link at << 320 Once the port is in offline mo << 321 hotplug events. This is used t << 322 on-board retimers. Writing 0 p << 323 online mode. << 324 << 325 This attribute is only visible << 326 powering on retimers when ther << 327 << 328 What: /sys/bus/thunderbolt/devices/u << 329 Date: Sep 2021 << 330 KernelVersion: v5.14 << 331 Contact: Rajmohan Mani <rajmohan.mani@in << 332 Description: When the USB4 port is in offli << 333 attribute forces rescan of the << 334 retimers. Each retimer appear << 335 the USB4 link was up. These re << 336 as if the cable was connected << 337 firmware can be done the usual << 338 << 339 What: /sys/bus/thunderbolt/devices/< << 340 Date: Oct 2020 << 341 KernelVersion: v5.9 << 342 Contact: Mika Westerberg <mika.westerber << 343 Description: Retimer device identifier read << 344 << 345 What: /sys/bus/thunderbolt/devices/< << 346 Date: Oct 2020 << 347 KernelVersion: v5.9 << 348 Contact: Mika Westerberg <mika.westerber << 349 Description: When new NVM image is written << 350 area (through non_activeX NVMe << 351 authentication procedure is st << 352 this file. If everything goes << 353 restarted with the new NVM fir << 354 verification fails an error co << 355 << 356 When read holds status of the << 357 operation if an error occurred << 358 Format: %x. << 359 << 360 What: /sys/bus/thunderbolt/devices/< << 361 Date: Oct 2020 << 362 KernelVersion: v5.9 << 363 Contact: Mika Westerberg <mika.westerber << 364 Description: Holds retimer NVM version numb << 365 << 366 What: /sys/bus/thunderbolt/devices/< << 367 Date: Oct 2020 << 368 KernelVersion: v5.9 << 369 Contact: Mika Westerberg <mika.westerber << 370 Description: Retimer vendor identifier read <<

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-bus-thunderbolt

Diff markup

Differences between /Documentation/ABI/testing/sysfs-bus-thunderbolt (Version linux-6.12-rc7) and /Documentation/ABI/testing/sysfs-bus-thunderbolt (Version linux-4.14.336)

TOMOYO Linux Cross Reference Linux/Documentation/ABI/testing/sysfs-bus-thunderbolt

Diff markup

Differences between /Documentation/ABI/testing/sysfs-bus-thunderbolt (Version linux-6.12-rc7) and /Documentation/ABI/testing/sysfs-bus-thunderbolt (Version linux-4.14.336)

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-bus-thunderbolt