Link Search Menu Expand Document Edit GitHub


The publish with a context works almost the same as Publish, but it will not create a new connection and publish with a new client. Instead, it uses the currently active context client.

client@host> publish

Alias: client@host> pub


Publish Options

OptionLong VersionExplanationDefault
-t--topicThe MQTT topic to which the message will be published. 
-m--messageThe message which will be published on the topic. 
-m:file--message-fileThe file containing the payload which will be published on the topic. 
-m:empty--message-emptySets the message to an empty payload. 
-r--[no-]retainWhether the message will be retained.false
-q--qosDefine the quality of service level. If only one QoS is specified it will be used for all topics.
You can define a specific QoS level for every topic. The corresponding QoS levels will be matched in order to the given topics.
-e--messageExpiryIntervalThe lifetime of the publish message in seconds. 
-ct--contentTypeA description of the content of the publish message. 
-cd--correlationDataThe correlation data of the publish message. 
-pf--payloadFormatIndicatorThe payload format indicator of the publish message. 
-rt--responseTopicThe topic name for the response message of the publish message. 
-up--userPropertyA user property of the publish message. 

Help Options

OptionLong VersionExplanation
-h--helpDisplay help message for command.
-V--versionDisplay version information of the cli.


Publish with a client identified with myClient to the default settings:

mqtt> con -i myClient
myClient@localhost> pub -t test -m msg