mosquitto_sub - Онлайн у хмарі

ПРОГРАМА:

ІМ'Я

mosquitto_sub - клієнт MQTT версії 3.1 для підписки на теми

СИНТАКСИС

mosquitto_sub [-A адреса_прив'язки] [-c] [-C MSG вважати] [-d] [-h ім'я хоста] [-i client_id]
[-I клієнт id префікс] [-k підтримувати час] [-p порт номер] [-q повідомлення QoS]
[-R] [-S] [-N] [--спокійно] [-v] [[-u ім'я користувача] [-P пароль]]
[--воля-тема тема [--буде-корисне навантаження корисне навантаження] [--will-qos qos] [--буде-зберігатиме]]
[[{--cafile файл | --капат реж} [--сертифікат файл] [--ключ файл] [--tls-версія версія] [--небезпечно]]
| [--psk шестигранний ключ --psk-ідентичність особистість [--tls-версія версія]]]
[--проксі socks-url] [-V протокол-версія] [-T відфільтрувати...]
-t повідомлення-тема...

mosquitto_sub [--допомога]

ОПИС

mosquitto_sub це простий клієнт MQTT версії 3.1, який підписується на тему та друкує
повідомлення, які він отримує.

ВАРІАНТИ

Наведені нижче параметри можуть бути вказані в командному рядку, але також можуть бути розміщені в конфігурації
файл, розташований за адресою $XDG_CONFIG_HOME/mosquitto_sub or $HOME/.config/mosquitto_sub з одним
пара -Опція значення за рядок. Значення у файлі конфігурації будуть використовуватися за замовчуванням і
можна змінити за допомогою командного рядка. Винятки з цього становлять -t та -T, Яка
якщо вказано у файлі конфігурації, не буде перевизначено. Відзначимо також, що на даний момент є деякі варіанти
не можна заперечувати, напр -S. Рядки файлу конфігурації, які мають a # як перший символ
розглядаються як коментарі та більше не обробляються.

-A
Прив’яжіть вихідне з’єднання до локальної IP-адреси/ім’я хосту. Використовуйте цей аргумент, якщо ви
необхідно обмежити мережевий зв’язок певним інтерфейсом.

-c, --disable-clean-session
Вимкніть прапор «чистий сеанс». Це означає, що всі підписки на
клієнт буде підтримуватися після його відключення разом з наступними QoS 1 і QoS 2
повідомлення, які надходять. Коли клієнт повторно з’єднається, він отримає все, що стоїть у черзі
повідомлення

Якщо використовується цей параметр, рекомендується встановити ідентифікатор клієнта вручну за допомогою --id

--cafile
Визначте шлях до файлу, що містить сертифікати ЦС, закодовані PEM, які є надійними.
Використовується для ввімкнення зв’язку SSL.

Дивіться також --капат

--капат
Визначте шлях до каталогу, що містить сертифікати ЦС, закодовані PEM
довіряють. Використовується для ввімкнення зв’язку SSL.

для --капат для коректної роботи файли сертифікатів повинні мати ".crt" як файл
закінчується, і ви повинні запустити "c_rehash " щоразу, коли ви додаєте/видаляєте a
довідка.

Дивіться також --cafile

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

Дивіться також --ключ.

-- шифри
Openssl-сумісний список шифрів TLS для підтримки клієнтом. Побачити шифри(1) для
більше інформації.

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

Поєднуйте з -R надрукувати лише перший набір свіжих повідомлень (тобто яких немає
збережений прапорець), або з -T щоб відфільтрувати теми, які обробляються.

-d, --відлагоджувати
Увімкнути повідомлення про налагодження.

--допомога
Відображення інформації про використання.

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

-i, --id
Ідентифікатор для цього клієнта. Якщо не вказано, за замовчуванням додається mosquitto_sub_
ідентифікатор процесу клієнта. Не можна використовувати одночасно з --ідентифікатор-префікс
аргумент.

-I, --ідентифікатор-префікс
Укажіть префікс, з якого буде створено ідентифікатор клієнта, додавши ідентифікатор процесу
клієнт. Це корисно, якщо брокер використовує параметр clientid_prefixes.
Не можна використовувати одночасно з --id аргумент.

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

-k, --залишатися живим
Кількість секунд між відправленням команд PING брокеру для цілей
повідомляючи про це, ми все ще підключені та функціонуємо. За замовчуванням 60 секунд.

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

Дивіться також --сертифікат.

-N
Не додавайте символ кінця рядка до корисного навантаження під час друку. Це дозволяє
потокова передача даних корисного навантаження з кількох повідомлень безпосередньо в іншу програму
незмінений. Справді має сенс лише тоді, коли не використовується -v.

-p, --порт
Підключіться до вказаного порту замість стандартного 1883.

-P, --pw
Введіть пароль, який буде використовуватися для аутентифікації у брокера. Використовуючи цей аргумент
без вказівки імені користувача є недійсним. Для цього потрібен брокер, який підтримує
MQTT версії 3.1. Дивіться також --ім'я користувача варіант.

--проксі
Вкажіть проксі-сервер SOCKS5 для підключення. Типи автентифікації "Немає" та "Ім'я користувача".
підтримуються. The socks-url має бути за формою
socks5h://[ім'я користувача[:пароль]@]хост[:порт]. Префікс протоколу шкарпетки5год означає що
імена хостів вирішуються проксі. Символи %25, %3A та %40 декодуються в URL
%, : і @ відповідно, якщо вони присутні в імені користувача або паролі.

Якщо ім’я користувача не вказано, спроба автентифікації не проводиться. Якщо порту немає
за умовчанням використовується значення 1080.

Більше версій SOCKS можуть бути доступні в майбутньому, залежно від попиту, і будуть використовуватися
різні префікси протоколу, як описано в витися(1).

--psk
Укажіть шістнадцятковий (без початку 0x) попередній спільний ключ, що відповідає тому, що використовується на
брокера використовувати підтримку шифрування TLS-PSK. --psk-ідентичність також необхідно надати
увімкніть TLS-PSK.

--psk-ідентичність
Ідентифікатор клієнта для використання з підтримкою TLS-PSK. Це можна використовувати замість a
ім’я користувача, якщо брокер налаштований на це.

-q, --qos
Вкажіть бажану якість обслуговування для вхідних повідомлень, від 0, 1 і 2.
За замовчуванням 0. Див MQTT(7) для отримання додаткової інформації про QoS.

QoS ідентичний для всіх тем, на які підписані в одному екземплярі
mosquitto_sub.

--спокійно
Якщо вказано цей аргумент, помилки під час виконання не будуть надруковані. Це виключає будь-яку помилку
повідомлення, що надаються у разі невірного введення користувача (наприклад, використання --порт без порту).

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

-S
Використовуйте пошук SRV, щоб визначити, до якого хосту підключитися. Виконує пошук до
_mqtt._tcp. при використанні разом з -h, інакше використовує _mqtt._tcp.
DNS домен>.

-t, -- тема
Тема MQTT, на яку потрібно підписатися. Побачити MQTT(7) для отримання додаткової інформації на теми MQTT.

Цей параметр можна повторити, щоб підписатися на кілька тем.

-T, --відфільтрувати
Призупинити друк тем, які відповідають фільтру. Це дозволяє підписатися на a
тему підстановки та друкує лише частковий набір ієрархії підстановкових знаків.

Наприклад, підписатися на дерево BBC, але придушити вихід із Radio 3:

· mosquitto_sub -t bbc/# -T bbc/radio3

Цей параметр можна повторити, щоб відфільтрувати кілька тем або дерев тем.

--tls-версія
Виберіть, яку версію протоколу TLS використовувати під час спілкування з брокером. Дійсний
варіанти є tlsv1.2, tlsv1.1 та tlsv1. Значення за замовчуванням - tlsv1.2. Якщо встановлено
тільки версія openssl занадто стара tlsv1 буде доступним. Повинен відповідати протоколу
версія, яку використовує брокер.

-u, --ім'я користувача
Введіть ім’я користувача, яке буде використовуватися для автентифікації у брокера. Для цього потрібно a
брокер, який підтримує MQTT v3.1. Дивіться також --pw аргумент.

-v, -багатослівний
Друк отриманих повідомлень докладно. З цим аргументом повідомлення будуть друкуватися як
«корисне навантаження теми». Якщо цей аргумент не вказано, повідомлення друкуються як
«корисне навантаження».

-V, --протокол-версія
Укажіть, яку версію протоколу MQTT слід використовувати при підключенні до
брокер rmeote. Може бути mqttv31 or mqttv311. За замовчуванням mqttv31.

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

--will-qos
QoS для використання для Воли. За замовчуванням 0. Це потрібно використовувати разом із
--воля-тема.

--буде-зберігатиме
Якщо дано, якщо клієнт несподівано роз’єднається з надісланим повідомленням, буде оброблено
як збережене повідомлення. Це необхідно використовувати разом з --воля-тема.

--воля-тема
Тема, на яку надсилається заповіт, якщо клієнт відключається
несподівано.

ВОЛІ

mosquitto_sub може зареєструвати повідомлення у брокера, яке буде надіслано, якщо він
несподівано відключається. Побачити MQTT(7) для отримання додаткової інформації.

Мінімальна вимога для цього – використання --воля-тема уточнювати, на яку тему буде
слід відправити на. Це призведе до незбереженого повідомлення нульової довжини з QoS 0.

Використовувати --буде-зберігатиме, --буде-корисне навантаження та --will-qos аргументи для зміни іншої волі
параметри

ПРИКЛАДИ

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

Підпишіться на інформацію про температуру на локальному хості з QoS 1:

· mosquitto_sub -t датчики/температура -q 1

Підпишіться на оновлення температури жорсткого диска на кількох машинах/жорстких дисках. Це очікує
кожна машина, на яку публікується температура свого жорсткого диска
датчики/машини/HOSTNAME/temperature/HD_NAME.

· mosquitto_sub -t датчики/машини/+/температура/+

Підпишіться на всі повідомлення про статус брокера:

· mosquitto_sub -vt \$SYS/#

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