boltctl - справочное руководство, опции, примеры команд

ИМЯ

boltctl - управлять диспетчером устройств Thunderbolt

СИНТАКСИС

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

ОПИСАНИЕ

boltctl — это интерфейс командной строки для взаимодействия с boltd, системным демоном, который управляет устройствами Thunderbolt 3(TM). Его можно использовать для запроса состояния устройств, а также для управления ими.

Устройства можно глобально идентифицировать по их уникальному идентификатору (uuid). Все команды, принимающие идентификатор DEVICE, ожидают этот уникальный идентификатор.

Если команда не дана, она эквивалентна

boltctl list

ПАРАМЕТРЫ

--version

Вывести информацию о версии и выйти.

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

Контролируйте, как печатаются UUID. Поскольку они являются в некоторой степени конфиденциальными данными, не рекомендуется публиковать их в полном объеме. Вместо этого short или псевдоним можно и нужно использовать при совместном использовании выходных данных boltctl.

full: Выведите все UUID в полную длину.
short: Сократите все UUID, чтобы печатались только первые 13 символов.
alias: Все UUID заменяются случайной строкой, полученной из UUID, поэтому устройства могут быть однозначно идентифицированы без раскрытия исходного UUID.
N: Если указано целое число N, все UUID усекаются и отображаются только до N.

КОМАНДЫ

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

Авторизовать неавторизованное в данный момент устройство, идентифицированное по его уникальному идентификатору (uuid) DEVICE. Если ключ хранится в базе данных, он будет использоваться, если уровень безопасности домена поддерживает безопасное подключение устройств. Используйте boltctl list, чтобы узнать UUID устройства.

-F | --first-time

Обычно при попытке авторизации уже авторизованного устройства boltctl ничего не делает и возвращает успешный код состояния. При использовании этой опции попытка будет неудачной и приведет к отрицательному коду выхода, если устройство уже авторизовано.

config --describe [global|domain|device]

Список глобальных, доменных или всех (если ничего не указано) свойств. Формат 3 столбца: разрешение, имя, описание. Разрешение указывает, доступно ли свойство только для чтения или также может быть записано.

config KEY [VALUE]

Получить или установить, если указано VALUE, глобальное свойство.

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

Получите или задайте, если указано VALUE, свойство домена или устройства, где TARGET — уникальный идентификатор домена или устройства.

domains [-v | --verbose]

Список всех активных на данный момент доменов Thunderbolt. Домен Thunderbolt представляет аппаратное обеспечение контроллера Thunderbolt. Для каждого контроллера Thunderbolt, присутствующего в системе, будет один домен (и хост-устройство). Свойство security показывает уровень безопасности контроллера. Если поддержка iommu активна (см. справочную страницу boltd), это будет обозначено суффиксом +iommu для «безопасного» или «пользовательского». или просто iommu в случае, если уровень безопасности "none" (sl0). bootacl показывает использованные и общие слоты списка управления доступом к загрузке (BootACL), а также содержимое всех непустых записей. NB: если BootACL не поддерживается, он покажет 0 для обоих (0/0). Свойство онлайн показывает, работает ли контроллер Thunderbolt в настоящее время с микропрограммой. Примечание: если контроллер в данный момент находится в автономном режиме, список BootACL будет отражать то, что, по оценке boltd, список будет выглядеть после того, как контроллер снова подключится к сети и локальные изменения будут синхронизированы с контроллером. . Это может быть неточным, если список был изменен тем временем, например. из другой установки или ОС.

enroll [--policy policy] DEVICE

Авторизуйте и запишите устройство с уникальным идентификатором DEVICE в базу данных. Если домен поддерживает безопасное соединение, новый ключ будет сгенерирован и сохранен в базе данных вместе с именем устройства и именем поставщика. Ключ, если он будет создан, будет использоваться в будущем для безопасной авторизации устройства.

--policy {default | auto | manual}

Укажите политику, которая будет использоваться для вновь зарегистрированного устройства.
default
Используйте глобальную политику демона по умолчанию; это можно изменить, но обычно это также автоматически.
auto
Автоматически авторизовать это устройство при каждом его подключении.
manual
Не не автоматически авторизовать устройство; вместо этого требуется ручная авторизация через boltctl authorize.

forget DEVICE

Удалите информацию об устройстве с уникальным идентификатором DEVICE из базы данных. Сюда входит ключ, если он был сгенерирован ранее. Если вы передадите --all вместо DEVICE, будут удалены все устройства, а не только одно.

info DEVICE

Отображение информации об устройстве с уникальным идентификатором DEVICE.

list [-a | --all]

Перечислите и распечатайте информацию обо всех подключенных и сохраненных устройствах.

-a | --all

Обычно единственным типом устройств, которые будут показаны, являются периферийные устройства. Поэтому устройство, представляющее сам хост, будет опущено. Вместо этого при использовании этой опции в список будут включены все типы устройств.

monitor

Слушайте и показывайте изменения в подключенных устройствах.

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

Включите контроллер Thunderbolt. Если контроллер Thunderbolt не находится в «собственном режиме перечисления», он может быть полностью отключен микропрограммой хоста/BIOS. В поддерживаемых системах есть интерфейс для принудительного включения контроллера Thunderbolt. Если эта команда поддерживается, она запросит это у демона. Демон будет отслеживать все клиентские запросы и отключит принудительное отключение питания, когда будет выпущен последний запрос.

-t | --timeout seconds

Отпустите запрос на принудительное питание через указанное количество секунд и выйдите.

-q | --query

Запросить текущее состояние принудительной мощности демона.

АВТОР

Автор Кристиан Келлнер ckellner@redhat.com.