Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PAHO_C_PUB(1L)							PAHO_C_PUB(1L)

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

SYNOPSIS
       paho_c_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 mes-
       sage] [-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_c_pub sends	data to	an MQTT	server using the Eclipse Paho C	client
       asynchronous library (MQTTAsync).  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_c_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://local-
	      host: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 --connec-
	      tion.

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

       -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 mes-
	      sages 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 applica-
	      tion 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.

http://eclipse.org/paho	     31	July 2018 (v1.3.0)		PAHO_C_PUB(1L)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=paho_c_pub&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help