mosquitto_sub - Online w chmurze

PROGRAM:

IMIĘ

mosquitto_sub – klient MQTT w wersji 3.1 umożliwiający subskrypcję tematów

STRESZCZENIE

komar_sub [-A adres_powiązania] [-c] [-C msg liczyć] [-d] [-h hosta] [-i ID_klienta]
[-I klient id prefiks] [-k keepalive czas] [-p Port numer] [-q wiadomość QoS]
[-R] [-S] [-N] [--cichy] [-v] [[-u nazwa użytkownika] [-P password]]
[--will-temat aktualny [--will-ładunek ładowność] [--will-qos qos] [--zachowa-zachowa]]
[[{--kawiarnia filet | --kapata reż} [--certyfikat filet] [--klucz filet] [--tls-wersja wersja] [--niepewny]]
| [--psk klucz sześciokątny --psk-tożsamość tożsamość [--tls-wersja wersja]]]
[--pełnomocnik skarpetki-url] [-V wersja-protokołu] [-T odfiltrować...]
-t temat wiadomości...

komar_sub [--help]

OPIS

komar_sub jest prostym klientem MQTT w wersji 3.1, który subskrybuje temat i drukuje
wiadomości, które otrzymuje.

OPCJE

Poniższe opcje mogą być podane w wierszu poleceń, ale mogą być również umieszczone w pliku config
plik znajdujący się pod adresem $XDG_CONFIG_HOME/mosquitto_sub or $HOME/.config/mosquitto_sub z jednym
Para -Opcja wartość Za linię. Wartości w pliku konfiguracyjnym będą używane jako domyślne i
można zastąpić za pomocą wiersza poleceń. Wyjątkami od tej reguły są -t oraz -T, który
jeśli podano w pliku konfiguracyjnym nie zostanie nadpisane. Należy również zauważyć, że obecnie niektóre opcje
nie można zanegować, np. -S. Wiersze pliku konfiguracyjnego, które mają rozszerzenie # jako pierwszy znak są
traktowane jako komentarze i nie są dalej przetwarzane.

-A
Powiąż połączenie wychodzące z lokalnym adresem IP/nazwą hosta. Użyj tego argumentu, jeśli
konieczność ograniczenia komunikacji sieciowej do określonego interfejsu.

-c, --disable-clean-session
Wyłącz flagę „czysta sesja”. Oznacza to, że wszystkie subskrypcje dla
klient będzie utrzymywany po rozłączeniu, wraz z późniejszymi QoS 1 i QoS 2
wiadomości, które przyjdą. Kiedy klient połączy się ponownie, otrzyma wszystkie oczekujące wiadomości
wiadomości.

W przypadku korzystania z tej opcji zaleca się ręczne ustawienie identyfikatora klienta za pomocą --NS

--kawiarnia
Zdefiniuj ścieżkę do pliku zawierającego zaufane certyfikaty CA zakodowane w formacie PEM.
Służy do włączania komunikacji SSL.

Zobacz też --kapata

--kapata
Zdefiniuj ścieżkę do katalogu zawierającego certyfikaty CA zakodowane w formacie PEM
zaufany. Służy do włączania komunikacji SSL.

Dla litu szacuje się --kapata aby działały poprawnie, pliki certyfikatów muszą mieć rozszerzenie „.crt”.
zakończenie i musisz uruchomić „c_rehash „za każdym razem, gdy dodajesz/usuwasz plik a
certyfikat.

Zobacz też --kawiarnia

--certyfikat
Zdefiniuj ścieżkę do pliku zawierającego certyfikat zakodowany w formacie PEM dla tego klienta, jeśli
wymagane przez serwer.

Zobacz też --klucz.

--szyfry
Kompatybilna z OpenSSL lista szyfrów TLS do obsługi w kliencie. Widzieć szyfry(1) dla
więcej informacji.

-C
Rozłącz się i wyjdź z programu natychmiast po otrzymaniu określonej liczby wiadomości.
otrzymano. Może to być przydatne w skryptach powłoki, gdzie na jednej wartości statusu jest
wymagane, na przykład.

Łączą się z -R wydrukować tylko pierwszy zestaw nowych wiadomości (czyli taki, który nie ma
zachowany zestaw flag) lub z -T aby filtrować, które tematy są przetwarzane.

-d, --odpluskwić
Włącz komunikaty debugowania.

--help
Wyświetl informacje o użytkowaniu.

-h, --gospodarz
Określ hosta, z którym chcesz się połączyć. Domyślnie host lokalny.

