Current File : //usr/share/dbus-1/interfaces/org.freedesktop.bolt.xml
<!DOCTYPE node PUBLIC
"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
<interface name="org.freedesktop.bolt1.Manager">
<doc:doc>
<doc:description>
<doc:para>
Thunderbolt device management.
</doc:para>
</doc:description>
</doc:doc>
<property name="Version" type="u" access="read">
<doc:doc><doc:description><doc:para>
Version of the daemon.
</doc:para></doc:description></doc:doc>
</property>
<property name="Probing" type="b" access="read">
<doc:doc><doc:description><doc:para>
Indication that a new thunderbolt device has been connected
and the manager is reacting to that. Probing should be
true as long as the new device (and any possible attached
peripherals) are initialized by the system.
</doc:para></doc:description></doc:doc>
</property>
<property name="DefaultPolicy" type="s" access="read">
<doc:doc><doc:description><doc:para>
The policy to use during enrollment when "default" was
specified.
</doc:para></doc:description></doc:doc>
</property>
<property name="SecurityLevel" type="s" access="read">
<doc:doc><doc:description><doc:para>
The security level of the system.
</doc:para></doc:description></doc:doc>
</property>
<property name="AuthMode" type="s" access="readwrite">
<doc:doc><doc:description><doc:para>
The authorization mode of the daemon. Currently supported
values are "enabled" if it is authorizing devices or
"disabled" if authorization is disabled.
</doc:para></doc:description></doc:doc>
</property>
<property name="PowerState" type="s" access="read">
<doc:doc><doc:description><doc:para>
State of the ForcePower setting of the bolt daemon.
</doc:para></doc:description></doc:doc>
</property>
<property name="Generation" type="u" access="read">
<doc:doc><doc:description><doc:para>
The maximum generation of any of Thunderbolt controller
associated with the device. It will contain 4 for USB4,
3 for Thunderbolt 3.
</doc:para></doc:description></doc:doc>
</property>
<!-- methods -->
<method name="ListDomains">
<arg name="domains" direction="out" type="ao">
<doc:doc><doc:summary>An array of object paths for the domains.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
List all active thunderbolt domains.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="DomainById">
<arg type='s' name='id' direction='in'>
<doc:doc><doc:summary>The id of the domain. </doc:summary></doc:doc>
</arg>
<arg name="domain" direction="out" type="o">
<doc:doc><doc:summary>Object path for the domain.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Return a domain given its identifier.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="ListDevices">
<arg name="devices" direction="out" type="ao">
<doc:doc><doc:summary>An array of object paths for the devices.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
List all known devices, i.e. connected or stored in the database.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="DeviceByUid">
<arg type='s' name='uid' direction='in'>
<doc:doc><doc:summary>The unique id of the device. </doc:summary>
</doc:doc>
</arg>
<arg name="device" direction="out" type="o">
<doc:doc><doc:summary>Object path for the devices.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Return a device given its unique identifier.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="EnrollDevice">
<arg type='s' name='uid' direction='in'>
<doc:doc><doc:summary>The unique id of the device.</doc:summary>
</doc:doc>
</arg>
<arg type='s' name='policy' direction='in'>
<doc:doc><doc:summary>Policy to use for the device.</doc:summary>
</doc:doc>
</arg>
<arg type='s' name='flags' direction='in'>
<doc:doc><doc:summary>Control aspects of enrollment.</doc:summary>
</doc:doc>
</arg>
<arg name="device" direction="out" type="o">
<doc:doc><doc:summary>Object path for the devices.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Authorize a device, and on success, store the device in the database.
If policy is set to "Auto", the device will be automatically authorized
in the future.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="ForgetDevice">
<arg type='s' name='uid' direction='in'>
<doc:doc><doc:summary>The unique id of the device.</doc:summary>
</doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Remove the device and any associated information,
such as the policy and its key, from the store.
</doc:para>
</doc:description>
</doc:doc>
</method>
<!-- signals -->
<signal name="DeviceAdded">
<arg name="device" type="o">
<doc:doc><doc:summary>Object path of the new device.</doc:summary></doc:doc>
</arg>
<doc:doc><doc:description><doc:para>
A new device was added.
</doc:para></doc:description></doc:doc>
</signal>
<signal name="DeviceRemoved">
<arg name="device" type="o">
<doc:doc><doc:summary>Object path of the removed device.</doc:summary></doc:doc>
</arg>
<doc:doc><doc:description><doc:para>
A device was removed.
</doc:para></doc:description></doc:doc>
</signal>
<signal name="DomainAdded">
<arg name="domain" type="o">
<doc:doc><doc:summary>Object path of the domain.</doc:summary></doc:doc>
</arg>
<doc:doc><doc:description><doc:para>
A thunderbolt domain was added.
</doc:para></doc:description></doc:doc>
</signal>
<signal name="DomainRemoved">
<arg name="domain" type="o">
<doc:doc><doc:summary>Object path of the removed domain.</doc:summary></doc:doc>
</arg>
<doc:doc><doc:description><doc:para>
A thunderbolt domain was removed.
</doc:para></doc:description></doc:doc>
</signal>
</interface>
<interface name="org.freedesktop.bolt1.Power">
<doc:doc>
<doc:description>
<doc:para>
Thunderbolt force power management.
</doc:para>
</doc:description>
</doc:doc>
<property name="Supported" type="b" access="read">
<doc:doc><doc:description><doc:para>
Is there system level support for force powering the
thunderbolt controller.
</doc:para></doc:description></doc:doc>
</property>
<property name="State" type="s" access="read">
<doc:doc><doc:description><doc:para>
State of the ForcePower setting of the bolt daemon.
</doc:para></doc:description></doc:doc>
</property>
<property name="Timeout" type="u" access="read">
<doc:doc><doc:description><doc:para>
The minimum amount of time the controller will be powered.
This timeout will get reset with every new activity on the
thundrbolt bus while the controller is being force powered.
</doc:para></doc:description></doc:doc>
</property>
<!-- methods -->
<method name="ForcePower">
<arg type='s' name='who' direction='in'>
<doc:doc><doc:summary>Who is requesting the force power op.</doc:summary>
</doc:doc>
</arg>
<arg type='s' name='flags' direction='in'>
<doc:doc><doc:summary>Control aspects of the force power operation.</doc:summary>
</doc:doc>
</arg>
<arg name="guard_fd" direction="out" type="h">
<doc:doc><doc:summary>File descriptor reference to the guard.</doc:summary></doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Force power the thunderbolt controller, if supported.
</doc:para>
</doc:description>
</doc:doc>
</method>
<method name="ListGuards">
<arg type='a(ssu)' name='guards' direction='out'>
<doc:doc>
<doc:summary>
<doc:para>
Array of guard information, containing the "id", "who" and the pid
of the guard.
</doc:para>
</doc:summary>
</doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
List active internal and external power guards.
</doc:para>
</doc:description>
</doc:doc>
</method>
</interface>
<interface name="org.freedesktop.bolt1.Device">
<doc:doc>
<doc:description>
<doc:para>
Representation of a single Thunderbolt device.
</doc:para>
</doc:description>
</doc:doc>
<property name="Uid" type="s" access="read">
<doc:doc><doc:description><doc:para>
The unique-id of the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="Name" type="s" access="read">
<doc:doc><doc:description><doc:para>
The name of the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="Vendor" type="s" access="read">
<doc:doc><doc:description><doc:para>
The vendor of the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="Type" type="s" access="read">
<doc:doc><doc:description><doc:para>
The type of the device, i.e. 'host' or 'peripheral'
</doc:para></doc:description></doc:doc>
</property>
<property name="Generation" type="u" access="read">
<doc:doc><doc:description><doc:para>
The generation of the Thunderbolt controller associated
with the device. It will contain 4 for USB4, 3 for
Thunderbolt 3.
</doc:para></doc:description></doc:doc>
</property>
<property name="Status" type="s" access="read">
<doc:doc><doc:description><doc:para>
The current status of the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="AuthFlags" type="s" access="read">
<doc:doc><doc:description><doc:para>
Details of authorization information, including
if they device was securily authorized via key
verification ('secure') or does not support
this method ('nokey'). The flag 'boot' indicates
that the devices was already authorized by
the firmware during pre-boot.
If no downstream PCIe tunnels are authorized
the 'nopcie' flag will be set.
</doc:para></doc:description></doc:doc>
</property>
<property name="Parent" type="s" access="read">
<doc:doc><doc:description><doc:para>
The unique id of the parent the device. The only
device without a parent will be the device that
represents the host controller.
</doc:para></doc:description></doc:doc>
</property>
<property name="SysfsPath" type="s" access="read">
<doc:doc><doc:description><doc:para>
The sysfs path of the device, if it is connected.
</doc:para></doc:description></doc:doc>
</property>
<property name="Domain" type="s" access="read">
<doc:doc><doc:description><doc:para>
When a device is connected, it always is connected
via a thunderbolt domain, directly or via a chain of
other devices. This is the identifier of the domain.
</doc:para></doc:description></doc:doc>
</property>
<property name="Stored" type="b" access="read">
<doc:doc><doc:description><doc:para>
Indication if the device is stored.
</doc:para></doc:description></doc:doc>
</property>
<property name="Policy" type="s" access="readwrite">
<doc:doc><doc:description><doc:para>
The authorization policy of the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="Key" type="s" access="read">
<doc:doc><doc:description><doc:para>
If a key is associated with the device.
</doc:para></doc:description></doc:doc>
</property>
<property name="Label" type="s" access="readwrite">
<doc:doc><doc:description><doc:para>
If set, a name that was given to the device by
the user. Can only be set when device is stored.
</doc:para></doc:description></doc:doc>
</property>
<property name="ConnectTime" type="t" access="read">
<doc:doc><doc:description><doc:para>
Point in time (since Epoch, in seconds) when the
device was connected (0 if it is not connected).
</doc:para></doc:description></doc:doc>
</property>
<property name="AuthorizeTime" type="t" access="read">
<doc:doc><doc:description><doc:para>
Point in time (since Epoch, in seconds) when the
device was authorized (0 if it is not authorized).
</doc:para></doc:description></doc:doc>
</property>
<property name="StoreTime" type="t" access="read">
<doc:doc><doc:description><doc:para>
Point in time (since Epoch, in seconds) when the
device was stored (0 if it is not stored).
</doc:para></doc:description></doc:doc>
</property>
<property name="LinkSpeed" type="a{su}" access="read">
<doc:doc><doc:description><doc:para>
Information about the link speed, i.e. with how
many lanes the device is connected to its parent
and what rate (in Gb/s) the lanes have. Separate
information is reported for transmission (tx) and
reception (rx). All lanes in one direction have
the same rate.
</doc:para></doc:description></doc:doc>
</property>
<!-- methods -->
<method name="Authorize">
<arg type='s' name='flags' direction='in'>
<doc:doc><doc:summary>Control aspects of authorization.</doc:summary>
</doc:doc>
</arg>
<doc:doc>
<doc:description>
<doc:para>
Authorize the device.
</doc:para>
</doc:description>
</doc:doc>
</method>
</interface>
<interface name="org.freedesktop.bolt1.Domain">
<doc:doc>
<doc:description>
<doc:para>
Representation of a Thunderbolt domain.
</doc:para>
</doc:description>
</doc:doc>
<property name="Uid" type="s" access="read">
<doc:doc><doc:description><doc:para>
The unique-id of the domain.
</doc:para></doc:description></doc:doc>
</property>
<property name="Id" type="s" access="read">
<doc:doc><doc:description><doc:para>
The (sysfs) id of the domain.
</doc:para></doc:description></doc:doc>
</property>
<property name="SysfsPath" type="s" access="read">
<doc:doc><doc:description><doc:para>
The sysfs path of the domain, if it is connected.
</doc:para></doc:description></doc:doc>
</property>
<property name="SecurityLevel" type="s" access="read">
<doc:doc><doc:description><doc:para>
The security level of the domain.
</doc:para></doc:description></doc:doc>
</property>
<property name="BootACL" type="as" access="readwrite">
<doc:doc><doc:description><doc:para>
The boot access control list.
</doc:para></doc:description></doc:doc>
</property>
<property name="IOMMU" type="b" access="read">
<doc:doc><doc:description><doc:para>
The input output memory management unit (IOMMU)
can used on recent hardware in combination with
recent kernel versions to protect against attacks,
like direct memory access (DMA) attacks, at the
hardware level. If this property is true than
IOMMU hardware protection is active.
</doc:para></doc:description></doc:doc>
</property>
</interface>
</node>
Mini Shell