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

ПРОГРАММА:

ИМЯ

mosquitto_sub - клиент MQTT версии 3.1 для подписки на темы

СИНТАКСИС

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

mosquitto_sub [--Помогите]

ОПИСАНИЕ

mosquitto_sub это простой клиент MQTT версии 3.1, который подписывается на тему и печатает
сообщения, которые он получает.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Приведенные ниже параметры могут быть указаны в командной строке, но также могут быть помещены в конфигурацию.
файл, расположенный в $ XDG_CONFIG_HOME / mosquitto_sub or $ HOME / .config / mosquitto_sub с одним
пара -Option ценностное за строку. Значения в файле конфигурации будут использоваться по умолчанию и
можно переопределить с помощью командной строки. Исключениями являются -t и -T, который
если указано в файле конфигурации, не будет отменено. Также обратите внимание, что в настоящее время некоторые параметры
нельзя отрицать, например -S. Строки файла конфигурации с # как первый персонаж
рассматриваются как комментарии и в дальнейшем не обрабатываются.

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

-c, --отключить чистую сессию
Отключите флаг «чистая сессия». Это означает, что все подписки на
клиент будет поддерживаться после отключения, вместе с последующими QoS 1 и QoS 2
сообщения, которые приходят. Когда клиент повторно подключается, он получит все поставленные в очередь
сообщений.

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

--кафе
Определите путь к файлу, содержащему доверенные сертификаты CA в кодировке PEM.
Используется для включения связи SSL.

Смотрите также --капат

--капат
Определите путь к каталогу, содержащему сертификаты CA в кодировке PEM, которые
доверял. Используется для включения связи SSL.

Что касается --капат для правильной работы файлы сертификатов должны иметь в качестве файла ".crt"
окончание, и вы должны запустить "c_rehash "каждый раз, когда вы добавляете / удаляете
сертификат.

Смотрите также --кафе

--серт
Определите путь к файлу, содержащему сертификат в кодировке PEM для этого клиента, если
требуется сервером.

Смотрите также --ключ.

--шифры
Список совместимых с openssl шифров TLS, поддерживаемых клиентом. Видеть шифры(1) для
больше информации.

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

Объединить с -R для печати только первого набора свежих сообщений (т. е. не имеющих
установленный флаг), или с -T для фильтрации тем, которые обрабатываются.

-d, --отлаживать
Включить отладочные сообщения.

--Помогите
Отображение информации об использовании.

-h, --хозяин
Укажите хост для подключения. По умолчанию localhost.

-i, --я бы
Идентификатор, используемый для этого клиента. Если не указан, по умолчанию используется mosquitto_sub_ с добавлением
идентификатор процесса клиента. Не может использоваться одновременно с --id-префикс
аргумент.

-I, --id-префикс
Предоставьте префикс, из которого будет строиться идентификатор клиента, добавив идентификатор процесса
клиент. Это полезно, когда брокер использует параметр clientid_prefixes.
Не может использоваться одновременно с --я бы аргумент.

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

-k, --живой
Количество секунд между отправкой команд PING брокеру в целях
сообщая ему, мы все еще на связи и работаем. По умолчанию 60 секунд.

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

Смотрите также --серт.

-N
Не добавляйте символ конца строки к полезной нагрузке при печати. Это позволяет
потоковая передача данных полезной нагрузки из нескольких сообщений непосредственно в другое приложение
немодифицированный. Только действительно имеет смысл, когда вы не используете -v.

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

-P, --pw
Укажите пароль, который будет использоваться для аутентификации у брокера. Используя этот аргумент
без указания имени пользователя недопустимо. Для этого требуется брокер, поддерживающий
MQTT v3.1. Также --имя пользователя опцию.

--прокси
Укажите прокси-сервер SOCKS5 для подключения. Типы аутентификации "Нет" и "имя пользователя"
поддерживаются. В носки-url должен иметь форму
socks5h: // [имя пользователя [: пароль] @] хост [: порт]. Префикс протокола носки5ч Значит это
имена хостов разрешаются прокси. Символы% 25,% 3A и% 40 декодируются в URL.
%,: и @ соответственно, если они присутствуют в имени пользователя или пароле.

Если имя пользователя не указано, аутентификация не выполняется. Если порт не
задано, то используется значение по умолчанию 1080.

Другие версии SOCKS могут быть доступны в будущем, в зависимости от спроса, и будут использовать
различные префиксы протоколов, как описано в виться(1).

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

--psk-идентификация
Удостоверение клиента для использования с поддержкой TLS-PSK. Это можно использовать вместо
имя пользователя, если брокер настроен на это.

-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, --отфильтровано
Запретить печать тем, соответствующих фильтру. Это позволяет подписаться на
тема с подстановочными знаками и печать только частичного набора иерархии с подстановочными знаками.

Например, подписаться на дерево BBC, но подавить вывод Radio 3:

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

Эту опцию можно повторить, чтобы отфильтровать несколько тем или деревьев тем.

--tls-версия
Выберите, какую версию протокола TLS использовать при общении с брокером. Действительный
варианты тлсв1.2, тлсв1.1 и тлсв1. Значение по умолчанию - тлсв1.2. Если установлен
версия openssl слишком старая, только тлсв1 будет доступно. Должен соответствовать протоколу
версия, используемая брокером.

-u, --имя пользователя
Укажите имя пользователя, которое будет использоваться для аутентификации у брокера. Это требует
брокер, поддерживающий MQTT v3.1. Также --pw аргумент.

-v, --подробный
Подробно печатать полученные сообщения. С этим аргументом сообщения будут напечатаны как
"полезная нагрузка темы". Если этот аргумент не указан, сообщения печатаются как
«полезная нагрузка».

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

--will-полезная нагрузка
Укажите сообщение, которое будет сохранено брокером и отправлено, если этот клиент
неожиданно отключается. Это должно использоваться вместе с --will-тема.

--will-qos
QoS для использования по желанию. По умолчанию 0. Это должно использоваться вместе с
--will-тема.

- сохранит
Если указано, то если клиент неожиданно отключается, отправленное сообщение будет обработано.
как сохраненное сообщение. Это должно использоваться вместе с --will-тема.

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

УИЛЛС

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

Минимальное требование для этого - использовать --will-тема указать, по какой теме будет
должны быть отправлены дальше. Это приведет к несохраняемому сообщению нулевой длины с QoS 0.

Использовать - сохранит, --will-полезная нагрузка и --will-qos аргументы для изменения другой воли
параметры.

ПРИМЕРЫ

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

Подпишитесь на информацию о температуре на localhost с QoS 1:

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

Подпишитесь на обновления температуры жесткого диска на нескольких машинах / жестких дисках. Это ожидает
каждая машина будет публиковать информацию о температуре жесткого диска
датчики / машины / HOSTNAME / температура / HD_NAME.

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

Подпишитесь на все статусные сообщения брокера:

· Mosquitto_sub -vt \ $ SYS / #

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