-i, --NS
Identyfikator do użycia dla tego klienta. Jeśli nie podano, domyślnie mosquitto_sub_ z dołączonym
identyfikator procesu klienta. Nie można używać jednocześnie z --id-przedrostek
argumenty.

-I, --id-przedrostek
Podaj prefiks, z którego zostanie zbudowany identyfikator klienta, dołączając identyfikator procesu
Klient. Jest to przydatne, gdy broker używa opcji clientid_prefixes.
Nie można używać jednocześnie z --NS argumenty.

--niepewny
W przypadku korzystania z szyfrowania opartego na certyfikacie ta opcja wyłącza weryfikację
nazwa hosta serwera w certyfikacie serwera. Może to być przydatne podczas testowania początkowego
konfiguracje serwerów, ale umożliwia złośliwemu podmiotowi zewnętrznemu podszywanie się
na twój serwer poprzez fałszowanie DNS, na przykład. Użyj tej opcji podczas testowania tylko, Jeśli
musisz uciekać się do korzystania z tej opcji w środowisku produkcyjnym, twoja konfiguracja jest na
błąd i nie ma sensu używać szyfrowania.

-k, --utrzymać przy życiu
Liczba sekund między wysłaniem poleceń PING do brokera na potrzeby
informując go, że nadal jesteśmy połączeni i funkcjonujemy. Domyślnie 60 sekund.

--klucz
Zdefiniuj ścieżkę do pliku zawierającego klucz prywatny zakodowany w formacie PEM dla tego klienta, jeśli
wymagane przez serwer.

Zobacz też --certyfikat.

-N
Nie dodawaj znaku końca wiersza do ładunku podczas drukowania. Pozwala to
przesyłanie strumieniowe danych ładunku z wielu wiadomości bezpośrednio do innej aplikacji
niezmodyfikowany. Ma sens tylko wtedy, gdy nie jest używany -v.

-p, --Port
Połącz się z podanym portem zamiast domyślnego 1883.

-P, --pw
Podaj hasło, które będzie używane do uwierzytelniania w brokerze. Używając tego argumentu
bez określenia nazwy użytkownika jest nieprawidłowe. Wymaga to brokera, który obsługuje
MQTT v3.1. Zobacz także --Nazwa Użytkownika opcja.

--pełnomocnik
Określ serwer proxy SOCKS5, przez który chcesz się połączyć. Typy uwierzytelniania „Brak” i „Nazwa użytkownika”.
są obsługiwane. The skarpetki-url musi mieć formę
skarpetki5h://[nazwa użytkownika[:hasło]@]host[:port]. Przedrostek protokołu skarpetki5h oznacza, że
nazwy hostów są rozpoznawane przez serwer proxy. Symbole %25, %3A i %40 są dekodowane w adresie URL
odpowiednio %, : i @, jeśli występują w nazwie użytkownika lub haśle.

Jeśli nazwa użytkownika nie zostanie podana, nie zostanie podjęta żadna próba uwierzytelnienia. Jeśli nie ma portu
podane, wówczas używana jest wartość domyślna 1080.

Więcej wersji SOCKS może być dostępnych w przyszłości, w zależności od zapotrzebowania, i będą używane
różne prefiksy protokołów, jak opisano w curl(1).

--psk
Podaj szesnastkowy (bez początkowego 0x) klucz wstępny pasujący do klucza używanego w
brokera, aby korzystał z obsługi szyfrowania TLS-PSK. --psk-tożsamość należy również zapewnić
włącz TLS-PSK.

--psk-tożsamość
Tożsamość klienta do użycia z obsługą TLS-PSK. Można tego użyć zamiast a
nazwa użytkownika, jeśli broker jest do tego skonfigurowany.

-q, --qos
Określ żądaną jakość obsługi wiadomości przychodzących, wybierając spośród wartości 0, 1 i 2.
Domyślnie 0. Zobacz mqtt(7) aby uzyskać więcej informacji na temat QoS.

Jakość usługi jest identyczna dla wszystkich tematów subskrybowanych w ramach jednej instancji
komar_sub.

--cichy
Jeśli ten argument zostanie podany, nie zostaną wydrukowane żadne błędy czasu wykonania. To wyklucza jakikolwiek błąd
komunikaty podawane w przypadku błędnego wprowadzenia danych przez użytkownika (np. using --Port bez portu).

