1f67cf491SMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../domainX/security 2f67cf491SMika WesterbergDate: Sep 2017 3f67cf491SMika WesterbergKernelVersion: 4.13 4f67cf491SMika WesterbergContact: thunderbolt-software@lists.01.org 5f67cf491SMika WesterbergDescription: This attribute holds current Thunderbolt security level 6f67cf491SMika Westerberg set by the system BIOS. Possible values are: 7f67cf491SMika Westerberg 8f67cf491SMika Westerberg none: All devices are automatically authorized 9f67cf491SMika Westerberg user: Devices are only authorized based on writing 10f67cf491SMika Westerberg appropriate value to the authorized attribute 11f67cf491SMika Westerberg secure: Require devices that support secure connect at 12f67cf491SMika Westerberg minimum. User needs to authorize each device. 13f67cf491SMika Westerberg dponly: Automatically tunnel Display port (and USB). No 14f67cf491SMika Westerberg PCIe tunnels are created. 15f67cf491SMika Westerberg 16f67cf491SMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../authorized 17f67cf491SMika WesterbergDate: Sep 2017 18f67cf491SMika WesterbergKernelVersion: 4.13 19f67cf491SMika WesterbergContact: thunderbolt-software@lists.01.org 20f67cf491SMika WesterbergDescription: This attribute is used to authorize Thunderbolt devices 21f67cf491SMika Westerberg after they have been connected. If the device is not 22f67cf491SMika Westerberg authorized, no devices such as PCIe and Display port are 23f67cf491SMika Westerberg available to the system. 24f67cf491SMika Westerberg 25f67cf491SMika Westerberg Contents of this attribute will be 0 when the device is not 26f67cf491SMika Westerberg yet authorized. 27f67cf491SMika Westerberg 28f67cf491SMika Westerberg Possible values are supported: 29f67cf491SMika Westerberg 1: The device will be authorized and connected 30f67cf491SMika Westerberg 31f67cf491SMika Westerberg When key attribute contains 32 byte hex string the possible 32f67cf491SMika Westerberg values are: 33f67cf491SMika Westerberg 1: The 32 byte hex string is added to the device NVM and 34f67cf491SMika Westerberg the device is authorized. 35f67cf491SMika Westerberg 2: Send a challenge based on the 32 byte hex string. If the 36f67cf491SMika Westerberg challenge response from device is valid, the device is 37f67cf491SMika Westerberg authorized. In case of failure errno will be ENOKEY if 38f67cf491SMika Westerberg the device did not contain a key at all, and 39f67cf491SMika Westerberg EKEYREJECTED if the challenge response did not match. 40f67cf491SMika Westerberg 4114862ee3SYehezkel BernatWhat: /sys/bus/thunderbolt/devices/.../boot 4214862ee3SYehezkel BernatDate: Jun 2018 4314862ee3SYehezkel BernatKernelVersion: 4.17 4414862ee3SYehezkel BernatContact: thunderbolt-software@lists.01.org 4514862ee3SYehezkel BernatDescription: This attribute contains 1 if Thunderbolt device was already 4614862ee3SYehezkel Bernat authorized on boot and 0 otherwise. 4714862ee3SYehezkel Bernat 48f67cf491SMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../key 49f67cf491SMika WesterbergDate: Sep 2017 50f67cf491SMika WesterbergKernelVersion: 4.13 51f67cf491SMika WesterbergContact: thunderbolt-software@lists.01.org 52f67cf491SMika WesterbergDescription: When a devices supports Thunderbolt secure connect it will 53f67cf491SMika Westerberg have this attribute. Writing 32 byte hex string changes 54f67cf491SMika Westerberg authorization to use the secure connection method instead. 55e545f0d8SBernat, Yehezkel Writing an empty string clears the key and regular connection 56e545f0d8SBernat, Yehezkel method can be used again. 57f67cf491SMika Westerberg 58bfe778acSMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../device 59bfe778acSMika WesterbergDate: Sep 2017 60bfe778acSMika WesterbergKernelVersion: 4.13 61bfe778acSMika WesterbergContact: thunderbolt-software@lists.01.org 62bfe778acSMika WesterbergDescription: This attribute contains id of this device extracted from 63bfe778acSMika Westerberg the device DROM. 64bfe778acSMika Westerberg 6572ee3390SMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../device_name 6672ee3390SMika WesterbergDate: Sep 2017 6772ee3390SMika WesterbergKernelVersion: 4.13 6872ee3390SMika WesterbergContact: thunderbolt-software@lists.01.org 6972ee3390SMika WesterbergDescription: This attribute contains name of this device extracted from 7072ee3390SMika Westerberg the device DROM. 7172ee3390SMika Westerberg 72bfe778acSMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../vendor 73bfe778acSMika WesterbergDate: Sep 2017 74bfe778acSMika WesterbergKernelVersion: 4.13 75bfe778acSMika WesterbergContact: thunderbolt-software@lists.01.org 76bfe778acSMika WesterbergDescription: This attribute contains vendor id of this device extracted 77bfe778acSMika Westerberg from the device DROM. 78bfe778acSMika Westerberg 7972ee3390SMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../vendor_name 8072ee3390SMika WesterbergDate: Sep 2017 8172ee3390SMika WesterbergKernelVersion: 4.13 8272ee3390SMika WesterbergContact: thunderbolt-software@lists.01.org 8372ee3390SMika WesterbergDescription: This attribute contains vendor name of this device extracted 8472ee3390SMika Westerberg from the device DROM. 8572ee3390SMika Westerberg 86bfe778acSMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../unique_id 87bfe778acSMika WesterbergDate: Sep 2017 88bfe778acSMika WesterbergKernelVersion: 4.13 89bfe778acSMika WesterbergContact: thunderbolt-software@lists.01.org 90bfe778acSMika WesterbergDescription: This attribute contains unique_id string of this device. 91bfe778acSMika Westerberg This is either read from hardware registers (UUID on 92bfe778acSMika Westerberg newer hardware) or based on UID from the device DROM. 93bfe778acSMika Westerberg Can be used to uniquely identify particular device. 94e6b245ccSMika Westerberg 95e6b245ccSMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../nvm_version 96e6b245ccSMika WesterbergDate: Sep 2017 97e6b245ccSMika WesterbergKernelVersion: 4.13 98e6b245ccSMika WesterbergContact: thunderbolt-software@lists.01.org 99e6b245ccSMika WesterbergDescription: If the device has upgradeable firmware the version 100e6b245ccSMika Westerberg number is available here. Format: %x.%x, major.minor. 101e6b245ccSMika Westerberg If the device is in safe mode reading the file returns 102e6b245ccSMika Westerberg -ENODATA instead as the NVM version is not available. 103e6b245ccSMika Westerberg 104e6b245ccSMika WesterbergWhat: /sys/bus/thunderbolt/devices/.../nvm_authenticate 105e6b245ccSMika WesterbergDate: Sep 2017 106e6b245ccSMika WesterbergKernelVersion: 4.13 107e6b245ccSMika WesterbergContact: thunderbolt-software@lists.01.org 108e6b245ccSMika WesterbergDescription: When new NVM image is written to the non-active NVM 109e6b245ccSMika Westerberg area (through non_activeX NVMem device), the 110e6b245ccSMika Westerberg authentication procedure is started by writing 1 to 111e6b245ccSMika Westerberg this file. If everything goes well, the device is 112e6b245ccSMika Westerberg restarted with the new NVM firmware. If the image 113e6b245ccSMika Westerberg verification fails an error code is returned instead. 114e6b245ccSMika Westerberg 115e6b245ccSMika Westerberg When read holds status of the last authentication 116e6b245ccSMika Westerberg operation if an error occurred during the process. This 117e6b245ccSMika Westerberg is directly the status value from the DMA configuration 118e6b245ccSMika Westerberg based mailbox before the device is power cycled. Writing 119e6b245ccSMika Westerberg 0 here clears the status. 120d1ff7024SMika Westerberg 121d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/key 122d1ff7024SMika WesterbergDate: Jan 2018 123d1ff7024SMika WesterbergKernelVersion: 4.15 124d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 125d1ff7024SMika WesterbergDescription: This contains name of the property directory the XDomain 126d1ff7024SMika Westerberg service exposes. This entry describes the protocol in 127d1ff7024SMika Westerberg question. Following directories are already reserved by 128d1ff7024SMika Westerberg the Apple XDomain specification: 129d1ff7024SMika Westerberg 130d1ff7024SMika Westerberg network: IP/ethernet over Thunderbolt 131d1ff7024SMika Westerberg targetdm: Target disk mode protocol over Thunderbolt 132d1ff7024SMika Westerberg extdisp: External display mode protocol over Thunderbolt 133d1ff7024SMika Westerberg 134d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias 135d1ff7024SMika WesterbergDate: Jan 2018 136d1ff7024SMika WesterbergKernelVersion: 4.15 137d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 138d1ff7024SMika WesterbergDescription: Stores the same MODALIAS value emitted by uevent for 139d1ff7024SMika Westerberg the XDomain service. Format: tbtsvc:kSpNvNrN 140d1ff7024SMika Westerberg 141d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcid 142d1ff7024SMika WesterbergDate: Jan 2018 143d1ff7024SMika WesterbergKernelVersion: 4.15 144d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 145d1ff7024SMika WesterbergDescription: This contains XDomain protocol identifier the XDomain 146d1ff7024SMika Westerberg service supports. 147d1ff7024SMika Westerberg 148d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcvers 149d1ff7024SMika WesterbergDate: Jan 2018 150d1ff7024SMika WesterbergKernelVersion: 4.15 151d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 152d1ff7024SMika WesterbergDescription: This contains XDomain protocol version the XDomain 153d1ff7024SMika Westerberg service supports. 154d1ff7024SMika Westerberg 155d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcrevs 156d1ff7024SMika WesterbergDate: Jan 2018 157d1ff7024SMika WesterbergKernelVersion: 4.15 158d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 159d1ff7024SMika WesterbergDescription: This contains XDomain software version the XDomain 160d1ff7024SMika Westerberg service supports. 161d1ff7024SMika Westerberg 162d1ff7024SMika WesterbergWhat: /sys/bus/thunderbolt/devices/<xdomain>.<service>/prtcstns 163d1ff7024SMika WesterbergDate: Jan 2018 164d1ff7024SMika WesterbergKernelVersion: 4.15 165d1ff7024SMika WesterbergContact: thunderbolt-software@lists.01.org 166d1ff7024SMika WesterbergDescription: This contains XDomain service specific settings as 167d1ff7024SMika Westerberg bitmask. Format: %x 168