mqttui-read-one(1)          General Commands Manual         mqttui-read-one(1)

<?><?><?> (NAME)
       mqttui-read-one - <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> stdout

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       mqttui read-one [-r|--ignore-retained] [--only] [-p|--pretty] [--qos]
       [-b|--broker] [-u|--username] [--password] [-i|--client-id] [--ca-cert]
       [--client-cert] [--client-private-key] [--insecure] [-h|--help] [TOPIC]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?> (payload) <?><?>
       <?><?> <?><?> stdout <?><?><?><?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?>(<?><?><?>) <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> stderr <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> stdout <?> stderr <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> (pipe) <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?>:

       `echo "The temperature is $(mqttui read-one room/temp)"`

       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> ASCII / Unicode
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> `--pretty` <?><?> `mqttui log`
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -r, --ignore-retained
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> (retained)
              <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>.

              <?><?> <?><?><?><?><?> <?><?> <?><?><?> `--only=live` <?><?><?>
              <?><?><?><?><?> <?><?>.

       --only <ONLY>
              <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> (retained) <?><?>
              <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.

              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>.
              <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

              <?><?><?><?><?><?> <?><?><?><?>:

                     o retained

                     o live

       -p, --pretty
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
              <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.

       --qos <LEVEL> [<?><?><?><?><?><?><?>: 2]
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (`QoS`)
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?><?>.

              <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              0 <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> 1 <?><?> 2
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?> 2<?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> 1<?> <?><?><?><?><?><?><?> 1
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

              - 0: <?><?><?><?><?><?> <?><?><?><?><?><?> (fire and forget /
              <?><?><?><?><?> <?> <?><?><?><?><?><?>)

              - 1: <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>)

              - 2: <?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?>)
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_QOS <?><?><?><?>
              <?><?><?>.

       -h, --help
              <?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> '-h')

       [TOPIC] [<?><?><?><?><?><?><?>: #]
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_TOPIC <?><?><?><?>
              <?><?><?>.

<?><?><?><?><?> MQTT (MQTT CONNECTION)
       -b, --broker <URL> [<?><?><?><?><?><?><?>: mqtt://localhost]
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> (URL) <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              MQTT <?><?> <?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?>: `mqtt://localhost`
              `mqtt://localhost:1883` `mqtts://localhost`
              `mqtts://localhost:8883` `ws://localhost/path`
              `ws://localhost:9001/path` `wss://localhost/path`
              `wss://localhost:9001/path`
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_BROKER <?><?><?><?>
              <?><?><?>.

       -u, --username <STRING>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> mqtt.

              <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_USERNAME <?><?><?><?>
              <?><?><?>.

       --password <STRING>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> mqtt.

              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?> TLS <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?> (plaintext) <?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>! <?><?><?><?>
              <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_PASSWORD <?><?><?><?>
              <?><?><?>.

       -i, --client-id <STRING>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              (client id) <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_CLIENTID <?><?><?><?>
              <?><?><?>.

       --ca-cert <FILEPATH>
              <?><?><?><?> <?><?> <?><?><?><?> PEM <?><?><?><?><?> CA
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

              <?><?><?><?><?> CA <?><?><?><?> <?><?> <?><?><?><?><?> X.509 v3
              <?><?><?><?> <?><?><?><?> rustls <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> v1
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?><?><?>:
              <https://github.com/rustls/rustls/issues/2364>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_CA_CERTIFICATE
              <?><?><?><?> <?><?><?>.

       --client-cert <FILEPATH>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> TLS.

              <?><?><?><?><?> <?><?> --client-private-key <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> TLS <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> X.509
              <?><?> <?><?><?><?><?><?><?> DER <?><?><?><?> <?><?> <?><?> PEM
              <?><?><?><?><?> <?><?><?> <?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_CLIENT_CERTIFICATE
              <?><?><?><?> <?><?><?>.

       --client-private-key <FILEPATH>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> TLS.

              <?><?><?><?><?> <?><?> --client-cert <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> TLS <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> ASN.1
              <?><?> <?><?><?><?><?><?><?> DER <?><?> <?><?><?><?> PKCS#8
              <?><?><?><?> <?><?> <?><?> PEM <?><?><?><?><?> <?><?><?>
              <?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> MQTTUI_CLIENT_PRIVATE_KEY
              <?><?><?><?> <?><?><?>.

       --insecure
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> TLS

                                   read-one                 mqttui-read-one(1)