mosquitto_sub - Online na nuvem

PROGRAMA:

NOME

mosquitto_sub - um cliente MQTT versão 3.1 para assinatura de tópicos

SINOPSE

mosquito_sub [-A endereço_de ligação] [-c] [-C msg contar] [-d] [-h hostname] [-i client_id]
[-I cliente id prefixo] [-k mantenha vivo tempo] [-p porta número] [-q mensagem QoS]
[-R] [-S] [-N] [--quieto] [-v] [[-u nome de usuário] [-P senha]]
[--will-tópico tópico [--will-carga útil carga paga] [--will-qos Qos] [- irá reter]]
[[{--cafile lima | --capath dir} [--certificado lima] [--chave lima] [--tls-versão versão] [--inseguro]]
| [--psk chave hexagonal --psk-identidade identidade [--tls-versão versão]]]
[--proxy URL das meias] [-V versão do protocolo] [-T filtrar...]
-t tópico da mensagem...

mosquito_sub [--Socorro]

DESCRIÇÃO

mosquito_sub é um cliente MQTT versão 3.1 simples que assinará um tópico e imprimirá
as mensagens que recebe.

OPÇÕES

As opções abaixo podem ser fornecidas na linha de comando, mas também podem ser colocadas em uma configuração
arquivo localizado em $ XDG_CONFIG_HOME / mosquitto_sub or $ HOME / .config / mosquitto_sub com um
par de -Opção valor por linha. Os valores no arquivo de configuração serão usados ​​como padrões e
pode ser substituído usando a linha de comando. As exceções são -t e -T, o qual
se fornecido no arquivo de configuração, não será substituído. Observe também que atualmente algumas opções
não pode ser negado, por exemplo -S. Linhas de arquivo de configuração que têm um # como o primeiro personagem é
tratados como comentários e não são mais processados.

-A
Vincule a conexão de saída a um endereço IP / nome de host local. Use este argumento se você
precisa restringir a comunicação de rede a uma interface específica.

-c, --disable-sessão limpa
Desative o sinalizador 'sessão limpa'. Isso significa que todas as assinaturas para o
o cliente será mantido após a desconexão, juntamente com QoS 1 e QoS 2 subsequentes
mensagens que chegam. Quando o cliente se reconectar, ele receberá todas as mensagens enfileiradas
mensagens.

Se usar esta opção, é recomendado que a id do cliente seja definida manualmente com --Eu iria

--cafile
Defina o caminho para um arquivo que contém certificados de CA codificados por PEM que são confiáveis.
Usado para habilitar a comunicação SSL.

Veja também --capath

--capath
Defina o caminho para um diretório contendo certificados de CA codificados por PEM que são
confiável. Usado para habilitar a comunicação SSL.

Para --capath para funcionar corretamente, os arquivos de certificado devem ter ".crt" como o arquivo
terminando e você deve executar "c_rehash "cada vez que você adiciona / remove um
certificado.

Veja também --cafile

--certificado
Defina o caminho para um arquivo que contém um certificado codificado PEM para este cliente, se
exigido pelo servidor.

Veja também --chave.

--cifras
Uma lista de cifras TLS compatível com o openssl para oferecer suporte no cliente. Ver cifras(1) para
Mais Informações.

-C
Desconecte e saia do programa imediatamente após a contagem de mensagens fornecida
recebido. Isso pode ser útil em scripts de shell onde em um único valor de status é
necessário, por exemplo.

Combina com -R para imprimir apenas o primeiro conjunto de novas mensagens (ou seja, que não tem
o conjunto de sinalizadores retido), ou com -T para filtrar quais tópicos são processados.

-d, --depurar
Habilite mensagens de depuração.

--Socorro
Exibir informações de uso.

-h, --hospedeiro
Especifique o host ao qual se conectar. O padrão é localhost.

-i, --Eu iria
O id a ser usado para este cliente. Se não for fornecido, o padrão é mosquitto_sub_ anexado com
a identificação do processo do cliente. Não pode ser usado ao mesmo tempo que o --id-prefixo
argumento.

-I, --id-prefixo
Forneça um prefixo a partir do qual o ID do cliente será criado, anexando o ID do processo de
o cliente. Isso é útil quando o corretor está usando a opção clientid_prefixes.
Não pode ser usado ao mesmo tempo que o --Eu iria argumento.

--inseguro
Ao usar criptografia baseada em certificado, esta opção desativa a verificação do
nome do host do servidor no certificado do servidor. Isso pode ser útil durante o teste inicial
configurações de servidor, mas possibilita que terceiros mal-intencionados se façam passar por
seu servidor por meio de falsificação de DNS, por exemplo. Use esta opção no teste só. Se você
precisa recorrer ao uso desta opção em um ambiente de produção, sua configuração está em
falha e não há nenhum ponto usando criptografia.

-k, --mantenha vivo
O número de segundos entre o envio de comandos PING ao corretor para fins de
informando que ainda estamos conectados e funcionando. O padrão é 60 segundos.

--chave
Defina o caminho para um arquivo que contém uma chave privada codificada por PEM para este cliente, se
exigido pelo servidor.

Veja também --certificado.

-N
Não anexe um caractere de fim de linha à carga útil ao imprimir. Isso permite
streaming de dados de carga útil de várias mensagens diretamente para outro aplicativo
não modificado. Realmente só faz sentido quando não é usado -v.

-p, --porta
Conecte-se à porta especificada em vez da 1883 padrão.

-P, --pw
Forneça uma senha a ser usada para autenticação com o corretor. Usando este argumento
sem também especificar um nome de usuário é inválido. Isso requer um corretor que ofereça suporte
MQTT v3.1. Veja também o --nome do usuário opção.

