busctl - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

busctl - Ознайомтеся з автобусом

СИНТАКСИС

busctl [ВАРІАНТИ...] [КОМАНДА] [ІМ'Я...]

ОПИС

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

ВАРІАНТИ

Розбираються такі варіанти:

--адреса=АДРЕСА
Підключитися до шини, зазначеної в АДРЕСА замість використання відповідних значень за замовчуванням для будь-якого
системну або користувацьку шину (див --система та --користувач варіанти).

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

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

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

-- активується
Відображаючи список однорангових вузлів, показуйте лише однорангові, які насправді не були активовані
ще, але може бути запущено автоматично, якщо до нього доступ.

--відповідність=MATCH
Під час відображення повідомлень, якими обмінюються, показуйте лише відповідні підмножини MATCH.

--розмір=
При використанні з захоплення команда, визначає максимальний розмір повідомлення шини для захоплення
("snaplen"). За замовчуванням 4096 байт.

-- список
При використанні з дерево команда, показує плоский список шляхів об’єкта замість дерева.

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

-багатослівний
При використанні з call or get-property команда, показує результат у більш докладному
Формат.

--очікуйте-відповідь=BOOL
При використанні з call команда, вказує чи busctl дочекатися завершення
виклик методу, вивести отримані дані відповіді методу та повернути успіх або
збій через код виходу з процесу. Якщо для цього параметра встановлено значення "ні", буде виклик методу
видано, але не очікується відповіді, інструмент негайно припиняє роботу, а отже, ні
відповідь може бути показана, і код виходу не повертає успіх чи невдачу. До
тільки придушити вихід корисного навантаження повідомлення-відповіді, використати --спокійно вище. За замовчуванням
"так".

--автозапуск=BOOL
При використанні з call команда, вказує, чи має виклик методу неявно
активувати викликану службу, якщо вона ще не запущена, але налаштована
автоматично запущено. За замовчуванням "так".

--allow-interactive-authorization=BOOL
При використанні з call команда, вказує, чи можуть служби застосовуватися
інтерактивна авторизація під час виконання операції, якщо політика безпеки є
налаштований для цього. За замовчуванням "так".

--тайм-аут=SECS
При використанні з call команда, визначає максимальний час очікування виклику методу
завершення. Якщо одиниця часу не вказана, передбачається секунди. Звичайні інші одиниці
зрозуміло теж (ms, us, s, min, h, d, w, month, y). Зауважте, що цей тайм-аут не діє
застосовувати, якщо --очікуйте-відповідь=ні використовується, оскільки інструмент не чекає жодного повідомлення-відповіді
тоді. Якщо не вказано або встановлено значення 0, за замовчуванням приймається "25s".

--augment-creds=BOOL
Контролює, чи повідомляються дані облікових даних список or статус буде доповнено
дані з /proc. Якщо цей параметр увімкнено, відображені дані, можливо, є невідповідними, як
дані, зчитовані з / proc може бути пізнішим, ніж решта облікових даних
інформації. За замовчуванням "так".

--користувач
Спілкуйтеся з менеджером обслуговування абонента, який телефонує, а не з менеджером послуг
система.

--система
Зверніться до сервісного менеджера системи. Це неявний за замовчуванням.

-H, --host=
Виконайте операцію дистанційно. Вкажіть ім’я хоста або ім’я користувача та ім’я хоста
розділені символом "@", для підключення. До імені хоста за бажанням може бути суфікс a
ім'я контейнера, розділене символом ":", яке безпосередньо підключається до певного контейнера на
вказаний хост. Це використовуватиме SSH для спілкування з екземпляром віддаленого менеджера машини.
Назви контейнерів можуть бути перераховані за допомогою machinectl -H HOST.

-M, --машина=
Виконайте операцію на локальному контейнері. Вкажіть назву контейнера для підключення.

--без пейджера
Не передавайте вихід на пейджер.

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

-h, --допомога
Друк короткого тексту довідки та виходу.

-- версія
Надрукувати короткий рядок версії та вийти.

КОМАНДИ

Розуміються такі команди:

список
Показати всіх однолітків у автобусі за їх назвами служби. За замовчуванням показує як унікальний, так і
добре відомі імена, але це можна змінити за допомогою --унікальний та -- придбано перемикачі
Це операція за замовчуванням, якщо не вказано жодну команду.

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

контролювати [СЕРВІС...]
Дамп повідомлення, якими обмінюється. Якщо СЕРВІС вказано, показувати повідомлення до або від цього
однолітка, ідентифікована за своїм добре відомим або унікальним ім'ям. В іншому випадку відображати всі повідомлення на
автобус. Використовуйте Ctrl-C, щоб завершити дамп.

захоплення [СЕРВІС...]
Як і в контролювати але записує результат у форматі pcap (докладніше див Libpcap
філе сформований[1] опис. Не забудьте перенаправити вихід на STDOUT у файл.
Такі інструменти, як Wireshark(1) можна використовувати для аналізу та перегляду згенерованих файлів.

дерево [СЕРВІС...]
Показує дерево об’єктів однієї чи кількох служб. Якщо СЕРВІС вказано, показати об’єкт
дерево лише вказаних послуг. В іншому випадку показати всі дерева об’єктів усіх служб
в автобусі, який отримав хоча б одне відоме ім’я.

самоаналіз СЕРВІС ОБ'ЄКТ [ІНТЕРФЕЙС]
Показати інтерфейси, методи, властивості та сигнали зазначеного об’єкта (ідентифікованого
своїм шляхом) на вказаному сервісі. Якщо аргумент інтерфейсу передається, вихід
обмежено членами вказаного інтерфейсу.

call СЕРВІС ОБ'ЄКТ ІНТЕРФЕЙС МЕТОД [ПІДПИС [АРГУМЕНТ...]]
Викликати метод і показати відповідь. Бере ім'я служби, шлях до об'єкта, інтерфейс
ім'я та назва методу. Якщо параметри повинні бути передані до виклику методу, підпис
рядок є обов’язковим, за яким слідують аргументи, окремо відформатовані як рядки. Для
подробиці про використане форматування див. нижче. Щоб придушити вихід повернених даних,
використовувати --спокійно варіант.

get-property СЕРВІС ОБ'ЄКТ ІНТЕРФЕЙС ВЛАСНІСТЬ...
Отримати поточне значення одного або кількох властивостей об’єкта. Приймає назву служби,
шлях об'єкта, ім'я інтерфейсу та ім'я властивості. Можна вказати кілька властивостей на
один раз, і в цьому випадку їх значення будуть показані одне за одним, розділені символами
нові рядки. Вихід за замовчуванням має короткий формат. Використовуйте -багатослівний для більшого
складний вихідний формат.

набір-властивість СЕРВІС ОБ'ЄКТ ІНТЕРФЕЙС ВЛАСНІСТЬ ПІДПИС АРГУМЕНТ...
Встановити поточне значення властивості об’єкта. Бере ім’я служби, шлях до об’єкта,
ім'я інтерфейсу, ім'я властивості, підпис властивості, а потім список параметрів
відформатований у вигляді рядків.

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

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

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

Наприклад,

s jawoll

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

як 3 hello world foobar

це форматування масиву рядків із трьома записами: «hello», «world» і «foobar».

a{sv} 3 One s Eins Two u 2 Так b правда

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

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

ПРИКЛАДИ

Приклад 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. коротко та Verbose Вихід

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

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Середовище
як 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 Середовище
МАССИВ "s" {
STRING "LANG=en_US.UTF-8";
STRING "PATH=/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Приклад 3. Викликаючи a Метод

Наступна команда викликає метод "StartUnit" на
Інтерфейс "org.freedesktop.systemd1.Manager" об'єкта "/org/freedesktop/systemd1"
сервіс "org.freedesktop.systemd1" і передає йому два рядки "cups.service" і
«замінити». У результаті виклику методу отримується один параметр шляху до об’єкта і
показано:

# busctl виклик org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"

Використовуйте busctl онлайн за допомогою служб onworks.net