1MQTT-SIMPLE(1)        User Contributed Perl Documentation       MQTT-SIMPLE(1)
2
3
4

NAME

6       mqtt-simple - Very simple MQTT implementation
7

SYNOPSIS

9        mqtt-simple -h mqtt.example.org -c -s "sensors/#" -s "debug/#" -s "#"
10
11        mqtt-simple -h mqtt.example.org -p "example/unretained" -m "message"
12
13        mqtt-simple -h mqtt.example.org -r -p "example/retained" -m "message"
14
15        tail -f logfile | mqtt-simple -h mqtt.example.org -p "log/example"
16
17        mqtt-simple --ssl --insecure ...
18
19        mqtt-simple --ssl --ca ca.crt --cert client.crt --key client.key
20

DESCRIPTION

22       This is just a simple utility program. It doesn't do much.
23       Specifically, all the QoS and username/password features are
24       unsupported. Also, don't expect fancy error messages and such :-)
25

COMMAND LINE OPTIONS

27       -h --host                MQTT server to connect to, required.
28
29       -p --publish topic       Publish a message. Uses the message given with
30                                "-m", or will read lines from stdin, and
31                                publish a message for each given line.
32
33       -m --message message     Message to publish. Requires "-p".
34
35       -r --retain              Causes messages published with "-p" to have
36                                the "retain" flag on.
37
38       -s --subscribe filter    Subscribe to the given topic filter. Use the
39                                standard MQTT wildcards like "+" and "#".
40                                Outputs matching published messages on stdout.
41                                Can be given multiple times.
42
43       -e --except filter       Suppress published messages that match filter.
44                                Can be given multiple times.
45
46       --count number           Quit after receiving number messages.
47
48       --message-only           Output only the message values, without the
49                                topics.
50
51       -1 --one                 Shortcut for "--count 1 --message-only".
52
53       --color
54       --no-color               For each given "-s", print the matching topic
55                                in a different color. Note that the first
56                                matching topic will be used for color
57                                selection, so specify the topics with the most
58                                specific one first, the least specific one
59                                (like "#") last.
60
61                                Color is enabled by default if stdout is a
62                                terminal.
63
64       --raw                    Pass ASCII control characters unaltered. By
65                                default, they're replaced by "^@" notation or,
66                                when "--color" is enabled, reverse video
67                                characters. For example, an ASCII newline
68                                would be displayed as "^J" unless "--raw" is
69                                used.
70
71       -d --datetime format     Prefix messages with a timestamp. Optionally,
72                                a format for "strftime" can be supplied.
73
74   SSL options
75       --ssl                    Use SSL instead of unencrypted connection.
76
77       --insecure               Disable SSL certificate validation and enable
78                                clear text passwords. Useful for testing, bad
79                                idea in production.
80
81                                Overrides the environment variable
82                                "MQTT_SIMPLE_SSL_INSECURE" and
83                                "MQTT_SIMPLE_ALLOW_INSECURE_LOGIN".
84
85       --ca path                The Certificate Authority to validate against.
86                                path can be a file or a directory. If
87                                unspecified, IO::Socket::SSL attempts to use
88                                the system wide CA configuration.
89
90                                Overrides the environment variable
91                                "MQTT_SIMPLE_SSL_CA".
92
93       --cert path
94       --key path               A client certificate with its key.
95
96                                Override the environment variables
97                                "MQTT_SIMPLE_SSL_CERT" and
98                                "MQTT_SIMPLE_SSL_KEY".
99

LICENSE

101       Pick your favourite OSI approved license :)
102
103       http://www.opensource.org/licenses/alphabetical
104

AUTHOR

106       Juerd Waalboer <juerd@tnx.nl>
107

SEE ALSO

109       Net::MQTT::Simple
110
111
112
113perl v5.28.1                      2018-12-01                    MQTT-SIMPLE(1)