busctl - Интернет в облаке

ПРОГРАММА:

ИМЯ

busctl - исследует автобус

СИНТАКСИС

Busctl [ОПЦИИ ...] [КОМАНДА] [ИМЯ...]

ОПИСАНИЕ

Busctl может использоваться для самоанализа и мониторинга шины D-Bus.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Подразумеваются следующие варианты:

--address =АДРЕС
Подключитесь к шине, указанной АДРЕС вместо использования подходящих значений по умолчанию для
системная или пользовательская шина (см. --система и --Пользователь параметры).

- шоу-машина
При отображении списка одноранговых узлов показывайте столбец, содержащий имена контейнеров, которые они
принадлежать. Видеть systemd-machined.service(8).

--уникальный
При отображении списка пиров показывать только «уникальные» имена (вида
":номер.номер").

--приобретенный
Противоположно --уникальный - будут показаны только «известные» имена.

--активируемый
При отображении списка одноранговых узлов показывать только одноранговые узлы, которые фактически не были активированы.
еще, но может быть запущен автоматически при доступе.

--match =МАТЧ
При отображении сообщений, которыми обмениваются, показывать только совпадение подмножества МАТЧ.

--size =
При использовании с захватить команда, задает максимальный размер сообщения шины для захвата
("снэплен"). По умолчанию 4096 байт.

--список
При использовании с дерево показывает плоский список путей к объектам вместо дерева.

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

--подробный
При использовании с призывают or получить собственность команда, показывает вывод более подробным
формат.

- ожидать-ответ =BOOL
При использовании с призывают команда, указывает, Busctl будет ждать завершения
вызов метода, вывести возвращенные данные ответа метода и вернуть успех или
сбой через код выхода процесса. Если установлено «нет», вызов метода будет
выдается, но ответа не ожидается, инструмент немедленно завершает работу, и, следовательно, нет
может быть показан ответ, и код выхода не возвращает ни успеха, ни неудачи. К
подавлять только вывод полезной нагрузки ответного сообщения, используйте --тихий выше. По умолчанию
"да".

--auto-start =BOOL
При использовании с призывают команда, указывает, должен ли вызов метода неявно
активируйте вызываемую службу, если она еще не запущена, но настроена для работы
автозапуск. По умолчанию "да".

--allow-interactive-authorization =BOOL
При использовании с призывают команда, указывает, могут ли службы принудительно
интерактивная авторизация при выполнении операции, если политика безопасности
настроен для этого. По умолчанию "да".

--timeout =SECS
При использовании с призывают команда, указывает максимальное время ожидания вызова метода
завершение. Если единица времени не указана, предполагается секунды. Обычные другие единицы
тоже понял (ms, us, s, min, h, d, w, month, y). Обратите внимание, что этот тайм-аут не
применять, если --expect-reply = нет используется, так как инструмент не ждет ответного сообщения
тогда. Если не указано или установлено значение 0, предполагается значение по умолчанию «25 с».

--augment-creds =BOOL
Контролирует, отправляет ли учетные данные список or статус должен быть дополнен
данные из / proc. Когда он включен, показанные данные могут быть несовместимы, так как
данные, прочитанные из / Proc может быть более поздним, чем остальные учетные данные
Информация. По умолчанию "да".

--Пользователь
Поговорите с менеджером службы вызывающего пользователя, а не с менеджером службы
системы.

--система
Поговорите с сервисным менеджером системы. Это подразумеваемое значение по умолчанию.

-H, --host =
Выполните операцию удаленно. Укажите имя хоста или имя пользователя и имя хоста
разделены "@", чтобы подключиться. Имя хоста может быть дополнено суффиксом
имя контейнера, разделенное знаком ":", которое напрямую подключается к определенному контейнеру на
указанный хост. Это будет использовать SSH для связи с экземпляром удаленного диспетчера машины.
Имена контейнеров могут быть перечислены с машинаctl -H ВЕДУЩИЙ.

-M, --machine =
Выполнить операцию на локальном контейнере. Укажите имя контейнера для подключения.

--нет-пейджер
Не передавайте вывод в пейджер.

- нет легенды
Не печатайте легенду, то есть заголовки столбцов и нижний колонтитул с подсказками.

-h, --Помогите
Распечатайте короткий текст справки и выйдите.

--версия
Распечатайте короткую строку и выйдите из нее.

КОМАНДЫ

Понятны следующие команды:

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

статус [СЕРВИС]
Показать информацию о процессе и учетные данные автобусной службы (если она указана в ее
уникальное или общеизвестное имя), процесс (если он указан его числовым PID) или
владелец автобуса (если не указан параметр).

монитор [СЕРВИС...]
Дамп сообщений, которыми обмениваются. Если СЕРВИС указано, показывать сообщения к или от этого
одноранговый узел, идентифицируемый своим общеизвестным или уникальным именем. В противном случае показывать все сообщения на
автобус. Используйте Ctrl-C для завершения дампа.

