НАЗВА¶

busctl - глибинний аналіз каналу обміну даними

КОРОТКИЙ ОПИС¶

busctl [ПАРАМЕТРИ...] [КОМАНДА] [НАЗВА...]

ОПИС¶

busctl можна скористатися для глибинного аналізу та спостереження за каналами обміну даними D-Bus.

КОМАНДИ¶

Передбачено обробку таких команд:

list

status [СЛУЖБА]

monitor [СЛУЖБА...]

capture [СЛУЖБА...]

tree [СЛУЖБА...]

introspect СЛУЖБА ОБ'ЄКТ [ІНТЕРФЕЙС]

call СЛУЖБА ОБ'ЄКТ ІНТЕРФЕЙС МЕТОД [ПІДПИСE [АРГУМЕНТ...]]

emit ОБ'ЄКТ ІНТЕРФЕЙС СИГНАЛ [ПІДПИС [АРГУМЕНТ...]]

wait [СЛУЖБА] ОБ'ЄКТ ІНТЕРФЕЙС СИГНАЛ

get-property СЛУЖБА ОБ'ЄКТ ІНТЕРФЕЙС ВЛАСТИВІСТЬ...

set-property СЛУЖБА ОБ'ЄКТ ІНТЕРФЕЙС ВЛАСТИВІСТЬ ПІДПИС АРГУМЕНТ...

help

ПАРАМЕТРИ¶

Передбачено обробку таких параметрів:

--address=АДРЕСА

--show-machine

--unique

--acquired

--activatable

--match=ВІДПОВІДНИК

--size=

--list

-q, --quiet

--verbose

--xml-interface

--expect-reply=БУЛЕВЕ ЗНАЧЕННЯ

--auto-start=БУЛЕВЕ ЗНАЧЕННЯ

--allow-interactive-authorization=БУЛЕВЕ ЗНАЧЕННЯ

--timeout=СЕКУНДИ

--limit-messages=ЧИСЛО, -N ЧИСЛО

--augment-creds=БУЛЕВЕ ЗНАЧЕННЯ

--watch-bind=БУЛЕВЕ ЗНАЧЕННЯ

--destination=СЛУЖБА

--user

--system

-H, --host=

-M, --machine=

-C, --capsule=

-l, --full

--json=РЕЖИМ

-j

--no-pager

--no-legend

-h, --help

--version

ФОРМАТУВАННЯ ПАРАМЕТРІВ¶

Команди call і set-property приймають рядок підпису, за яким слід вказати список параметрів, форматованих як рядок (докладний опис рядків підпису D-Bus наведено у розділі системи типів специфікації D-Bus[2]). Для простих типів кожен параметр після підпису має бути простим значенням параметра, форматованого як рядок. Позитивні булеві значення може бути форматовано як "true", "yes", "on" або "1"; негативні булеві значення можна вказати як "false", "no", "off" або "0". Для масивів за числовим аргументом для кількості записів має бути вказано записи. Для варіантів має бути вказано підпис даних, а потім дані. Для словників і структур має бути безпосередньо вказано їхній вміст.

Приклад:

s jawoll

є форматуванням одного рядка "jawoll".

as 3 hello world foobar

є форматуванням масиву рядків із трьома записами, "hello", "world" і "foobar".

a{sv} 3 One s Eins Two u 2 Yes b true

є форматуванням масиву словника, який пов'язує рядки з варіантами і складається з трьох записів. Рядок "One" пов'язано із рядком "Eins". Рядок "Two" пов'язано із 32-бітовим цілим числом без знаку 2. Рядок "Yes" пов'язано із позитивним булевим значенням.

Зауважте, що команди call, get-property, introspect також виводять дані у цьому форматі. Оскільки цей формат є дещо складним для розуміння, команди call і get-property можуть виводити докладніші багаторядкові дані, якщо передано параметр --verbose.

ПРИКЛАДИ¶

Приклад 1. Записування і читання властивості

Наведені нижче дві команди спочатку записують значення властивості, а потім читають його. Властивість розташовано в об'єкті "/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 "debug"

Приклад 2. Скорочене і докладне виведення

Наступні дві команди читають властивість, яка містить масив рядків, і спершу виводять її у скороченому форматі, а потім у докладному:

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
as 2 "LANG=en_US.UTF-8" "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
ARRAY "s" {


        STRING "LANG=en_US.UTF-8";


        STRING "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin";
};

Приклад 3. Виклик методу

Наступна команда викликає метод "StartUnit" на інтерфейсі "org.freedesktop.systemd1.Manager" об'єкта "/org/freedesktop/systemd1" служби "org.freedesktop.systemd1" і передає йому два рядки, "cups.service" і "replace". Результатом виклику методу є отримання і показ одинарного параметра шляху до об'єкта:

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

ДИВ. ТАКОЖ¶

dbus-daemon(1), D-Bus[3], sd-bus(3), varlinkctl(1), systemd(1), machinectl(1), wireshark(1)

ПРИМІТКИ¶

1.

Формат файлів захоплених даних PCAP Next Generation (pcapng)

2.

Глава щодо системи типів у специфікації D-Bus

3.

D-Bus

ПЕРЕКЛАД¶

Український переклад цієї сторінки посібника виконано Yuri Chornoivan <yurchor@ukr.net>

Цей переклад є безкоштовною документацією; будь ласка, ознайомтеся з умовами GNU General Public License Version 3. НЕ НАДАЄТЬСЯ ЖОДНИХ ГАРАНТІЙ.

Якщо ви знайшли помилки у перекладі цієї сторінки підручника, будь ласка, надішліть електронний лист до списку листування перекладачів: trans-uk@lists.fedoraproject.org.