Unix and Linux Discussions Tagged with member_project |
|
Thread / Thread Starter |
Last Post |
Replies |
Views |
Forum |
|
|
|
1 |
14,408 |
What is on Your Mind? |
|
|
|
19 |
33,339 |
What is on Your Mind? |
|
|
|
0 |
47,705 |
OS X (Apple) |
|
|
|
1 |
15,151 |
Programming |
|
|
|
52 |
40,695 |
What is on Your Mind? |
|
|
|
8 |
15,500 |
What is on Your Mind? |
|
|
|
28 |
43,130 |
What is on Your Mind? |
|
|
|
5 |
42,323 |
Linux Benchmarks |
|
|
|
30 |
39,941 |
What is on Your Mind? |
|
|
|
7 |
24,075 |
Programming |
|
|
|
0 |
9,925 |
OS X (Apple) |
|
|
|
5 |
14,142 |
Programming |
|
|
|
8 |
16,207 |
What is on Your Mind? |
|
|
|
5 |
33,496 |
Hardware |
|
|
|
1 |
16,713 |
What is on Your Mind? |
|
|
|
10 |
18,698 |
Programming |
|
|
|
45 |
58,308 |
UNIX for Advanced & Expert Users |
|
|
|
0 |
19,129 |
Programming |
|
|
|
0 |
17,698 |
Programming |
|
|
|
2 |
25,134 |
Infrastructure Monitoring |
|
|
|
6 |
20,637 |
Programming |
|
|
|
6 |
14,854 |
Programming |
|
|
|
8 |
24,871 |
Programming |
|
|
|
0 |
16,973 |
Programming |
|
|
|
13 |
26,915 |
Programming |
|
|
|
7 |
23,727 |
Programming |
|
|
|
2 |
14,003 |
Shell Programming and Scripting |
|
|
|
8 |
32,963 |
OS X (Apple) |
|
|
|
1 |
13,042 |
Programming |
|
|
|
1 |
16,273 |
Shell Programming and Scripting |
|
|
|
10 |
24,107 |
Programming |
|
|
|
6 |
16,424 |
UNIX for Advanced & Expert Users |
|
|
|
1 |
15,312 |
Programming |
|
|
|
0 |
14,341 |
Programming |
|
|
|
8 |
22,894 |
Programming |
|
|
|
10 |
18,047 |
What is on Your Mind? |
|
|
|
6 |
14,499 |
Programming |
|
|
|
9 |
31,910 |
Programming |
|
|
|
0 |
33,653 |
Programming |
|
|
|
6 |
16,813 |
Programming |
mosquitto_pub(1) mosquitto_pub(1)
NAME
mosquitto_pub - an mqtt version 3.1 client for publishing simple messages
SYNOPSIS
mosquitto_pub [-d] [-h hostname] [-i client_id] [-I client id prefix] [-p port number] [-q message QoS] [--quiet] [-r] { -f file | -l | -m
message | -n | -s} [ -u username [-P password] ] [ --will-topic topic [--will-payload payload] [--will-qos qos] [--will-
retain] ] -t message-topic
DESCRIPTION
mosquitto_pub is a simple mqtt version 3.1 client that will publish a single message on a topic and exit.
OPTIONS
-d, --debug
Enable debug messages.
-f, --file
Send the contents of a file as the message.
-h, --host
Specify the host to connect to. Defaults to localhost.
-i, --id
The id to use for this client. If not given, defaults to mosquitto_pub_ appended with the process id of the client. Cannot be used
at the same time as the --id-prefix argument.
-I, --id-prefix
Provide a prefix that the client id will be built from by appending the process id of the client. This is useful where the broker is
using the clientid_prefixes option. Cannot be used at the same time as the --id argument.
-l, --stdin-line
Send messages read from stdin, splitting separate lines into separate messages. Note that blank lines won't be sent.
-m, --message
Send a single message from the command line.
-n, --null-message
Send a null (zero length) message.
-p, --port
Connect to the port specified instead of the default 1883.
-P, --pw
Provide a password to be used for authenticating with the broker. Using this argument without also specifying a username is invalid.
This requires a broker that supports MQTT v3.1. See also the --username option.
-q, --qos
Specify the quality of service to use for the message, from 0, 1 and 2. Defaults to 0.
--quiet
If this argument is given, no runtime errors will be printed. This excludes any error messages given in case of invalid user input
(e.g. using --port without a port).
-r, --retain
If retain is given, the message will be retained as a "last know good" value on the broker. See mqtt(7) for more information.
-s, --stdin-file
Send a message read from stdin, sending the entire content as a single message.
-t, --topic
The mqtt topic on which to publish the message. See mqtt(7) for more information on mqtt topics.
-u, --username
Provide a username to be used for authenticating with the broker. This requires a broker that supports MQTT v3.1. See also the --pw
argument.
--will-payload
Specify a message that will be stored by the broker and sent out if this client disconnects unexpectedly. This must be used in con-
junction with --will-topic.
--will-qos
The QoS to use for the Will. Defaults to 0. This must be used in conjunction with --will-topic.
--will-retain
If given, if the client disconnects unexpectedly the message sent out will be treated as a retained message. This must be used in
conjunction with --will-topic.
--will-topic
The topic on which to send a Will, in the event that the client disconnects unexpectedly.
WILLS
mosquitto_sub can register a message with the broker that will be sent out if it disconnects unexpectedly. See mqtt(7) for more informa-
tion.
The minimum requirement for this is to use --will-topic to specify which topic the will should be sent out on. This will result in a non-
retained, zero length message with QoS 0.
Use the --will-retain, --will-payload and --will-qos arguments to modify the other will parameters.
EXAMPLES
Publish temperature information to localhost with QoS 1:
o mosquitto_pub -t sensors/temperature -m 32 -q 1
Publish timestamp and temperature information to a remote host on a non-standard port and QoS 0:
o mosquitto_pub -h 192.168.1.1 -p 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:
o mosquitto_pub -r -t switches/kitchen_lights/status -m "on"
Send the contents of a file in two ways:
o mosquitto_pub -t my/topic -f ./data
o mosquitto_pub -t my/topic -s < ./data
Send parsed electricity usage data from a Current Cost meter, reading from stdin with one line/reading as one message:
o read_cc128.pl | mosquitto_pub -t sensors/cc128 -l
BUGS
mosquitto_pub bug information can be found at http://launchpad.net/mosquitto
SEE ALSO
mqtt(7) mosquitto_sub(1) mosquitto(8) libmosquitto(3)
AUTHOR
Roger Light <roger@atchoo.org>
5 February 2012 mosquitto_pub(1)