change name in CLI docs

pull/80/head
Florian Ludwig 2021-07-07 19:30:21 +02:00
rodzic 635ab039e7
commit b958b6b29c
3 zmienionych plików z 43 dodań i 43 usunięć

Wyświetl plik

@ -1,31 +1,31 @@
hbmqtt amqtt
====== ======
``hbmqtt`` is a command-line script for running a MQTT 3.1.1 broker. ``amqtt`` is a command-line script for running a MQTT 3.1.1 broker.
Usage Usage
----- -----
``hbmqtt`` usage : ``amqtt`` usage :
:: ::
hbmqtt --version amqtt --version
hbmqtt (-h | --help) amqtt (-h | --help)
hbmqtt [-c <config_file> ] [-d] amqtt [-c <config_file> ] [-d]
Options Options
------- -------
--version HBMQTT version information --version amqtt version information
-h, --help Display ``hbmqtt_sub`` usage help -h, --help Display ``amqtt_sub`` usage help
-c Set the YAML configuration file to read and pass to the client runtime. -c Set the YAML configuration file to read and pass to the client runtime.
Configuration Configuration
------------- -------------
If ``-c`` argument is given, ``hbmqtt`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements : If ``-c`` argument is given, ``amqtt`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements :
* ``listeners`` : network bindings configuration list * ``listeners`` : network bindings configuration list
* ``timeout-disconnect-delay`` : client disconnect timeout after keep-alive timeout * ``timeout-disconnect-delay`` : client disconnect timeout after keep-alive timeout
@ -46,7 +46,7 @@ Without the ``-c`` argument, the broker will run with the following default conf
- auth_file - auth_file
- auth_anonymous - auth_anonymous
Using this configuration, ``hbmqtt`` will start a broker : Using this configuration, ``amqtt`` will start a broker :
* listening on TCP port 1883 on all network interfaces. * listening on TCP port 1883 on all network interfaces.
* Publishing ``$SYS``_ update messages every ``20`` seconds. * Publishing ``$SYS``_ update messages every ``20`` seconds.

Wyświetl plik