захватить [СЕРВИС...]
Похожий на что монитор но записывает вывод в формате pcap (подробности см. Либкап
Файл Формат[1] описание. Обязательно перенаправьте вывод в STDOUT в файл.
Такие инструменты, как Wireshark(1) может использоваться для анализа и просмотра сгенерированных файлов.

дерево [СЕРВИС...]
Показывает дерево объектов одной или нескольких служб. Если СЕРВИС указано, показать объект
только дерево указанных сервисов. В противном случае показать все деревья объектов всех сервисов
в автобусе, который приобрел хотя бы одно известное имя.

Introspect СЕРВИС ОБЪЕКТ [ИНТЕРФЕЙС]
Показать интерфейсы, методы, свойства и сигналы указанного объекта (идентифицированного
по его пути) на указанном сервисе. Если передан аргумент интерфейса, вывод
ограничено членами указанного интерфейса.

призывают СЕРВИС ОБЪЕКТ ИНТЕРФЕЙС МЕТОД [ПОДПИСЬ [АРГУМЕНТ...]]
Вызвать метод и показать ответ. Принимает имя службы, путь к объекту, интерфейс
имя и название метода. Если параметры должны быть переданы в вызов метода, подпись
требуется строка, за которой следуют аргументы, индивидуально оформленные в виде строк. Для
подробности об используемом форматировании см. ниже. Чтобы подавить вывод возвращенных данных,
использовать --тихий опцию.

получить собственность СЕРВИС ОБЪЕКТ ИНТЕРФЕЙС ИМУЩЕСТВО...
Получить текущее значение одного или нескольких свойств объекта. Принимает имя службы,
путь к объекту, имя интерфейса и имя свойства. Несколько свойств могут быть указаны в
один раз, и в этом случае их значения будут показаны одно за другим, разделенные знаком
новые строки. По умолчанию выходные данные имеют краткий формат. Использовать --подробный для более
продуманный выходной формат.

набор-свойство СЕРВИС ОБЪЕКТ ИНТЕРФЕЙС ИМУЩЕСТВО ПОДПИСЬ АРГУМЕНТ...
Установите текущее значение свойства объекта. Принимает имя службы, путь к объекту,
имя интерфейса, имя свойства, подпись свойства, за которым следует список параметров
отформатированы как строки.

помощь
Показать справку по синтаксису команд.

ПАРАМЕТР ФОРМАТИРОВАНИЕ

Ассоциация призывают и набор-свойство команды принимают строку подписи, за которой следует список
параметры, отформатированные в виде строки (подробнее о строках подписи D-Bus см. Тип
система глава of домен D-автобус Спецификация[2]). Для простых типов каждый параметр, следующий за
подпись должна быть просто значением параметра, отформатированным в виде строки. Положительное логическое значение
значения могут быть отформатированы как «истина», «да», «включено» или «1»; отрицательные логические значения могут быть
указано как «ложь», «нет», «выкл» или «0». Для массивов числовой аргумент числа
записей, за которыми следуют записи. Для вариантов подпись
должно быть указано содержание, а затем содержание. Для словарей и структур
их содержание должно быть прямо указано.

Например,

с челюстью

форматирование одной строки "jawoll".

как 3 привет мир foobar

- это форматирование массива строк с тремя записями: «hello», «world» и «foobar».

a {sv} 3 One s Eins Two u 2 Да b верно

форматирование словарного массива, который отображает строки в варианты, состоящие из трех
записи. Строке «One» соответствует строка «Eins». Строке «Два» присваивается
32-битное целое число без знака 2. Строке «Да» присваивается положительное логическое значение.

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

ПРИМЕРЫ

Пример 1. Написать и Читать a Объект

Следующие две команды сначала записывают свойство, а затем читают его. Имущество
находится в объекте "/ org / freedesktop / systemd1" службы "org.freedesktop.systemd1".
Имя свойства - «LogLevel» в «org.freedesktop.systemd1.Manager».
интерфейс. Свойство содержит одну строку:

# busctl set-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager LogLevel s debug
# busctl get-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager LogLevel
s "отладка"

Пример 2. Обратный и Подробный Результат

Следующие две команды читают свойство, содержащее массив строк, и сначала
покажите его в кратком формате, а затем в подробном формате:

$ busctl get-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager Environment
как 2 "LANG = en_US.UTF-8" "PATH =/ usr / местные / sbin:/ USR / местные / бен:/ usr / sbin:/ USR / бен"
$ busctl get-property --verbose org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager Environment
ARRAY "s" {
СТРОКА "LANG = en_US.UTF-8";
СТРОКА "ПУТЬ =/ usr / местные / sbin:/ USR / местные / бен:/ usr / sbin:/ USR / бен";
};

Пример 3. Вызов a Способ доставки

Следующая команда вызывает метод StartUnit для
"org.freedesktop.systemd1.Manager" интерфейс объекта "/ org / freedesktop / systemd1"
служба "org.freedesktop.systemd1" и передает ей две строки "cups.service" и
"заменять". В результате вызова метода принимается единственный параметр пути к объекту и
показано:

# busctl call org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/ org / freedesktop / systemd1 / job / 42684"

Используйте busctl онлайн с помощью сервисов onworks.net