boltctl - instrukcja obsługi, opcje, przykłady poleceń


NAZWA

boltctl - kontroluj menedżera urządzeń piorunowych

STRESZCZENIE

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

OPIS

boltctl to interfejs wiersza poleceń do interakcji z boltd, demonem systemowym zarządzającym urządzeniami Thunderbolt 3(TM). Może być używany do sprawdzania stanu urządzeń, a także do zarządzania nimi.

Urządzenia można globalnie identyfikować za pomocą ich unikalnego identyfikatora (uuid). Wszystkie polecenia, które przyjmują identyfikator DEVICE, oczekują tego unikalnego identyfikatora.

Jeśli nie podano żadnego polecenia, jest to równoważne z

boltctl list

OPCJE

--version

Wydrukuj informacje o wersji i wyjdź.

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

Kontroluj sposób drukowania identyfikatorów UUID. Ponieważ są to dość wrażliwe dane, nie zaleca się ich publicznego udostępniania w pełnej długości. Zamiast short lub alias można i należy używać podczas udostępniania danych wyjściowych boltctl.

full

Wydrukuj wszystkie identyfikatory UUID w pełnej długości.

short

Skróć wszystkie identyfikatory UUID, aby wydrukować tylko pierwszych 13 znaków.

alias

Wszystkie identyfikatory UUID są zastępowane losowym ciągiem znaków pochodzącym z identyfikatora UUID, dzięki czemu urządzenia można jednoznacznie zidentyfikować bez ujawniania oryginalnego identyfikatora UUID.

N

Jeśli podano liczbę całkowitą N, wszystkie identyfikatory UUID są obcinane tak, aby wyświetlały się maksymalnie N.

POLECENIA

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

Autoryzuj obecnie nieautoryzowane urządzenie identyfikowane za pomocą jego unikalnego identyfikatora (uuid) DEVICE. Jeśli klucz jest przechowywany w bazie danych, zostanie użyty, biorąc pod uwagę poziom bezpieczeństwa domeny obsługujący bezpieczne połączenie urządzenia. Użyj boltctl list, aby znaleźć numer UUID urządzenia.

-F | --first-time

Zwykle podczas próby autoryzacji już autoryzowanego urządzenia boltctl nic nie zrobi i zwróci pomyślny kod statusu. Podczas korzystania z tej opcji próba zakończy się niepowodzeniem i spowoduje negatywny kod wyjścia, jeśli urządzenie jest już autoryzowane.

config --describe [global|domain|device]

Wyświetl listę właściwości globalnych, domenowych lub wszystkich (jeśli nic nie określono). Format to 3 kolumny: pozwolenie, nazwa, opis. Uprawnienie wskazuje, czy właściwość jest tylko do odczytu, czy też może być zapisywana.

config KEY [VALUE]

Pobierz lub ustaw, jeśli określono VALUE, właściwość globalną.

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

Pobierz lub ustaw, jeśli określono WARTOŚĆ, właściwość domeny lub urządzenia, gdzie TARGET to unikalny identyfikator domeny lub urządzenia.

domains [-v | --verbose]

Wyświetl listę wszystkich aktualnie aktywnych domen Thunderbolt. Domena Thunderbolt reprezentuje sprzęt kontrolera Thunderbolt. Dla każdego kontrolera Thunderbolt obecnego w systemie będzie przypisana jedna domena (i urządzenie hosta). Właściwość security pokazuje poziom bezpieczeństwa kontrolera. Jeśli obsługa iommu jest aktywna (zobacz stronę podręcznika boltd), będzie to oznaczone sufiksem +iommu dla „bezpiecznego” lub „użytkownika” trybie lub po prostu iommu w przypadku, gdy poziom bezpieczeństwa to „brak” (sl0). bootacl pokazuje zajęte i całkowite miejsca na liście kontroli dostępu do rozruchu (BootACL) oraz zawartość wszystkich niepustych wpisów. Uwaga: jeśli BootACL nie jest obsługiwany, wyświetli się 0 dla obu (0/0). Właściwość online pokazuje, czy kontroler Thunderbolt jest obecnie zasilany przez oprogramowanie układowe. Uwaga: jeśli kontroler jest obecnie offline, lista BootACL będzie odzwierciedlać szacunki boltd, jak będzie wyglądać po powrocie kontrolera do trybu online i zsynchronizowaniu lokalnych zmian z kontrolerem . Może to nie być dokładne, jeśli lista została w międzyczasie zmodyfikowana, np. z innej instalacji lub systemu operacyjnego.

enroll [--policy policy] DEVICE

Autoryzuj i zapisz urządzenie z unikalnym identyfikatorem DEVICE w bazie danych. Jeśli domena obsługuje bezpieczne połączenie, nowy klucz zostanie wygenerowany i zapisany w bazie danych wraz z nazwą urządzenia i nazwą dostawcy. Klucz, jeśli zostanie utworzony, będzie używany w przyszłości do bezpiecznej autoryzacji urządzenia.

--policy {default | auto | manual}

Określ zasady, które mają być używane dla nowo zarejestrowanego urządzenia.

default

Użyj globalnej domyślnej polityki demona; można to zmienić, ale zwykle jest to również auto.

auto

Automatycznie autoryzuj to urządzenie, gdy jest podłączone.

manual

Nie automatycznie autoryzuj urządzenia; zamiast tego wymagaj ręcznej autoryzacji za pomocą autoryzacji Boltctl.

forget DEVICE

Usuń informacje o urządzeniu o unikalnym identyfikatorze DEVICE z bazy danych. Obejmuje to klucz, jeśli został wcześniej wygenerowany. Jeśli przekażesz --all zamiast URZĄDZENIE, wszystkie urządzenia zostaną usunięte zamiast tylko jednego.

info DEVICE

Wyświetl informacje o urządzeniu z unikalnym identyfikatorem DEVICE.

list [-a | --all]

Wyświetlaj i drukuj informacje o wszystkich podłączonych i zapisanych urządzeniach.

-a | --all

Zwykle jedynym typem urządzenia, który zostanie wyświetlony, są urządzenia peryferyjne. W związku z tym urządzenie reprezentujące samego hosta zostanie pominięte. Użycie tej opcji zamiast tego spowoduje uwzględnienie wszystkich typów urządzeń na liście.

monitor

Słuchaj i pokazuj zmiany w podłączonych urządzeniach.

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

Włącz kontroler Thunderbolt. Jeśli kontroler Thunderbolt nie jest w „natywnym trybie wyliczania”, może zostać całkowicie wyłączony przez oprogramowanie układowe hosta/BIOS. Na obsługiwanych systemach dostępny jest interfejs do „wymuszenia” zasilania kontrolera piorunów. Jeśli jest obsługiwane, to polecenie poprosi o to demona. Demon będzie śledził wszystkie żądania klientów i zwolni obejście siły, gdy ostatnie żądanie zostanie zwolnione.

-t | --timeout seconds

Zwolnij żądanie zasilania po określonej liczbie sekund i wyjdź.

-q | --query

Zapytanie o bieżący stan zasilania demona.

AUTOR

Napisane przez Christiana Kellnera .