PAHO_CS_PUB(1L)

NAME
paho_cs_pub - send (publish) data to an MQTT server

SYNOPSIS
paho_cs_pub [topic] [-t|--topic topic] [-c|--connection connection] [-h|--host hostname] [-p|--port portnumber] [-i|--clientid clientid] [-u|--username username] [-P|--password password] [-k|--keepalive keepalive-timeout] [-V|--MQTT-version 31|311|5]
[-q|--qos 0|1|2] [-r|--retained] [-n|--null-message] [-m|--message message] [-f|--filename filename] [--delimiter delimiter] [--maxdatalen maxdatalen]
[--message-expiry expiry-interval] [--user-property name value]
[--quiet] [--verbose] [--trace min|max|error|protocol]
[--will-topic will-topic] [--will-payload will-payload] [--will-retain] [--will-qos 0|1|2]
[--cafile cafile] [--capath capath] [--cert certfile] [--key keyfile] [--keypass password] [--ciphers cipher-string] [--insecure]

DESCRIPTION
paho_cs_pub sends data to an MQTT server using the Eclipse Paho C client synchronous library (MQTTClient). MQTT is a protocol, operating over TCP/IP, which allows programs to easily communicate with each other through a server. Messages are published to topics and delivered to any subscribers to those topics. The corresponding subscriber program paho_cs_sub allows the receipt of MQTT messages.

The default mode of operation is to read input from stdin, sending a separate message for each line read. Options exist to change this mode to send a one-off message, of 0 length (-n), a given string (-m), or the contents of a file (-f).

OPTIONS

-t
--topic
    The MQTT topic to publish the data to.

-c
--connection
    The MQTT URI to connect to, a combination of transport prefix, host, port and for websockets, topic. To connect using TCP use the tcp prefix, for example: tcp://localhost:1883. An example using SSL/TLS: ssl://localhost:1883. An example for websockets, insecure: ws://localhost:1883/topic, and secure: wss://localhost:80/topic.

-h
--host
    The TCP/IP host name of the MQTT server to connect to. Along with the --port option, an older alternative to using --connection.

-p
--port
    The TCP/IP port number of the MQTT server to connect to. Along with the --host option, an older alternative to using --connection.

-q
--qos
    The MQTT QoS on which to publish the message. The alternatives are 0, 1 or 2.

-V
--MQTTversion
    The version of the MQTT protocol to use. Valid options are 31 (or mqttv31), 311 (mqttv311) and 5 (or mqttv5). If MQTT version 5 is used, then some additional options are valid, such as --message-expiry and --user-property.

--quiet
    Do not print error messages.

--trace
    Print library internal trace. Valid levels are min, max, error and rotocol.

-r
--retained
    Publish messages with the MQTT retained flag set.

-n
--null-message
    Publish a 0-length message.

-m
--message
    Publish a one off message with the payload supplied.

-f
--filename
    Publish a one off message with the contents of the file whose name is given.

--message-expiry
    [MQTT version 5 only] Sets the expiry interval property of messages in seconds.

--user-property
    [MQTT version 5 only] Sets a user property of sent messages. A pair of strings, name and value.

--will-topic
    Sets the MQTT will message topic to publish to. If the application ends without sending an MQTT disconnect, the will message will be published to this topic.

--will-payload
    Only used if will-topic is set. Sets the MQTT will message to be published.

--will-qos
    Only used if will-topic is set. Sets the MQTT QoS at which the will message is published. The alternatives are 0, 1 or 2.

--will-retain
    Only used if will-topic is set. Sets the MQTT retained flag on the will message.

--cafile
    Only used with a TLS connection. The name of a file for the OpenSSL trust store.

--capath
    Only used with a TLS connection. The name of a directory holding OpenSSL trusted certificates.

--cert
    Only used with a TLS connection. The name of a file for the TLS keystore containing a client certificate to be presented.

--key
    Only used with a TLS connection. The name of a file containing the client private key.

--keypass
    Only used with a TLS connection. The password for the client private key file, if needed.

--ciphers
    Only used with a TLS connection. A list of cipher suites that the client will present to the server during the TLS handshake.

--insecure
    Only used with a TLS connection. Don't check that the server certificate common name matches the hostname.