UDEVADM

НАЗВАНИЕ

udevadm − инструмент управления udev

ОБЗОР

ОПИСАНИЕ

udevadm ожидает команду и специфические для команды опции. Он управляет поведением работающего systemd−udevd, запрашивает события ядра, управляет очередью событий и предоставляет простые механизмы отладки.

ОПЦИИ

−−debug

Выводить отладочные сообщения на стандартный вывод для ошибок.

−−version

Вывести номер версии.

−h, −−help

Вывести текст справки.

udevadm info [ОПЦИИ] [ПУТЬ_К_ФАЙЛУ_УСТРОЙСТВА|ФАЙЛ]
Запрашивает базу данных udev, в которой хранится информация об устройствах. Он также может запрашивать свойства устройства из его представления в sysfs, чтобы помочь в создании правил udev, совпадающих с этим устройством.

−q, −−query=ТИП

Запросить в базе данных указанный тип данных устройства. Опция требует указания −−path или −−name для определения необходимого устройства. Правильными значениями опции являются: name, symlink, path, property, all.

−p, −−path=ПУТЬ_К_ФАЙЛУ_УСТРОЙСТВА

Запрашиваемый путь к устройству в /sys, например [/sys]/class/block/sda. Отметим, что эта опция обычно не очень полезна, поскольку udev может угадать тип аргумента, так что udevadm −−devpath=/class/block/sda равнозначно udevadm /sys/class/block/sda.

−n, −−name=ФАЙЛ

Запрашиваемое имя файла устройства или символическая ссылка, например [/dev]/sda. Отметим, что эта опция обычно не очень полезна, поскольку udev может угадать тип аргумента, так что udevadm −−name=sda равнозначно udevadm /dev/sda.

−r, −−root

Вывести абсолютный путь в запросе имени или символической_ссылки.

−a, −−attribute−walk

Вывести все свойства sysfs для указанного устройства, который можно использовать в правилах udev для совпадения с указанным устройством. Опция выведет все устройства в цепочке вплоть до корня sysfs, что может быть использовано для создания правил udev.

−x, −−export

Напечатать вывод в виде пар ключ−значение. Значения заключаются в одиночные кавычки.

−P, −−export−prefix=ИМЯ

Добавить префикс к имени ключа экспортируемых значений.

−d, −−device−id−of−file=ФАЙЛ

Вывести старший/младший номера нижележащего устройства, на котором находится файл.

−e, −−export−db

Экспортировать содержимое базы данных udev.

−c, −−cleanup−db

Очистить базу данных udev.

−−version

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

−h, −−help

Вывести текст справки.

udevadm trigger [опции]
Запросить события udev из ядра. Обычно используется для повторного воспроизведения событий подсистемой холодного подключения (coldplug).

−v, −−verbose

Вывести список устройств, которые должны быть обработаны.

−n, −−dry−run

Не обрабатывать события на самом деле.

−t, −−type=ТИП

Переключить определённый тип устройств. Возможные значения: devices и subsystems. Значение по умолчанию − devices.

−c, −−action=ДЕЙСТВИЕ

Тип обрабатываемого события. Значение по умолчанию − change ("изменение").

−s, −−subsystem−match=ПОДСИСТЕМА

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

−S, −−subsystem−nomatch=ПОДСИСТЕМА

Не обрабатывать события для устройств, принадлежащих подходящей подсистеме. Эта опция может быть указана несколько раз и поддерживает шаблоны в стиле оболочки shell.

−a, −−attr−match=АТРИБУТ=ЗНАЧЕНИЕ

Обработка событий для устройства, совпадающего с указанным атрибутом sysfs. Если наряду с именем атрибута указано значение, то значение атрибута должно совпадать с указанным шаблоном в стиле оболочки shell. Если значение не указано, будет проверено наличие атрибута sysfs. Эта опция может быть указана несколько раз.

−A, −−attr−nomatch=АТРИБУТ=ЗНАЧЕНИЕ

Не обрабатывать события для устройств с подходящим атрибутом sysfs. Если наряду с именем атрибута указано значение, то значение атрибута должно совпадать с указанным шаблоном в стиле оболочки shell. Если значение не указано, будет проверено наличие атрибута sysfs. Эта опция может быть указана несколько раз.

−p, −−property−match=СВОЙСТВО=ЗНАЧЕНИЕ

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

−g, −−tag−match=СВОЙСТВО

Обработать события для устройств с совпадающей меткой. Эта опция может быть указана несколько раз.

−y, −−sysname−match=ИМЯ

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

−b, −−parent−match=СИСТЕМНЫЙ_ПУТЬ

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

−h, −−help

