boltctl - Referenzhandbuch, Optionen, Befehlsbeispiele


NAME

boltctl - Steuern Sie den Thunderbolt-Gerätemanager

ZUSAMMENFASSUNG

boltctl authorize DEVICE
boltctl config
boltctl domains
boltctl enroll DEVICE
boltctl forget DEVICE
boltctl info DEVICE
boltctl list
boltctl monitor
boltctl power

BESCHREIBUNG

boltctl ist die Befehlszeilenschnittstelle zur Interaktion mit boltd, dem System-Daemon, der Thunderbolt 3(TM)-Geräte verwaltet. Damit lässt sich der Zustand von Geräten abfragen und verwalten.

Geräte können über ihre eindeutige Kennung (UUID) global identifiziert werden. Alle Befehle, die eine DEVICE-Kennung annehmen, erwarten diese eindeutige ID.

Wenn kein Befehl angegeben wird, ist dies äquivalent zu

boltctl list

OPTIONEN

--version

Versionsinformationen drucken und beenden.

-U | --uuid {full | short | alias | N}

Steuern Sie, wie UUIDs gedruckt werden. Da es sich um relativ sensible Daten handelt, ist es nicht ratsam, sie in voller Länge öffentlich zu teilen. Stattdessen können und sollten short oder alias verwendet werden, wenn die Ausgabe von boltctl geteilt wird.

full

Drucken Sie alle UUIDs in voller Länge.

short

Alle UUIDs kürzen, sodass nur die ersten 13 Zeichen gedruckt werden.

alias

Alle UUIDs werden durch eine zufällige Zeichenfolge ersetzt, die von der UUID abgeleitet wird, sodass die Geräte eindeutig identifiziert werden können, ohne die ursprüngliche UUID preiszugeben.

N

Wenn eine Ganzzahl N angegeben wird, werden alle UUIDs gekürzt, sodass nur bis N angezeigt wird.

BEFEHLE

authorize [-F | --first-time] DEVICE

Autorisieren Sie ein derzeit nicht autorisiertes Gerät, das über seine eindeutige ID (UUID) DEVICE identifiziert wird. Wenn ein Schlüssel in der Datenbank gespeichert ist, wird er verwendet, sofern die Sicherheitsstufe der Domäne eine sichere Geräteverbindung unterstützt. Verwenden Sie boltctl list, um die UUID eines Geräts herauszufinden.

-F | --first-time

Normalerweise führt boltctl bei dem Versuch, ein bereits autorisiertes Gerät zu autorisieren, nichts aus und gibt einen erfolgreichen Statuscode zurück. Bei Verwendung dieser Option schlägt der Versuch fehl und führt zu einem negativen Exit-Code, wenn das Gerät bereits autorisiert ist.

config --describe [global|domain|device]

Globale Eigenschaften, Domäneneigenschaften oder alle Eigenschaften (sofern nichts angegeben ist) auflisten. Das Format besteht aus 3 Spalten: Berechtigung, Name, Beschreibung. Permission gibt an, ob die Eigenschaft nur lesbar oder auch schreibbar ist.

config KEY [VALUE]

Eine globale Eigenschaft abrufen oder festlegen, wenn VALUE angegeben ist.

config <domain|device>.KEY TARGET [VALUE]

Wenn VALUE angegeben ist, können Sie eine Domänen- oder Geräteeigenschaft abrufen oder festlegen, wobei TARGET die eindeutige ID der Domäne oder des Geräts ist.

domains [-v | --verbose]