@ -1,39 +1,39 @@
hbmqtt_pub amqtt_pub
========== ==========
``hbmqtt_pub`` is a MQTT client that publishes simple messages on a topic from the command line. ``amqtt_pub`` is a MQTT client that publishes simple messages on a topic from the command line.
Usage Usage
----- -----
``hbmqtt_pub`` usage : :: ``amqtt_pub`` usage : ::
hbmqtt_pub --version amqtt_pub --version
hbmqtt_pub (-h | --help) amqtt_pub (-h | --help)
hbmqtt_pub --url BROKER_URL -t TOPIC (-f FILE | -l | -m MESSAGE | -n | -s) [-c CONFIG_FILE] [-i CLIENT_ID] [-d] amqtt_pub --url BROKER_URL -t TOPIC (-f FILE | -l | -m MESSAGE | -n | -s) [-c CONFIG_FILE] [-i CLIENT_ID] [-d]
[-q | --qos QOS] [-d] [-k KEEP_ALIVE] [--clean-session] [-q | --qos QOS] [-d] [-k KEEP_ALIVE] [--clean-session]
[--ca-file CAFILE] [--ca-path CAPATH] [--ca-data CADATA] [--ca-file CAFILE] [--ca-path CAPATH] [--ca-data CADATA]
[ --will-topic WILL_TOPIC [--will-message WILL_MESSAGE] [--will-qos WILL_QOS] [--will-retain] ] [ --will-topic WILL_TOPIC [--will-message WILL_MESSAGE] [--will-qos WILL_QOS] [--will-retain] ]
[--extra-headers HEADER] [--extra-headers HEADER]
Note that for simplicity, ``hbmqtt_pub`` uses mostly the same argument syntax as `mosquitto_pub`_. Note that for simplicity, ``amqtt_pub`` uses mostly the same argument syntax as `mosquitto_pub`_.
.. _mosquitto_pub: http://mosquitto.org/man/mosquitto_pub-1.html .. _mosquitto_pub: http://mosquitto.org/man/mosquitto_pub-1.html
Options Options
------- -------
--version HBMQTT version information --version amqtt version information
-h, --help Display ``hbmqtt_pub`` usage help -h, --help Display ``amqtt_pub`` usage help
-c Set the YAML configuration file to read and pass to the client runtime. -c Set the YAML configuration file to read and pass to the client runtime.
-d Enable debugging informations. -d Enable debugging informations.
--ca-file Define the path to a file containing PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-file Define the path to a file containing PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--ca-path Define the path to a directory containing PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-path Define the path to a directory containing PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--ca-data Set the PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-data Set the PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--clean-session If given, set the CONNECT clean session flag to True. --clean-session If given, set the CONNECT clean session flag to True.
-f Send the contents of a file as the message. The file is read line by line, and ``hbmqtt_pub`` will publish a message for each line read. -f Send the contents of a file as the message. The file is read line by line, and ``amqtt_pub`` will publish a message for each line read.
-i The id to use for this client. If not given, defaults to ``hbmqtt_pub/`` appended with the process id and the hostname of the client. -i The id to use for this client. If not given, defaults to ``amqtt_pub/`` appended with the process id and the hostname of the client.
-l Send messages read from stdin. ``hbmqtt_pub`` will publish a message for each line read. Blank lines won't be sent. -l Send messages read from stdin. ``amqtt_pub`` will publish a message for each line read. Blank lines won't be sent.
-k Set the CONNECT keep alive timeout. -k Set the CONNECT keep alive timeout.
-m Send a single message from the command line. -m Send a single message from the command line.
-n Send a null (zero length) message. -n Send a null (zero length) message.
@ -54,7 +54,7 @@ Options
Configuration Configuration
------------- -------------
If ``-c`` argument is given, ``hbmqtt_pub`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements : If ``-c`` argument is given, ``amqtt_pub`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements :
* ``keep_alive`` : Keep-alive timeout sent to the broker. Defaults to ``10`` seconds. * ``keep_alive`` : Keep-alive timeout sent to the broker. Defaults to ``10`` seconds.
* ``ping_delay`` : Auto-ping delay before keep-alive timeout. Defaults to 1. Setting to ``0`` will disable to 0 and may lead to broker disconnection. * ``ping_delay`` : Auto-ping delay before keep-alive timeout. Defaults to 1. Setting to ``0`` will disable to 0 and may lead to broker disconnection.
@ -76,29 +76,29 @@ Examples below are adapted from `mosquitto_pub`_ documentation.
Publish temperature information to localhost with QoS 1: Publish temperature information to localhost with QoS 1:
:: ::
hbmqtt_pub --url mqtt://localhost -t sensors/temperature -m 32 -q 1 amqtt_pub --url mqtt://localhost -t sensors/temperature -m 32 -q 1
Publish timestamp and temperature information to a remote host on a non-standard port and QoS 0: Publish timestamp and temperature information to a remote host on a non-standard port and QoS 0:
:: ::
hbmqtt_pub --url mqtt://192.168.1.1:1885 -t sensors/temperature -m "1266193804 32" amqtt_pub --url mqtt://192.168.1.1:1885 -t sensors/temperature -m "1266193804 32"
Publish light switch status. Message is set to retained because there may be a long period of time between light switch events: Publish light switch status. Message is set to retained because there may be a long period of time between light switch events:
:: ::
hbmqtt_pub --url mqtt://localhost -r -t switches/kitchen_lights/status -m "on" amqtt_pub --url mqtt://localhost -r -t switches/kitchen_lights/status -m "on"
Send the contents of a file in two ways: Send the contents of a file in two ways:
:: ::
hbmqtt_pub --url mqtt://localhost -t my/topic -f ./data amqtt_pub --url mqtt://localhost -t my/topic -f ./data
hbmqtt_pub --url mqtt://localhost -t my/topic -s < ./data amqtt_pub --url mqtt://localhost -t my/topic -s < ./data
Publish temperature information to localhost with QoS 1 over mqtt encapsulated in a websocket connection and additional headers: Publish temperature information to localhost with QoS 1 over mqtt encapsulated in a websocket connection and additional headers:
:: ::
hbmqtt_pub --url wss://localhost -t sensors/temperature -m 32 -q 1 --extra-headers '{"Authorization": "Bearer <token>"}' amqtt_pub --url wss://localhost -t sensors/temperature -m 32 -q 1 --extra-headers '{"Authorization": "Bearer <token>"}'
.. _mosquitto_pub : http://mosquitto.org/man/mosquitto_pub-1.html .. _mosquitto_pub : http://mosquitto.org/man/mosquitto_pub-1.html

Wyświetl plik