Вывести текст справки.

udevadm settle [опции]
Наблюдает за очередью событий udev и завершает работу, если все текущие события обработаны.

−t, −−timeout=СЕКУНДЫ

Максимальное количество секунд для ожидания опустошения очереди. Значение по умолчанию − 120 секунд. Значение 0 проверяет, пуста ли очередь и всегда завершается немедленно.

−E, −−exit−if−exists=ФАЙЛ

Перестать ожидать появления файла.

−h, −−help

Вывести текст справки.

udevadm control команда
Изменяет внутреннее состояние запущенного демона udev.

−x, −−exit

Послать сигнал и ждать завершения systemd−udevd.

−l, −−log−priority=значение

Задаёт внутренний уровень журналирования systemd−udevd. Правильными значениями являются числовые приоритеты syslog или их текстовые представления: err, info и debug.

−s, −−stop−exec−queue

Передаёт сигнал systemd−udevd, заставляющий прекратить обработку новых событий. Входящие события будут помещаться в очередь.

−S, −−start−exec−queue

Передаёт сигнал systemd−udevd для включения обработки событий.

−R, −−reload

Послать systemd−udevd сигнал перезагрузки файлов правил и других баз данных, таких как индекс модулей ядра. Перезагрузка правил и баз данных не применяет изменения к уже существующим устройствам; новая конфигурация применяется только к новым событиям.

−p, −−property=КЛЮЧ=ЗНАЧЕНИЕ

Задать глобальное свойство для всех событий.

−m, −−children−max=значение

Задаёт максимальное количество событий, которое systemd−udevd обрабатывает одновременно.

−−timeout=секунды

Максимальное количество секунд для ожидания ответа от systemd−udevd.

−h, −−help

Вывести текст справки.

udevadm monitor [опции]
Прослушивать события ядра и события, поступающие из правил udev и выводить на консоль путь к устройству. Это может использоваться для анализа временных характеристик события, сравнением отметок о времени события в ядре и о времени события в udev.

−k, −−kernel

Вывести события ядра.

−u, −−udev

Вывести событие udev после обработки правила.

−p, −−property

Также вывести свойства события.

−s, −−subsystem−match=строка[/строка]

Фильтровать события по подсистеме[/типу_устройтва]. Проходят только события udev, с указанным значением подсистемы.

−t, −−tag−match=строка

Фильтровать события по свойству. Проходят только события udev, с указанной прикреплённой меткой.

−h, −−help

Вывести текст справки.

udevadm hwdb [опции]
Поддерживать индекс базы данных в /etc/udev/hwdb.bin.

−u, −−update

Скомпилировать базу данных с информацией об оборудовании, находящуюся в /usr/lib/udev/hwdb.d/, /etc/udev/hwdb.d/ и сохраниь её в /etc/udev/hwdb.bin. Это нужно делать после обновления любого из исходных файлов, потому что действие не выполняется автоматически. Работающий демон udev обнаружит новую базу данных сам и уведомлять его об этом не требуется.

−−usr

Поместить скомпилированную базу данных в файл /usr/lib/udev/hwdb.bin. Испольуйте если вы хотите поместить предкомпилированную базу данных в неизменяемый образ системы или не используете /etc/udev/hwdb.d и хотите избежать хранения больших двоичных файлов в каталоге /etc.

−t, −−test=строка

Поиск строки modalias в базе данных и вывести полученные свойства.

−r, −−root=строка

Альтернативный путь к корню в файловой системы для чтения и записи файлов.

−h, −−help

Вывести текст справки.

udevadm test [опции] путь_к_устройству
Симулировать запуск события udev для указанного устройства, и вывести отладочную информацию.

−a, −−action=строка

Строка действия.

−N, −−resolve−names=early|late|never

Укажите, когда udevadm должен преобразовывать имена пользователей и групп. При установке в early (по умолчанию) имена будут преобразованы при разборе правил. При установке в late имена будут преобразовываться при каждом событии. При установке в never имена никогда не преобразуются и все устройства принадлежат пользователю root.

−h, −−help

Вывести текст справки.

udevadm test−builtin [опции] КОМАНДА ПУТЬ_К_ФАЙЛУ_УСТРОЙСТВА
Запустить встроенную команду КОМАНДА для устройства ПУТЬ_К_ФАЙЛУ_УСТРОЙСТВА и вывести отладочную информацию.

−h, −−help

Вывести текст справки.

СМОТРИ ТАКЖЕ

udev(7), systemd−udevd.service(8)

АВТОР ПЕРЕВОДА

Перевод на русский язык выполнил Владимир Ступин <vladimir@stupin.su>.