--proxy
Especifique um proxy SOCKS5 para se conectar. Tipos de autenticação "Nenhum" e "nome de usuário"
são suportados. o URL das meias deve ser da forma
socks5h: // [nome de usuário [: senha] @] host [: porta]. O prefixo do protocolo meias 5h significa que
nomes de host são resolvidos pelo proxy. Os símbolos% 25,% 3A e% 40 são URL decodificados em
%,: e @ respectivamente, se presente no nome de usuário ou senha.

Se o nome de usuário não for fornecido, nenhuma autenticação será tentada. Se a porta não for
dado, então o padrão de 1080 é usado.

Mais versões de SOCKS podem estar disponíveis no futuro, dependendo da demanda, e usarão
diferentes prefixos de protocolo, conforme descrito em enrolar(1).

--psk
Forneça a chave pré-compartilhada hexadecimal (sem 0x à esquerda) correspondente àquela usada no
corretor para usar o suporte de criptografia TLS-PSK. --psk-identidade também deve ser fornecido para
habilite TLS-PSK.

--psk-identidade
A identidade do cliente a ser usada com suporte TLS-PSK. Isso pode ser usado em vez de um
nome de usuário se o corretor estiver configurado para isso.

-q, --qos
Especifique a qualidade de serviço desejada para as mensagens recebidas, de 0, 1 e 2.
O padrão é 0. Veja MQTT(7) para obter mais informações sobre QoS.

O QoS é idêntico para todos os tópicos assinados em uma única instância de
mosquito_sub.

--quieto
Se este argumento for fornecido, nenhum erro de tempo de execução será impresso. Isso exclui qualquer erro
mensagens fornecidas em caso de entrada inválida do usuário (por exemplo, usando --porta sem uma porta).

-R
Se este argumento for fornecido, as mensagens recebidas que têm o bit de retenção definido
não será impresso. Mensagens com retenção definida são "obsoletas", pois não são conhecidas
quando foram originalmente publicados. Ao assinar um tópico curinga, pode haver
um grande número de mensagens retidas. Este argumento suprime sua exibição.

-S
Use pesquisas SRV para determinar a qual host se conectar. Executa pesquisas para
_mqtt._tcp. quando usado em conjunto com -h, caso contrário, usa _mqtt._tcp.
dns domínio>.

-t, --tema
O tópico MQTT para assinar. Ver MQTT(7) para obter mais informações sobre tópicos MQTT.

Esta opção pode ser repetida para inscrever-se em vários tópicos.

-T, --filtrar
Suprime a impressão de tópicos que correspondem ao filtro. Isso permite a assinatura de um
tópico curinga e imprimindo apenas um conjunto parcial da hierarquia curinga.

Por exemplo, assine a árvore da BBC, mas suprima a saída do Radio 3:

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

Esta opção pode ser repetida para filtrar vários tópicos ou árvores de tópicos.

--tls-versão
Escolha qual versão do protocolo TLS usar ao se comunicar com o broker. Válido
opções são tlsv1.2, tlsv1.1 e tlsv1. o valor padrão é tlsv1.2. Se o instalado
versão do openssl é muito antiga, apenas tlsv1 esteja disponível. Deve corresponder ao protocolo
versão usada pelo corretor.

-u, --nome do usuário
Forneça um nome de usuário a ser usado para autenticação com o corretor. Isso requer um
corretor que suporta MQTT v3.1. Veja também o --pw argumento.

-v, --verbose
Imprima as mensagens recebidas detalhadamente. Com este argumento, as mensagens serão impressas como
"carga útil do tópico". Quando este argumento não é fornecido, as mensagens são impressas como
"carga útil".

-V, --protocolo-versão
Especifique qual versão do protocolo MQTT deve ser usada ao se conectar ao
corretor rmeote. Pode ser mqttv31 or mqttv311. Padrões para mqttv31.

--will-carga útil
Especifique uma mensagem que será armazenada pelo corretor e enviada se este cliente
desconecta inesperadamente. Isso deve ser usado em conjunto com --will-tópico.

--will-qos
O QoS a ser usado para a vontade. O padrão é 0. Isso deve ser usado em conjunto com
--will-tópico.

- irá reter
Se fornecido, se o cliente se desconectar inesperadamente, a mensagem enviada será tratada
como uma mensagem retida. Isso deve ser usado em conjunto com --will-tópico.

--will-tópico
O tópico sobre o qual enviar um testamento, no caso de o cliente se desconectar
inesperadamente.

VONTADE

mosquitto_sub pode registrar uma mensagem com o corretor que será enviada se
desconecta inesperadamente. Ver MQTT(7) para mais informações.

O requisito mínimo para isso é usar --will-tópico para especificar qual tópico a vontade
deve ser enviado em. Isso resultará em uma mensagem não retida de comprimento zero com QoS 0.

Use o - irá reter, --will-carga útil e --will-qos argumentos para modificar o outro irão
parâmetros.

EXEMPLOS

Observe que estes são realmente exemplos - as inscrições funcionarão se você executá-las como
mostrado, mas deve haver algo publicando mensagens sobre esses tópicos para você receber
qualquer coisa.

Assine as informações de temperatura no localhost com QoS 1:

· Sensores mosquitto_sub -t / temperatura -q 1

Inscreva-se para receber atualizações de temperatura do disco rígido em várias máquinas / discos rígidos. Isso espera
cada máquina estará publicando sua temperatura de disco rígido para
sensores / máquinas / HOSTNAME / temperatura / HD_NAME.

· Sensores mosquitto_sub -t / máquinas / + / temperatura / +

Inscreva-se em todas as mensagens de status do corretor:

· Mosquitto_sub -vt \ $ SYS / #

Use mosquitto_sub online usando serviços onworks.net