@ -1,34 +1,34 @@
hbmqtt_sub amqtt_sub
========== ==========
``hbmqtt_sub`` is a command line MQTT client that subscribes to some topics and output data received from messages published. ``amqtt_sub`` is a command line MQTT client that subscribes to some topics and output data received from messages published.
Usage Usage
----- -----
``hbmqtt_sub`` usage : :: ``amqtt_sub`` usage : ::
hbmqtt_sub --version amqtt_sub --version
hbmqtt_sub (-h | --help) amqtt_sub (-h | --help)
hbmqtt_sub --url BROKER_URL -t TOPIC... [-n COUNT] [-c CONFIG_FILE] [-i CLIENT_ID] [-q | --qos QOS] [-d] amqtt_sub --url BROKER_URL -t TOPIC... [-n COUNT] [-c CONFIG_FILE] [-i CLIENT_ID] [-q | --qos QOS] [-d]
[-k KEEP_ALIVE] [--clean-session] [--ca-file CAFILE] [--ca-path CAPATH] [--ca-data CADATA] [-k KEEP_ALIVE] [--clean-session] [--ca-file CAFILE] [--ca-path CAPATH] [--ca-data CADATA]
[ --will-topic WILL_TOPIC [--will-message WILL_MESSAGE] [--will-qos WILL_QOS] [--will-retain] ] [ --will-topic WILL_TOPIC [--will-message WILL_MESSAGE] [--will-qos WILL_QOS] [--will-retain] ]
[--extra-headers HEADER] [--extra-headers HEADER]
Note that for simplicity, ``hbmqtt_sub`` uses mostly the same argument syntax as `mosquitto_sub`_. Note that for simplicity, ``amqtt_sub`` uses mostly the same argument syntax as `mosquitto_sub`_.
Options Options
------- -------
--version HBMQTT version information --version amqtt version information
-h, --help Display ``hbmqtt_sub`` usage help -h, --help Display ``amqtt_sub`` usage help
-c Set the YAML configuration file to read and pass to the client runtime. -c Set the YAML configuration file to read and pass to the client runtime.
-d Enable debugging informations. -d Enable debugging informations.
--ca-file Define the path to a file containing PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-file Define the path to a file containing PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--ca-path Define the path to a directory containing PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-path Define the path to a directory containing PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--ca-data Set the PEM encoded CA certificates that are trusted. Used to enable SSL communication. --ca-data Set the PEM encoded CA certificates that are trusted. Used to enable SSL communication.
--clean-session If given, set the CONNECT clean session flag to True. --clean-session If given, set the CONNECT clean session flag to True.
-i The id to use for this client. If not given, defaults to ``hbmqtt_sub/`` appended with the process id and the hostname of the client. -i The id to use for this client. If not given, defaults to ``amqtt_sub/`` appended with the process id and the hostname of the client.
-k Set the CONNECT keep alive timeout. -k Set the CONNECT keep alive timeout.
-n Number of messages to read before ending. Read forever if not given. -n Number of messages to read before ending. Read forever if not given.
-q, --qos Specify the quality of service to use for receiving messages. This QoS is sent in the subscribe request. -q, --qos Specify the quality of service to use for receiving messages. This QoS is sent in the subscribe request.
@ -47,7 +47,7 @@ Options
Configuration Configuration
------------- -------------
If ``-c`` argument is given, ``hbmqtt_sub`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements : If ``-c`` argument is given, ``amqtt_sub`` will read specific MQTT settings for the given configuration file. This file must be a valid `YAML`_ file which may contains the following configuration elements :
* ``keep_alive`` : Keep-alive timeout sent to the broker. Defaults to ``10`` seconds. * ``keep_alive`` : Keep-alive timeout sent to the broker. Defaults to ``10`` seconds.
* ``ping_delay`` : Auto-ping delay before keep-alive timeout. Defaults to 1. Setting to ``0`` will disable to 0 and may lead to broker disconnection. * ``ping_delay`` : Auto-ping delay before keep-alive timeout. Defaults to 1. Setting to ``0`` will disable to 0 and may lead to broker disconnection.
@ -69,17 +69,17 @@ Examples below are adapted from `mosquitto_sub`_ documentation.
Subscribe with QoS 0 to all messages published under $SYS/: Subscribe with QoS 0 to all messages published under $SYS/:
:: ::
hbmqtt_sub --url mqtt://localhost -t '$SYS/#' -q 0 amqtt_sub --url mqtt://localhost -t '$SYS/#' -q 0
Subscribe to 10 messages with QoS 2 from /#: Subscribe to 10 messages with QoS 2 from /#:
:: ::
hbmqtt_sub --url mqtt://localhost -t /# -q 2 -n 10 amqtt_sub --url mqtt://localhost -t /# -q 2 -n 10
.. _mosquitto_sub : http://mosquitto.org/man/mosquitto_sub-1.html .. _mosquitto_sub : http://mosquitto.org/man/mosquitto_sub-1.html
Subscribe with QoS 0 to all messages published under $SYS/: over mqtt encapsulated in a websocket connection and additional headers: Subscribe with QoS 0 to all messages published under $SYS/: over mqtt encapsulated in a websocket connection and additional headers:
:: ::
hbmqtt_sub --url wss://localhost -t '$SYS/#' -q 0 --extra-headers '{"Authorization": "Bearer <token>"}' amqtt_sub --url wss://localhost -t '$SYS/#' -q 0 --extra-headers '{"Authorization": "Bearer <token>"}'