-R
Jeżeli podano ten argument, odebrane wiadomości, które mają ustawiony bit zatrzymania
nie zostanie wydrukowany. Wiadomości z ustawionym zachowaniem są „nieaktualne”, ponieważ nie są znane
kiedy zostały pierwotnie opublikowane. Podczas subskrybowania tematu wieloznacznego może być
duża liczba zachowanych wiadomości. Ten argument blokuje ich wyświetlanie.

-S
Użyj wyszukiwań SRV, aby określić, z którym hostem się połączyć. Wykonuje wyszukiwania do
_mqtt._tcp. w połączeniu z -h, inaczej używa _mqtt._tcp.
dns domena>.

-t, --temat
Temat MQTT, do którego należy się zapisać. Zobacz mqtt(7) aby uzyskać więcej informacji na temat MQTT.

Opcję tę można powtórzyć w celu subskrybowania wielu tematów.

-T, --filtruj-wyłącz
Wyłącz drukowanie tematów pasujących do filtra. Umożliwia to subskrypcję
temat symboli wieloznacznych i drukowanie tylko częściowego zestawu hierarchii symboli wieloznacznych.

Na przykład zasubskrybuj drzewo BBC, ale wyłącz wyjście z Radia 3:

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

Opcję tę można powtórzyć w celu odfiltrowania wielu tematów lub drzew tematów.

--tls-wersja
Wybierz wersję protokołu TLS, która ma być używana podczas komunikacji z brokerem. Ważny
opcje są tlsv1.2, tlsv1.1 oraz tlsv1. Domyślna wartość to tlsv1.2. Jeśli zainstalowany
wersja openssl jest tylko za stara tlsv1 będzie dostępny. Musi być zgodny z protokołem
wersja używana przez brokera.

-u, --Nazwa Użytkownika
Podaj nazwę użytkownika, która będzie używana do uwierzytelniania w brokerze. To wymaga
broker obsługujący MQTT v3.1. Zobacz także --pw argumenty.

-v, --gadatliwy
Drukuj otrzymane wiadomości w sposób szczegółowy. Z tym argumentem wiadomości będą drukowane jako
„ładunek tematu”. Gdy ten argument nie jest podany, wiadomości są drukowane jako
"ładunek".

-V, --wersja-protokołu
Określ, która wersja protokołu MQTT ma być używana podczas łączenia się z
broker rmeote. Może być mqttv31 or mqttv311. Domyślnie do mqttv31.

--will-ładunek
Określ wiadomość, która będzie przechowywana przez brokera i wysyłana, jeśli ten klient
niespodziewanie się rozłącza. To musi być używane w połączeniu z --will-temat.

--will-qos
QoS do użycia dla woli. Domyślnie 0. Musi być używane w połączeniu z
--will-temat.

--zachowa-zachowa
Jeśli podano, jeśli klient nieoczekiwanie się rozłączy, wysłana wiadomość zostanie potraktowana
jako zachowana wiadomość. To musi być używane w połączeniu z --will-temat.

--will-temat
Temat, na który należy wysłać testament, w przypadku rozłączenia klienta
niespodziewanie.

TESTY

mosquitto_sub może zarejestrować wiadomość w brokerze, która zostanie wysłana, jeśli to zrobi
niespodziewanie się rozłącza. Widzieć mqtt(7), aby uzyskać więcej informacji.

Minimalnym wymaganiem jest użycie --will-temat określić, jaki temat woli
należy wysłać dn. Spowoduje to powstanie niezachowanej wiadomości o zerowej długości z QoS 0.

Użyj --zachowa-zachowa, --will-ładunek oraz --will-qos argumenty, aby zmienić drugą wolę
parametry.

PRZYKŁADY

Należy pamiętać, że są to tylko przykłady — subskrypcje będą działać, jeśli uruchomisz je jako
pokazane, ale musi być coś, co publikuje wiadomości na te tematy, abyś mógł je otrzymywać
byle co.

Subskrybuj informacje o temperaturze na komputerze lokalnym z QoS 1:

· mosquitto_sub -t czujniki/temperatura -q 1

Subskrybuj aktualizacje temperatury dysku twardego na wielu maszynach/dyskach twardych. Oczekuje się, że
każda maszyna będzie publikować temperaturę swojego dysku twardego
czujniki/maszyny/NAZWA_HOSTA/temperatura/NAZWA_HD.

· mosquitto_sub -t czujniki/maszyny/+/temperatura/+

Subskrybuj wszystkie wiadomości o statusie brokera:

· mosquitto_sub -vt \$SYS/#

Użyj mosquitto_sub online za pomocą usług onworks.net