Listen Sie alle derzeit aktiven Thunderbolt-Domänen auf. Eine Thunderbolt-Domäne repräsentiert die Thunderbolt-Controller-Hardware. Für jeden im System vorhandenen Thunderbolt-Controller gibt es eine Domäne (und ein Hostgerät). Die Eigenschaft security zeigt die Sicherheitsstufe des Controllers an. Wenn die iommu-Unterstützung aktiv ist (siehe die boltd-Manpage), wird dies durch das Suffix +iommu für „secure“ oder „user“ angezeigt. Modus oder einfach iommu, falls die Sicherheitsstufe „none“ (sl0) ist. bootacl zeigt die verwendeten und gesamten Slots der Boot Access Control List (BootACL) und den Inhalt aller nicht leeren Einträge. Hinweis: Wenn BootACL nicht unterstützt wird, wird für beide 0 angezeigt (0/0). Die Eigenschaft online zeigt an, ob der Thunderbolt-Controller derzeit von der Firmware mit Strom versorgt wird. Hinweis: Wenn der Controller derzeit offline ist, spiegelt die BootACL-Liste wider, wie boltd schätzt, wie die Liste aussehen wird, sobald der Controller wieder online ist und lokale Änderungen mit dem Controller synchronisiert wurden . Dies ist möglicherweise nicht korrekt, wenn die Liste in der Zwischenzeit geändert wurde, z. B. von einer anderen Installation oder einem anderen Betriebssystem.

enroll [--policy policy] DEVICE

Autorisieren und erfassen Sie das Gerät mit der eindeutigen ID DEVICE in der Datenbank. Wenn die Domäne eine sichere Verbindung unterstützt, wird ein neuer Schlüssel generiert und zusammen mit dem Gerätenamen und dem Herstellernamen in der Datenbank gespeichert. Der Schlüssel wird, sofern er erstellt wurde, in Zukunft zur sicheren Autorisierung des Geräts verwendet.

--policy {default | auto | manual}

Geben Sie die Richtlinie an, die für das neu registrierte Gerät verwendet werden soll.

default

Verwenden Sie die globale Standardrichtlinie des Daemons. Dies kann geändert werden, ist aber normalerweise auch automatisch.

auto

Autorisieren Sie dieses Gerät automatisch, wenn es angeschlossen wird.

manual

Autorisieren Sie das Gerät nicht automatisch; Stattdessen ist eine manuelle Autorisierung über boltctlauthorize erforderlich.

forget DEVICE

Entfernen Sie die Informationen über das Gerät mit der eindeutigen ID DEVICE aus der Datenbank. Dazu gehört auch der Schlüssel, falls zuvor einer generiert wurde. Wenn Sie --all anstelle von DEVICE übergeben, werden alle Geräte entfernt und nicht nur eines.

info DEVICE

Zeigt Informationen über das Gerät mit der eindeutigen ID DEVICE an.

list [-a | --all]

Informationen zu allen angeschlossenen und gespeicherten Geräten auflisten und ausdrucken.

-a | --all

Normalerweise werden nur Peripheriegeräte als Gerätetyp angezeigt. Daher wird das Gerät, das den Host selbst darstellt, weggelassen. Wenn Sie diese Option verwenden, werden stattdessen alle Gerätetypen in die Liste aufgenommen.

monitor

Hören Sie auf Änderungen an angeschlossenen Geräten und zeigen Sie diese an.

power [-t | --timeout seconds] [-q | --query]

Schalten Sie den Thunderbolt-Controller ein. Wenn sich der Thunderbolt-Controller nicht im „nativen Aufzählungsmodus“ befindet, kann er durch die Host-Firmware/das BIOS vollständig heruntergefahren werden. Auf unterstützten Systemen gibt es eine Schnittstelle zur „erzwungenen“ Stromversorgung des Thunderbolt-Controllers. Wenn dieser Befehl unterstützt wird, fordert er den Daemon dazu auf. Der Daemon verfolgt alle Client-Anfragen und gibt die erzwungene Stromüberschreibung frei, wenn die letzte Anfrage freigegeben wird.

-t | --timeout seconds

Geben Sie die Force-Power-Anforderung nach der angegebenen Anzahl von Sekunden frei und beenden Sie den Vorgang.

-q | --query

Fragen Sie den aktuellen Force-Power-Status des Daemons ab.

AUTOR

Geschrieben von Christian Kellner .