Only create /run/mosquitto at runtime.

Per policy, packages shouldn't contain directories in /run. This means
/run/mosquitto should be created at boot time. Closes #983429.

debian/README-ca_certificates

@@ -0,0 +1 @@
+Place your SSL/TLS Certificate Authority certificates in this directory.

debian/README-certs

@@ -0,0 +1,3 @@
+Place your SSL/TLS server keys and certificates in this directory.
+
+This directory should only be readable by the mosquitto user.

debian/README-conf-d

@@ -0,0 +1,2 @@
+Any files placed in this directory that have a .conf ending will be loaded as
+config files by the broker. Use this to make your local config.

debian/README.Debian

@@ -0,0 +1,7 @@
+Apparmor Profile
+----------------
+If your system uses AppArmor, please note that the shipped enforcing profile
+works with the default installation, and changes in your configuration may
+require changes to the installed apparmor profile. Please see
+https://wiki.ubuntu.com/DebuggingApparmor before filing a bug against this
+software.

debian/changelog

@@ -0,0 +1,459 @@
+mosquitto (2.0.8-2) unstable; urgency=medium
+
+  * Remove debian-config.patch, this is already handled with
+    debian/mosquitto.conf
+  * Per policy, packages shouldn't contain directories in /run. This means
+    /run/mosquitto should be created at boot time. Closes #983429.
+
+ -- Roger A. Light <roger@atchoo.org>  Sun, 28 Feb 2021 23:22:57 +0000
+
+mosquitto (2.0.8-1) unstable; urgency=medium
+
+  * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 25 Feb 2021 18:56:57 +0000
+
+mosquitto (2.0.7-3) unstable; urgency=medium
+
+  * Change all paths `/var/run` to `/run` to avoid installing through a
+    symlink.
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 09 Feb 2021 09:31:09 +0000
+
+mosquitto (2.0.7-2) unstable; urgency=medium
+
+  * Add new xsltproc and docbook-xsl dependencies needed to build manpages.
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Mon, 08 Feb 2021 21:55:11 +0100
+
+mosquitto (2.0.7-1) unstable; urgency=medium
+
+  * New upstream release.
+  * License has changed from EPL-1.0 OR EDL-1.0 to EPL-2.0 OR EDL-1.0.
+  * New dependency, libcjson
+  * Remove install-protocol.patch, this has been fixed upstreamed.
+  * pid file moved to /var/run/mosquitto/mosquitto.pid because mosquitto is no
+    longer root when it tries to create that file.
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 4 Feb 2021 23:27:31 +0000
+
+mosquitto (1.6.12-1) unstable; urgency=medium
+
+    * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 19 Aug 2020 15:24:26 +0100
+
+mosquitto (1.6.11-1) unstable; urgency=medium
+
+  * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 11 Aug 2020 16:53:20 +0100
+
+mosquitto (1.6.9-1) unstable; urgency=medium
+
+  * New upstream release.
+  * Revert change enabling SRV functionality, it is disabled by default
+    upstream and of little benefit to any end user, but adds reasonable
+    complexity to the code.
+  * Remove patches 1568, 1569, 1570 - applied upstream.
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 03 Mar 2020 15:16:15 +0000
+
+mosquitto (1.6.8-2) unstable; urgency=medium
+
+  * Also install mqtt_protocol.h in libmosquitto-dev package.
+    (Closes: #951116)
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Sat, 15 Feb 2020 19:51:49 +0100
+
+mosquitto (1.6.8-1) unstable; urgency=medium
+
+  * Upload to unstable
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Sat, 08 Feb 2020 09:35:50 +0100
+
+mosquitto (1.6.8-1~exp3) experimental; urgency=medium
+
+  * Tweak patch 1570 to fix a build failure with non-libc libraries
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Sat, 25 Jan 2020 10:47:39 +0100
+
+mosquitto (1.6.8-1~exp2) experimental; urgency=medium
+
+  * Add libcares-dev dependency, to enable SRV functionality
+  * Bump std-version to 4.5.0, no changes required
+  * Simplify rules file, avoding the systemd hack in configure script
+  * Rename patches with the upstream PR number on github.
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Fri, 24 Jan 2020 14:19:46 +0100
+
+mosquitto (1.6.8-1~exp1) experimental; urgency=medium
+
+  * New upstream version 1.6.8 (Closes: #949585)
+  * Also install examples into etc directory
+  * Install missing mosquitto_broker.h header file
+  * Add mosquitto_rr to tools
+  * Install manpages into debian/*.manpages files
+  * Fix installation of libraries in case soname is added to the so file
+  * Bump std-version to 4.4.1, no changes required
+  * Require uthash at least 2.1.0, previously the embedded version was used during build process
+  * Bump compat level to 12
+  * Switch build system to cmake
+  * Do not override dh_auto_test anymore
+
+ -- Gianfranco Costamagna <locutusofborg@debian.org>  Wed, 22 Jan 2020 12:23:22 +0100
+
+mosquitto (1.6.7-1) unstable; urgency=medium
+
+  * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 25 Sep 2019 13:31:51 +0100
+
+mosquitto (1.6.6-1) unstable; urgency=high
+
+  * SECURITY UPDATE: If an MQTT v5 client connects to Mosquitto, sets a last
+    will and testament, sets a will delay interval, sets a session expiry
+    interval, and the will delay interval is set longer than the session
+    expiry interval, then a use after free error occurs, which has the
+    potential to cause a crash in some situations.
+    - CVE awaiting assignment
+  * SECURITY UPDATE: If a malicious MQTT client sends a SUBSCRIBE packet
+    containing a topic that consists of approximately 65400 or more '/'
+    characters, i.e. the topic hierarchy separator, then a stack overflow will
+    occur.
+    - CVE awaiting assignment
+  * New upstream release.
+  * Remove bug-1367.patch.
+  * Don't use killall in mosquitto.logrotate. Closes: #940229.
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 17 Sep 2019 18:41:36 +0100
+
+mosquitto (1.6.4-1) unstable; urgency=medium
+
+  * New upstream release.
+  * Bump standards version to 4.4.0, no changes needed.
+  * bug-1367.patch: fix bug with v5 DISCONNECT packets with remaining_length =
+    2 being treated as a protocol error. Fixed upstream for 1.6.5 or 1.7.
+  * Added override_dh_makeshlibs for catching symbol errors.
+  * Add --retry to init file as per
+    https://github.com/eclipse/mosquitto/issues/1117
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 01 Aug 2019 22:51:08 +0100
+
+mosquitto (1.5.7-1) unstable; urgency=medium
+
+  * New upstream release.
+  * Remove fix-step3.patch, fixed upstream.
+  * bug-1162.patch: fix bug with clients being disconnected in some situations
+    when ACLs are in use.
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 18 Feb 2019 09:28:40 +0000
+
+mosquitto (1.5.6-1) unstable; urgency=medium
+
+  * SECURITY UPDATE: If Mosquitto is configured to use a password file for
+    authentication, any malformed data in the password file will be treated as
+    valid. This typically means that the malformed data becomes a username and
+    no password. If this occurs, clients can circumvent authentication and get
+    access to the broker by using the malformed username. In particular, a blank
+    line will be treated as a valid empty username. Other security measures are
+    unaffected. Users who have only used the mosquitto_passwd utility to create
+    and modify their password files are unaffected by this vulnerability.
+    - debian/patches/mosquitto-1.4.x-cve-2018-12551.patch: this fix introduces
+      more stringent parsing tests on the password file data.
+    - CVE-2018-12551
+  * SECURITY UPDATE: If an ACL file is empty, or has only blank lines or
+    comments, then mosquitto treats the ACL file as not being defined, which
+    means that no topic access is denied. Although denying access to all
+    topics is not a useful configuration, this behaviour is unexpected and
+    could lead to access being incorrectly granted in some circumstances.
+    - debian/patches/mosquitto-1.4.x-cve-2018-12550.patch: this fix ensures
+      that if an ACL file is defined but no rules are defined, then access will
+      be denied.
+    - CVE-2018-12550
+  * SECURITY UPDATE: If a client publishes a retained message to a topic that
+    they have access to, and then their access to that topic is revoked, the
+    retained message will still be delivered to future subscribers. This
+    behaviour may be undesirable in some applications, so a configuration
+    option `check_retain_source` has been introduced to enforce checking of
+    the retained message source on publish.
+    - debian/patches/mosquitto-1.4.8-cve-2018-12546.patch: this patch stores
+      the originator of the retained message, so security checking can be
+      carried out before re-publishing. The complexity of the patch is due to
+      the need to save this information across broker restarts.
+    - CVE-2018-12546
+  * New upstream release.
+  * Bump standards version to 4.3.0, no changes needed.
+  * fix-step3.patch: fix compilation error.
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 07 Feb 2019 16:00:52 +0000
+
+mosquitto (1.5.5-1.1) unstable; urgency=medium
+
+  * Non-maintainer upload.
+  * Only chown mosquitto.log if it exists. (Closes: #916558)
+
+ -- Andreas Henriksson <andreas@fatal.se>  Sat, 22 Dec 2018 16:54:06 +0100
+
+mosquitto (1.5.5-1) unstable; urgency=medium
+
+  * SECURITY UPDATE: If the option `per_listener_settings` was set to true,
+    and the default listener was in use, and the default listener specified an
+    `acl_file`, then the acl file was being ignored. This affects version 1.5
+    to 1.5.4 inclusive.
+  * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 11 Dec 2018 16:37:32 +0000
+
+mosquitto (1.5.4-2) unstable; urgency=medium
+
+  * debian/patches/914525.patch : Use pkg-config to get systemd libs
+    (Closes: #914525)
+    - This is needed to allow compilation on non-Linux systems.
+  * Fix FTCBFS: Let dh_auto_build pass cross tools to make. Thanks to Helmut
+    Grohne. (Closes: #914593)
+  * Ensure log files are owned by mosquitto. (Closes: #877346)
+
+ -- Roger A. Light <roger@atchoo.org>  Sun, 25 Nov 2018 13:52:16 +0000
+
+mosquitto (1.5.4-1) unstable; urgency=medium
+
+  * New upstream release (Closes: #911104).
+    - Fixes CVE-2017-7654 (Closes: #911265)
+    - Fixes CVE-2017-7653 (Closes: #911266)
+  * Remove no longer needed patches. Some are integrated into upstream, others
+    have been replaced with changes in rules.
+    - async_dns.patch
+    - build-timestamp.patch
+    - disable-in-tree-uthash.patch
+    - enable-libwrap.patch
+    - enable-websockets.patch
+    - fix-prefix.patch
+    - hurd-errno.patch
+    - libdir.patch
+    - nostrip.patch
+  * Copyright fix - src/uthash.h -> src/deps/uthash.h
+  * Update symbols files with new additions.
+  * Remove debian/mosquitto.prerm
+    - Calls to invoke-rc.d to stop mosquitto will be inserted automagically by
+      debhelper.
+  * Stop removing the mosquitto user in postrm.
+    - This is not safe since there might still be logs (and other files?)
+      around owned by the uid, so we don't want it reused for a new user.
+  * Add build dependency on libsystemd-dev.
+  * Enable systemd build support.
+  * Ship the mosquitto.service file (with sd-notify support)
+  * Drop -dbg packages and do -dbgsym migration.
+  * libmosquito{,pp}-dev: ship libmosquitto{,pp}.pc respectively.
+  * Remove unused build dependency on python-all. (Closes: #901424).
+  * Bump standards version to 4.2.1, no changes needed.
+  * Bumped dh compat level to 11.
+  * Add upstream/metadata.
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 08 Nov 2018 13:34:59 +0000
+
+mosquitto (1.4.15-2) unstable; urgency=low
+
+  * Replace mentions of 'c_rehash' with 'openssl rehash'. (Closes: #895084).
+
+ -- Roger A. Light <roger@atchoo.org>  Sat, 07 Apr 2018 11:16:43 +0100
+
+mosquitto (1.4.15-1) unstable; urgency=high
+
+  * SECURITY UPDATE: If a SIGHUP is sent to the broker when there are no more
+    file descriptors, then opening the configuration file will fail and
+    security settings will be set back to their default values.
+    - debian/patches/mosquitto-1.4.10_cve-2017-7652.patch: When reloading
+      configuration, do this into a separate config struct. If nothing fails,
+      then copy the new config over the old config.
+    - CVE-2017-7652
+  * SECURITY UPDATE: Unauthenticated clients can cause excessive memory usage.
+    This has the potential to lead to an OOM situation and the broker being
+    killed by the system.
+    - debian/patches/mosquitto-1.4.10_cve-2017-7652.patch: Limit the maximum
+      size of CONNECT packet to a reasonable value, and add "memory_limit"
+      option to set the maximum memory the broker will use.
+    - CVE-2017-7651
+  * New upstream release.
+  * Remove upstart support, which had accidently been reinstated in 1.4.14-2.
+  * Bumped standards version to 4.1.3, no changes required.
+  * Fix global-files-wildcard-not-first-paragraph-in-dep5-copyright.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 28 Feb 2018 11:29:47 +0000
+
+mosquitto (1.4.14-2) unstable; urgency=low
+
+  * Fix lintian error "build-depends-on-obsolete-package"
+  * Fix lintian warning "extended-description-line-too-long"
+  * The 1.4.14 release relaxes the restrictions on client ids, which means
+    that the mosquitto_pub/sub autogenerated ids are no longer a problem.
+    (closes: #870165).
+
+ -- Roger A. Light <roger@atchoo.org>  Tue, 26 Dec 2017 22:03:57 +0000
+
+mosquitto (1.4.14-1) unstable; urgency=medium
+
+  * SECURITY UPDATE: Persistence file is world readable, which may expose
+    sensitive data. Fixed by upstream release 1.4.13.
+    - CVE-2017-9868
+  * New upstream release.
+  * Remove upstart support.
+  * Bumped standards version to 4.1.2.
+    - Removed invoke-rc.d conditionals.
+    - Changed "extra" priorities to "optional".
+  * Build-Depends: Add dh-systemd, bump libwebsockets to >=2.0.
+  * no-man-clean.patch - don't clean man pages from source directory.
+  * async_dns.patch - enable bridge async DNS lookups.
+
+ -- Roger A. Light <roger@atchoo.org>  Fri, 22 Dec 2017 07:14:19 +0000
+
+mosquitto (1.4.12-1) experimental; urgency=low
+
+  * New upstream release.
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 29 May 2017 14:56:32 +0100
+
+mosquitto (1.4.10-3) unstable; urgency=high
+
+  * SECURITY UPDATE: Pattern ACL can be bypassed by using a username/client id
+    set to '+' or '#'.
+    - debian/patches/mosquitto-0.15_cve-2017-7650.patch: Reject send/receive
+      of messages to/from clients with a '+', '#' or '/' in their
+      username/client id.
+    - CVE-2017-7650
+  * New patch debian/patches/allow_ipv6_bridges.patch allows bridges to make
+    IPv6 connections when using TLS (closes: #857759).
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 29 May 2017 13:43:29 +0100
+
+mosquitto (1.4.10-2) unstable; urgency=medium
+
+  * Bumped standards version to 3.9.8. No changes needed.
+  * Bumped dh compat level to 10.
+  * Vcs-* links updated.
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 03 Nov 2016 22:37:33 +0000
+
+mosquitto (1.4.10-1) unstable; urgency=low
+
+  * New upstream release.
+  * Add support for openssl 1.1.0 (closes: #828442)
+  * Fix FTBFS on Hurd (closes: #824571)
+
+ -- Roger A. Light <roger@atchoo.org>  Thu, 27 Oct 2016 14:01:40 +0100
+
+mosquitto (1.4.8-1) unstable; urgency=high
+
+  * New upstream release.
+  * apparmor is now "suggests" instead of "depends".
+
+ -- Roger A. Light <roger@atchoo.org>  Sun, 14 Feb 2016 15:06:55 +0000
+
+mosquitto (1.4.7-1) unstable; urgency=low
+
+  * New upstream release. Includes support for libwebsockets 1.6.
+  * Add dependency link between libmosquittopp-dev and libmosquitto-dev
+    (closes: #805506).
+  * Dropped misc:Pre-Depends line for libmosquitto1. See #783898.
+  * libc-ares2 Depends is handled by shlib:Depends for libmosquitto1.
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 21 Dec 2015 10:59:31 +0000
+
+mosquitto (1.4.4-1) unstable; urgency=low
+
+  * New upstream release.
+  * Fix Vcs link.
+  * Note that libs & clients also support MQTT v3.1.1.
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 21 Sep 2015 09:56:28 +0100
+
+mosquitto (1.4.3-1) unstable; urgency=low
+
+  * New upstream release.
+  * New binary package mosquitto-dev.
+  * python3-mosquitto and python-mosquitto packages removed because the python
+    module is no longer part of upstream.
+  * Remove unused patches (pynomake.patch and disable-bad-test.patch)
+  * Added dependency on libwebsockets3, uuid. Note that the source package
+    will build (and actually prefers) using libwebsockets4 when it becomes
+    available. This adds the patch enable-websockets.patch.
+  * Upstream license has changed from BSD-3 to EPL-1.0 or EDL-1.0.
+  * Fix log directory permissions.
+  * Port to multiarch (closes: #763385) - adds libdir.patch
+  * Symbols update
+  * Patch refresh
+  * Add build-timestamp.patch to create reproducable builds.
+  * Add support for apparmor.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 19 Aug 2015 10:31:10 +0100
+
+mosquitto (1.3.4-2) unstable; urgency=low
+
+  * Disable bad "fake ca" test.
+
+ -- Roger A. Light <roger@atchoo.org>  Sat, 16 Aug 2014 10:52:12 +0100
+
+mosquitto (1.3.4-1) unstable; urgency=medium
+
+  * New upstream release: http://mosquitto.org/2014/08/version-1-3-4-released/
+   (closes: #725014, #754787)
+  * Add dependency on libuuid, c-ares.
+  * Bumped standards version to 3.9.5. No changes needed.
+  * Example config files are now installed to
+    /usr/share/doc/mosquitto/examples/
+  * debian/copyright year updated.
+  * compiling.txt is no longer distributed.
+  * Updated debian/copyright with new dates.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 06 Aug 2014 00:43:39 +0100
+
+mosquitto (1.2.1-1) unstable; urgency=low
+
+  * New upstream release: http://mosquitto.org/2013/09/version-1-2-1-released/
+  * Add Replaces/Break for libmosquitto-dev and libmosquittopp-dev
+    (closes: #720637, #720638).
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 18 Sep 2013 21:36:01 +0100
+
+mosquitto (1.2-1) unstable; urgency=low
+
+  * New upstream release: http://mosquitto.org/2013/08/version-1-2-released/
+    (closes: #685119).
+  * Bumped standards release to 3.9.4. No changes needed.
+  * Added mosquitto-dbg package for binary debug information.
+  * Added python3-mosquitto binary package.
+  * Use dh_python2 (and dh_python3) instead of python-support.
+  * mosquitto now logs to /var/log/mosquitto/ using logrotate.
+  * mosquitto local config should now be placed in /etc/mosquitto/conf.d/
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 07 Aug 2013 23:26:19 +0100
+
+mosquitto (0.15-1) unstable; urgency=low
+
+  * New upstream release: http://mosquitto.org/2012/02/version-0-15-released/
+  * Updated debian/copyright to latest DEP-5.
+  * Removed now unnecessary man-hyphen-minus.patch.
+
+ -- Roger A. Light <roger@atchoo.org>  Sun, 05 Feb 2012 09:30:22 +0000
+
+mosquitto (0.12-1) unstable; urgency=low
+
+  * New upstream release: http://mosquitto.org/2011/07/version-0-12-released/
+
+ -- Roger A. Light <roger@atchoo.org>  Mon, 25 Jul 2011 22:24:52 +0100
+
+mosquitto (0.11.3-1) unstable; urgency=low
+
+  * New upstream release: http://mosquitto.org/2011/07/version-0-11-3-released/
+  * Fix init script start action to create pidfile so stop works correctly.
+    (thanks to Mark Hindess, closes: #632589)
+  * Fix section for client libraries in debian/control.
+  * Remove disable-cmake.patch, this is handled in debian/rules now.
+
+ -- Roger A. Light <roger@atchoo.org>  Wed, 6 July 2011 15:07:04 +0100
+
+mosquitto (0.10-1) unstable; urgency=low
+
+  * Initial release. (Closes: #605319)
+
+ -- Roger A. Light <roger@atchoo.org>  Sun, 1 May 2011 20:12:51 +0100

debian/control

@@ -0,0 +1,130 @@
+Source: mosquitto
+Section: net
+Priority: optional
+Maintainer: Roger A. Light <roger@atchoo.org>
+Build-Depends: debhelper-compat (= 12),
+               cmake,
+               libcjson-dev,
+               libdlt-dev,
+               libssl-dev (>=1.0.0),
+               libsystemd-dev,
+               libwebsockets-dev,
+               libwrap0-dev,
+               pkg-config,
+               uthash-dev (>=2.1.0),
+               xsltproc,
+               docbook-xsl
+Standards-Version: 4.5.0
+Homepage: https://mosquitto.org/
+Vcs-Git: https://github.com/eclipse/mosquitto
+Vcs-Browser: https://github.com/eclipse/mosquitto/tree/debian
+
+Package: mosquitto
+Architecture: any
+Multi-Arch: foreign
+Depends: adduser (>= 3.10),
+         libcjson1,
+         libmosquitto1 (= ${binary:Version}),
+         lsb-base (>=4.1+Debian3),
+         ${misc:Depends},
+         ${shlibs:Depends}
+Suggests: apparmor
+Description: MQTT version 5.0/3.1.1/3.1 compatible message broker
+ This is a message broker that supports version 3.1 and 3.1.1 of the MQTT
+ protocol.
+ .
+ MQTT provides a method of carrying out messaging using a publish/subscribe
+ model. It is lightweight, both in terms of bandwidth usage and ease of
+ implementation. This makes it particularly useful at the edge of the network
+ where a sensor or other simple device may be implemented using an arduino for
+ example.
+
+Package: mosquitto-dev
+Section: devel
+Architecture: all
+Multi-Arch: foreign
+Depends: mosquitto (<< ${source:Version}.1~),
+         mosquitto (>= ${source:Version}),
+         ${misc:Depends}
+Description: Development files for Mosquitto
+ Mosquitto is a message broker that supports the MQTT protocol.
+ .
+ This package contains the include files used if you wish to compile a package
+ which requires Mosquitto's source file headers.
+
+Package: libmosquitto1
+Section: libs
+Architecture: any
+Multi-Arch: same
+Depends: ${misc:Depends}, ${shlibs:Depends}
+Description: MQTT version 5.0/3.1.1/3.1 client library
+ This is a C library for implementing MQTT version 5.0/3.1.1/3.1 clients.
+ .
+ MQTT provides a method of carrying out messaging using a publish/subscribe
+ model. It is lightweight, both in terms of bandwidth usage and ease of
+ implementation. This makes it particularly useful at the edge of the network
+ where a sensor or other simple device may be implemented using an arduino for
+ example.
+
+Package: libmosquitto-dev
+Section: libdevel
+Architecture: any
+Multi-Arch: same
+Depends: libmosquitto1 (<< ${source:Version}.1~),
+         libmosquitto1 (>= ${source:Version}),
+         ${misc:Depends}
+Replaces: libmosquitto0-dev (<< 1.2-1~)
+Breaks: libmosquitto0-dev (<< 1.2-1~)
+Description: MQTT version 5.0/3.1.1/3.1 client library, development files
+ This is the header and man page for the libmosquitto1 C library, which is a
+ library for implementing MQTT version 5.0/3.1.1/3.1 clients. This package is
+ needed to do development with libmosquitto1.
+
+Package: libmosquittopp1
+Section: libs
+Architecture: any
+Multi-Arch: same
+Pre-Depends: ${misc:Pre-Depends}
+Depends: libmosquitto1 (= ${binary:Version}),
+         ${misc:Depends},
+         ${shlibs:Depends}
+Description: MQTT version 5.0/3.1.1/3.1 client C++ library
+ This is a C++ library for implementing MQTT version 5.0/3.1.1/3.1 clients.
+ .
+ MQTT provides a method of carrying out messaging using a publish/subscribe
+ model. It is lightweight, both in terms of bandwidth usage and ease of
+ implementation. This makes it particularly useful at the edge of the network
+ where a sensor or other simple device may be implemented using an arduino for
+ example.
+
+Package: libmosquittopp-dev
+Section: libdevel
+Architecture: any
+Multi-Arch: same
+Depends: libmosquittopp1 (<< ${source:Version}.1~),
+         libmosquittopp1 (>= ${source:Version}),
+         libmosquitto-dev,
+         ${misc:Depends}
+Replaces: libmosquittopp0-dev (<< 1.2-1~)
+Breaks: libmosquittopp0-dev (<< 1.2-1~)
+Description: MQTT version 3.1 client C++ library, development files
+ This is the header and man page for the libmosquittopp1 C++ library, which is
+ a library for implementing MQTT version 3.1 clients. This package is needed to
+ do development with libmosquittopp1.
+
+Package: mosquitto-clients
+Architecture: any
+Multi-Arch: foreign
+Depends: libmosquitto1 (= ${binary:Version}),
+         ${misc:Depends},
+         ${shlibs:Depends}
+Description: Mosquitto command line MQTT clients
+ This is two MQTT version 5.0/3.1.1/3.1 command line clients. mosquitto_pub can be
+ used to publish messages to a broker and mosquitto_sub can be used to
+ subscribe to a topic to receive messages.
+ .
+ MQTT provides a method of carrying out messaging using a publish/subscribe
+ model. It is lightweight, both in terms of bandwidth usage and ease of
+ implementation. This makes it particularly useful at the edge of the network
+ where a sensor or other simple device may be implemented using an arduino for
+ example.

debian/copyright

@@ -0,0 +1,341 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: mosquitto
+Upstream-Contact: Roger A. Light <roger@atchoo.org>
+Source: https://mosquitto.org/files/source/
+
+Files: *
+Copyright: 2009-2020 Roger A. Light <roger@atchoo.org>
+License: EPL-2.0 or EDL-1.0
+
+License: EDL-1.0
+ Eclipse Distribution License - v 1.0
+ .
+ Copyright (c) 2007, Eclipse Foundation, Inc. and its licensors.
+ .
+ All rights reserved.
+ .
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ .
+ Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+ .
+ Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+ .
+ Neither the name of the Eclipse Foundation, Inc. nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+License: EPL-2.0
+ Eclipse Public License - v 2.0
+ .
+     THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE
+     PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
+     OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+ .
+ 1. DEFINITIONS
+ .
+ "Contribution" means:
+ .
+   a) in the case of the initial Contributor, the initial content
+      Distributed under this Agreement, and
+ .
+   b) in the case of each subsequent Contributor:
+      i) changes to the Program, and
+      ii) additions to the Program;
+   where such changes and/or additions to the Program originate from
+   and are Distributed by that particular Contributor. A Contribution
+   "originates" from a Contributor if it was added to the Program by
+   such Contributor itself or anyone acting on such Contributor's behalf.
+   Contributions do not include changes or additions to the Program that
+   are not Modified Works.
+ .
+ "Contributor" means any person or entity that Distributes the Program.
+ .
+ "Licensed Patents" mean patent claims licensable by a Contributor which
+ are necessarily infringed by the use or sale of its Contribution alone
+ or when combined with the Program.
+ .
+ "Program" means the Contributions Distributed in accordance with this
+ Agreement.
+ .
+ "Recipient" means anyone who receives the Program under this Agreement
+ or any Secondary License (as applicable), including Contributors.
+ .
+ "Derivative Works" shall mean any work, whether in Source Code or other
+ form, that is based on (or derived from) the Program and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship.
+ .
+ "Modified Works" shall mean any work in Source Code or other form that
+ results from an addition to, deletion from, or modification of the
+ contents of the Program, including, for purposes of clarity any new file
+ in Source Code form that contains any contents of the Program. Modified
+ Works shall not include works that contain only declarations,
+ interfaces, types, classes, structures, or files of the Program solely
+ in each case in order to link to, bind by name, or subclass the Program
+ or Modified Works thereof.
+ .
+ "Distribute" means the acts of a) distributing or b) making available
+ in any manner that enables the transfer of a copy.
+ .
+ "Source Code" means the form of a Program preferred for making
+ modifications, including but not limited to software source code,
+ documentation source, and configuration files.
+ .
+ "Secondary License" means either the GNU General Public License,
+ Version 2.0, or any later versions of that license, including any
+ exceptions or additional permissions as identified by the initial
+ Contributor.
+ .
+ 2. GRANT OF RIGHTS
+ .
+   a) Subject to the terms of this Agreement, each Contributor hereby
+   grants Recipient a non-exclusive, worldwide, royalty-free copyright
+   license to reproduce, prepare Derivative Works of, publicly display,
+   publicly perform, Distribute and sublicense the Contribution of such
+   Contributor, if any, and such Derivative Works.
+ .
+   b) Subject to the terms of this Agreement, each Contributor hereby
+   grants Recipient a non-exclusive, worldwide, royalty-free patent
+   license under Licensed Patents to make, use, sell, offer to sell,
+   import and otherwise transfer the Contribution of such Contributor,
+   if any, in Source Code or other form. This patent license shall
+   apply to the combination of the Contribution and the Program if, at
+   the time the Contribution is added by the Contributor, such addition
+   of the Contribution causes such combination to be covered by the
+   Licensed Patents. The patent license shall not apply to any other
+   combinations which include the Contribution. No hardware per se is
+   licensed hereunder.
+ .
+   c) Recipient understands that although each Contributor grants the
+   licenses to its Contributions set forth herein, no assurances are
+   provided by any Contributor that the Program does not infringe the
+   patent or other intellectual property rights of any other entity.
+   Each Contributor disclaims any liability to Recipient for claims
+   brought by any other entity based on infringement of intellectual
+   property rights or otherwise. As a condition to exercising the
+   rights and licenses granted hereunder, each Recipient hereby
+   assumes sole responsibility to secure any other intellectual
+   property rights needed, if any. For example, if a third party
+   patent license is required to allow Recipient to Distribute the
+   Program, it is Recipient's responsibility to acquire that license
+   before distributing the Program.
+ .
+   d) Each Contributor represents that to its knowledge it has
+   sufficient copyright rights in its Contribution, if any, to grant
+   the copyright license set forth in this Agreement.
+ .
+   e) Notwithstanding the terms of any Secondary License, no
+   Contributor makes additional grants to any Recipient (other than
+   those set forth in this Agreement) as a result of such Recipient's
+   receipt of the Program under the terms of a Secondary License
+   (if permitted under the terms of Section 3).
+ .
+ 3. REQUIREMENTS
+ .
+ 3.1 If a Contributor Distributes the Program in any form, then:
+ .
+   a) the Program must also be made available as Source Code, in
+   accordance with section 3.2, and the Contributor must accompany
+   the Program with a statement that the Source Code for the Program
+   is available under this Agreement, and informs Recipients how to
+   obtain it in a reasonable manner on or through a medium customarily
+   used for software exchange; and
+ .
+   b) the Contributor may Distribute the Program under a license
+   different than this Agreement, provided that such license:
+      i) effectively disclaims on behalf of all other Contributors all
+      warranties and conditions, express and implied, including
+      warranties or conditions of title and non-infringement, and
+      implied warranties or conditions of merchantability and fitness
+      for a particular purpose;
+ .
+      ii) effectively excludes on behalf of all other Contributors all
+      liability for damages, including direct, indirect, special,
+      incidental and consequential damages, such as lost profits;
+ .
+      iii) does not attempt to limit or alter the recipients' rights
+      in the Source Code under section 3.2; and
+ .
+      iv) requires any subsequent distribution of the Program by any
+      party to be under a license that satisfies the requirements
+      of this section 3.
+ .
+ 3.2 When the Program is Distributed as Source Code:
+ .
+   a) it must be made available under this Agreement, or if the
+   Program (i) is combined with other material in a separate file or
+   files made available under a Secondary License, and (ii) the initial
+   Contributor attached to the Source Code the notice described in
+   Exhibit A of this Agreement, then the Program may be made available
+   under the terms of such Secondary Licenses, and
+ .
+   b) a copy of this Agreement must be included with each copy of
+   the Program.
+ .
+ 3.3 Contributors may not remove or alter any copyright, patent,
+ trademark, attribution notices, disclaimers of warranty, or limitations
+ of liability ("notices") contained within the Program from any copy of
+ the Program which they Distribute, provided that Contributors may add
+ their own appropriate notices.
+ .
+ 4. COMMERCIAL DISTRIBUTION
+ .
+ Commercial distributors of software may accept certain responsibilities
+ with respect to end users, business partners and the like. While this
+ license is intended to facilitate the commercial use of the Program,
+ the Contributor who includes the Program in a commercial product
+ offering should do so in a manner which does not create potential
+ liability for other Contributors. Therefore, if a Contributor includes
+ the Program in a commercial product offering, such Contributor
+ ("Commercial Contributor") hereby agrees to defend and indemnify every
+ other Contributor ("Indemnified Contributor") against any losses,
+ damages and costs (collectively "Losses") arising from claims, lawsuits
+ and other legal actions brought by a third party against the Indemnified
+ Contributor to the extent caused by the acts or omissions of such
+ Commercial Contributor in connection with its distribution of the Program
+ in a commercial product offering. The obligations in this section do not
+ apply to any claims or Losses relating to any actual or alleged
+ intellectual property infringement. In order to qualify, an Indemnified
+ Contributor must: a) promptly notify the Commercial Contributor in
+ writing of such claim, and b) allow the Commercial Contributor to control,
+ and cooperate with the Commercial Contributor in, the defense and any
+ related settlement negotiations. The Indemnified Contributor may
+ participate in any such claim at its own expense.
+ .
+ For example, a Contributor might include the Program in a commercial
+ product offering, Product X. That Contributor is then a Commercial
+ Contributor. If that Commercial Contributor then makes performance
+ claims, or offers warranties related to Product X, those performance
+ claims and warranties are such Commercial Contributor's responsibility
+ alone. Under this section, the Commercial Contributor would have to
+ defend claims against the other Contributors related to those performance
+ claims and warranties, and if a court requires any other Contributor to
+ pay any damages as a result, the Commercial Contributor must pay
+ those damages.
+ .
+ 5. NO WARRANTY
+ .
+ EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+ PERMITTED BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN "AS IS"
+ BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
+ IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF
+ TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
+ PURPOSE. Each Recipient is solely responsible for determining the
+ appropriateness of using and distributing the Program and assumes all
+ risks associated with its exercise of rights under this Agreement,
+ including but not limited to the risks and costs of program errors,
+ compliance with applicable laws, damage to or loss of data, programs
+ or equipment, and unavailability or interruption of operations.
+ .
+ 6. DISCLAIMER OF LIABILITY
+ .
+ EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT
+ PERMITTED BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS
+ SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
+ PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
+ EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
+ POSSIBILITY OF SUCH DAMAGES.
+ .
+ 7. GENERAL
+ .
+ If any provision of this Agreement is invalid or unenforceable under
+ applicable law, it shall not affect the validity or enforceability of
+ the remainder of the terms of this Agreement, and without further
+ action by the parties hereto, such provision shall be reformed to the
+ minimum extent necessary to make such provision valid and enforceable.
+ .
+ If Recipient institutes patent litigation against any entity
+ (including a cross-claim or counterclaim in a lawsuit) alleging that the
+ Program itself (excluding combinations of the Program with other software
+ or hardware) infringes such Recipient's patent(s), then such Recipient's
+ rights granted under Section 2(b) shall terminate as of the date such
+ litigation is filed.
+ .
+ All Recipient's rights under this Agreement shall terminate if it
+ fails to comply with any of the material terms or conditions of this
+ Agreement and does not cure such failure in a reasonable period of
+ time after becoming aware of such noncompliance. If all Recipient's
+ rights under this Agreement terminate, Recipient agrees to cease use
+ and distribution of the Program as soon as reasonably practicable.
+ However, Recipient's obligations under this Agreement and any licenses
+ granted by Recipient relating to the Program shall continue and survive.
+ .
+ Everyone is permitted to copy and distribute copies of this Agreement,
+ but in order to avoid inconsistency the Agreement is copyrighted and
+ may only be modified in the following manner. The Agreement Steward
+ reserves the right to publish new versions (including revisions) of
+ this Agreement from time to time. No one other than the Agreement
+ Steward has the right to modify this Agreement. The Eclipse Foundation
+ is the initial Agreement Steward. The Eclipse Foundation may assign the
+ responsibility to serve as the Agreement Steward to a suitable separate
+ entity. Each new version of the Agreement will be given a distinguishing
+ version number. The Program (including Contributions) may always be
+ Distributed subject to the version of the Agreement under which it was
+ received. In addition, after a new version of the Agreement is published,
+ Contributor may elect to Distribute the Program (including its
+ Contributions) under the new version.
+ .
+ Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
+ receives no rights or licenses to the intellectual property of any
+ Contributor under this Agreement, whether expressly, by implication,
+ estoppel or otherwise. All rights in the Program not expressly granted
+ under this Agreement are reserved. Nothing in this Agreement is intended
+ to be enforceable by any entity that is not a Contributor or Recipient.
+ No third-party beneficiary rights are created under this Agreement.
+ .
+ Exhibit A - Form of Secondary Licenses Notice
+ .
+ "This Source Code may also be made available under the following 
+ Secondary Licenses when the conditions for such availability set forth 
+ in the Eclipse Public License, v. 2.0 are satisfied: {name license(s),
+ version(s), and exceptions or additional permissions here}."
+ .
+   Simply including a copy of this Agreement, including this Exhibit A
+   is not sufficient to license the Source Code under Secondary Licenses.
+ .
+   If it is not possible or desirable to put the notice in a particular
+   file, then You may include the notice in a location (such as a LICENSE
+   file in a relevant directory) where a recipient would be likely to
+   look for such a notice.
+ .
+   You may add additional accurate notices of copyright ownership.
+
+Files: src/deps/uthash.h
+Copyright: 2003-2013, Troy D. Hanson     http://uthash.sourceforge.net
+License: BSD-1-clause
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ .
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+ .
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+ IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+ PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+ OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

debian/libmosquitto-dev.install

@@ -0,0 +1,4 @@
+usr/include/mosquitto.h
+usr/include/mqtt_protocol.h
+usr/lib/*/libmosquitto.so
+usr/lib/*/pkgconfig/libmosquitto.pc

debian/libmosquitto-dev.lintian-overrides

@@ -0,0 +1,3 @@
+# xsltproc generated man pages have long lines but look ok.  Patching the
+# generated files to use hypenation results in very odd looking files.
+libmosquitto-dev binary: manpage-has-errors-from-man

debian/libmosquitto-dev.manpages

@@ -0,0 +1 @@
+usr/share/man/man3/libmosquitto.3

debian/libmosquitto1.install

@@ -0,0 +1 @@
+usr/lib/*/libmosquitto.so.*

debian/libmosquitto1.symbols

@@ -0,0 +1,11 @@
+libmosquitto.so.1 libmosquitto1 #MINVER#
+ (symver)MOSQ_1.0 1.0
+ (symver)MOSQ_1.1 1.1
+ (symver)MOSQ_1.2 1.2
+ (symver)MOSQ_1.3 1.3
+ (symver)MOSQ_1.4 1.4
+ (symver)MOSQ_1.5 1.5
+ (symver)MOSQ_1.6 1.6
+ (symver)MOSQ_1.6 1.6
+ (symver)MOSQ_1.6 1.6
+ (symver)MOSQ_1.7 2.0

debian/libmosquittopp-dev.install

@@ -0,0 +1,3 @@
+usr/include/mosquittopp.h
+usr/lib/*/libmosquittopp.so
+usr/lib/*/pkgconfig/libmosquittopp.pc

debian/libmosquittopp1.install

@@ -0,0 +1 @@
+usr/lib/*/libmosquittopp.so.*

debian/libmosquittopp1.symbols

@@ -0,0 +1,63 @@
+libmosquittopp.so.1 libmosquittopp1 #MINVER#
+ (c++)"mosqpp::subscribe_simple(mosquitto_message**, int, bool, char const*, int, char const*, int, char const*, int, bool, char const*, char const*, libmosquitto_will const*, libmosquitto_tls const*)@Base" 1.5
+ (c++)"mosqpp::subscribe_callback(int (*)(mosquitto*, void*, mosquitto_message const*), void*, char const*, int, char const*, int, char const*, int, bool, char const*, char const*, libmosquitto_will const*, libmosquitto_tls const*)@Base" 1.5
+ (c++)"mosqpp::lib_cleanup()@Base" 1.0
+ (c++)"mosqpp::lib_version(int*, int*, int*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::disconnect()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_start()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_write(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_connect(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_connect_with_flags(int, int)@Base" 1.5
+ (c++)"mosqpp::mosquittopp::on_message(mosquitto_message const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_publish(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::socks5_set(char const*, int, char const*, char const*)@Base" 1.4
+ (c++)"mosqpp::mosquittopp::want_write()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::will_clear()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::tls_psk_set(char const*, char const*, char const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::unsubscribe(int*, char const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_forever(int, int)@Base" 1.1
+ (c++)"mosqpp::mosquittopp::on_subscribe(int, int, int const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::reinitialise(char const*, bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::threaded_set(bool)@Base" 1.4
+ (c++)"mosqpp::mosquittopp::tls_opts_set(int, char const*, char const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::connect_async(char const*, int, int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::connect_async(char const*, int, int, char const*)@Base" 1.2
+ (c++)"mosqpp::mosquittopp::on_disconnect(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::user_data_set(void*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_unsubscribe(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::reconnect_async()@Base" 1.2
+ (c++)"mosqpp::mosquittopp::username_pw_set(char const*, char const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::tls_insecure_set(bool)@Base" 1.2
+ (c++)"mosqpp::mosquittopp::message_retry_set(unsigned int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::reconnect_delay_set(unsigned int, unsigned int, bool)@Base" 1.2
+ (c++)"mosqpp::mosquittopp::max_inflight_messages_set(unsigned int)@Base" 1.2
+ (c++)"mosqpp::mosquittopp::loop(int, int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_log(int, char const*)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::socket()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::connect(char const*, int, int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::connect(char const*, int, int, char const*)@Base" 1.2
+ (c++)"mosqpp::mosquittopp::publish(int*, char const*, int, void const*, int, bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::tls_set(char const*, char const*, char const*, char const*, int (*)(char*, int, int, void*))@Base" 1.0
+ (c++)"mosqpp::mosquittopp::on_error()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::opts_set(mosq_opt_t, void*)@Base" 1.4
+ (c++)"mosqpp::mosquittopp::will_set(char const*, int, void const*, int, bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_misc()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_read(int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::loop_stop(bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::reconnect()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::subscribe(int*, char const*, int)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::mosquittopp(char const*, bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::mosquittopp(char const*, bool)@Base" 1.0
+ (c++)"mosqpp::mosquittopp::~mosquittopp()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::~mosquittopp()@Base" 1.0
+ (c++)"mosqpp::mosquittopp::~mosquittopp()@Base" 1.0
+ (c++)"mosqpp::connack_string(int)@Base" 1.0
+ (c++)"mosqpp::topic_matches_sub(char const*, char const*, bool*)@Base" 1.0
+ (c++)"mosqpp::sub_topic_tokenise(char const*, char***, int*)@Base" 1.0
+ (c++)"mosqpp::sub_topic_tokens_free(char***, int)@Base" 1.0
+ (c++)"mosqpp::lib_init()@Base" 1.0
+ (c++)"mosqpp::validate_utf8(char const*, int)@Base" 1.5
+ (c++)"mosqpp::strerror(int)@Base" 1.0
+ (c++)"typeinfo for mosqpp::mosquittopp@Base" 1.0
+ (c++)"typeinfo name for mosqpp::mosquittopp@Base" 1.0
+ (c++)"vtable for mosqpp::mosquittopp@Base" 1.0

debian/mosquitto-clients.install

@@ -0,0 +1,3 @@
+usr/bin/mosquitto_pub
+usr/bin/mosquitto_sub
+usr/bin/mosquitto_rr

debian/mosquitto-clients.lintian-overrides

@@ -0,0 +1,3 @@
+# xsltproc generated man pages have long lines but look ok.  Patching the
+# generated files to use hypenation results in very odd looking files.
+mosquitto-clients binary: manpage-has-errors-from-man

debian/mosquitto-clients.manpages

@@ -0,0 +1,3 @@
+usr/share/man/man1/mosquitto_pub.1
+usr/share/man/man1/mosquitto_sub.1
+usr/share/man/man1/mosquitto_rr.1

debian/mosquitto-dev.install

@@ -0,0 +1,2 @@
+usr/include/mosquitto_plugin.h
+usr/include/mosquitto_broker.h

debian/mosquitto.conf

@@ -0,0 +1,13 @@
+# Place your local configuration in /etc/mosquitto/conf.d/
+#
+# A full description of the configuration file is at
+# /usr/share/doc/mosquitto/examples/mosquitto.conf.example
+
+pid_file /run/mosquitto/mosquitto.pid
+
+persistence true
+persistence_location /var/lib/mosquitto/
+
+log_dest file /var/log/mosquitto/mosquitto.log
+
+include_dir /etc/mosquitto/conf.d

debian/mosquitto.dirs

@@ -0,0 +1,2 @@
+var/lib/mosquitto
+var/log/mosquitto

debian/mosquitto.docs

@@ -0,0 +1,2 @@
+README.md
+README-letsencrypt.md

debian/mosquitto.examples

@@ -0,0 +1,4 @@
+mosquitto.conf
+aclfile.example
+pwfile.example
+pskfile.example

debian/mosquitto.init

@@ -0,0 +1,140 @@
+#! /bin/sh
+
+### BEGIN INIT INFO
+# Provides:		mosquitto
+# Required-Start:	$remote_fs $syslog
+# Required-Stop:	$remote_fs $syslog
+# Default-Start:	2 3 4 5
+# Default-Stop:		0 1 6
+# Short-Description:	mosquitto MQTT v3.1 message broker
+# Description: 
+#  This is a message broker that supports version 3.1 of the MQ Telemetry
+#  Transport (MQTT) protocol.
+#  
+#  MQTT provides a method of carrying out messaging using a publish/subscribe
+#  model. It is lightweight, both in terms of bandwidth usage and ease of
+#  implementation. This makes it particularly useful at the edge of the network
+#  where a sensor or other simple device may be implemented using an arduino for
+#  example.
+### END INIT INFO
+
+set -e
+
+PIDFILE=/run/mosquitto/mosquitto.pid
+DAEMON=/usr/sbin/mosquitto
+
+# /etc/init.d/mosquitto: start and stop the mosquitto MQTT message broker
+
+test -x ${DAEMON} || exit 0
+
+umask 022
+
+. /lib/lsb/init-functions
+
+# Are we running from init?
+run_by_init() {
+    ([ "$previous" ] && [ "$runlevel" ]) || [ "$runlevel" = S ]
+}
+
+export PATH="${PATH:+$PATH:}/usr/sbin:/sbin"
+
+case "$1" in
+  start)
+	if init_is_upstart; then
+	    exit 1
+	fi
+	log_daemon_msg "Starting network daemon:" "mosquitto"
+	mkdir -m 740 -p /run/mosquitto
+	chown mosquitto: /run/mosquitto
+	if start-stop-daemon --start --quiet --oknodo --background  --make-pidfile --pidfile ${PIDFILE} --exec ${DAEMON} -- -c /etc/mosquitto/mosquitto.conf ; then
+	    log_end_msg 0
+	else
+	    log_end_msg 1
+	fi
+	;;
+  stop)
+	if init_is_upstart; then
+	    exit 0
+	fi
+	log_daemon_msg "Stopping network daemon:" "mosquitto"
+	if start-stop-daemon --stop --quiet --oknodo --pidfile ${PIDFILE}; then
+	    log_end_msg 0
+	    rm -f ${PIDFILE}
+	else
+	    log_end_msg 1
+	fi
+	;;
+
+
+  reload|force-reload)
+	if init_is_upstart; then
+	    exit 1
+	fi
+	log_daemon_msg "Reloading network daemon configuration:" "mosquitto"
+        if start-stop-daemon --stop --signal HUP --quiet --oknodo --pidfile $PIDFILE; then
+            log_end_msg 0
+        else
+            log_end_msg 1
+        fi	
+	;;
+
+  restart)
+	if init_is_upstart; then
+	    exit 1
+	fi
+	log_daemon_msg "Restarting network daemon:" "mosquitto"
+	if start-stop-daemon --stop --quiet --oknodo --retry 30 --pidfile ${PIDFILE}; then
+	    rm -f ${PIDFILE}
+	fi
+	if start-stop-daemon --start --quiet --oknodo --background --make-pidfile --pidfile ${PIDFILE} --exec ${DAEMON} -- -c /etc/mosquitto/mosquitto.conf ; then
+	    log_end_msg 0
+	else
+	    log_end_msg 1
+	fi
+	;;
+
+  try-restart)
+	if init_is_upstart; then
+	    exit 1
+	fi
+	log_daemon_msg "Restarting Mosquitto message broker" "mosquitto"
+	set +e
+	start-stop-daemon --stop --quiet --retry 30 --pidfile ${PIDFILE}
+	RET="$?"
+	set -e
+	case $RET in
+	    0)
+		# old daemon stopped
+		rm -f ${PIDFILE}
+		if start-stop-daemon --start --quiet --oknodo --background --make-pidfile --pidfile ${PIDFILE} --exec ${DAEMON} -- -c /etc/mosquitto/mosquitto.conf ; then
+		    log_end_msg 0
+		else
+		    log_end_msg 1
+		fi
+		;;
+	    1)
+		# daemon not running
+		log_progress_msg "(not running)"
+		log_end_msg 0
+		;;
+	    *)
+		# failed to stop
+		log_progress_msg "(failed to stop)"
+		log_end_msg 1
+		;;
+	esac
+	;;
+
+  status)
+	if init_is_upstart; then
+	    exit 1
+	fi
+	status_of_proc -p ${PIDFILE} ${DAEMON} mosquitto && exit 0 || exit $?
+	;;
+
+  *)
+	log_action_msg "Usage: /etc/init.d/mosquitto {start|stop|reload|force-reload|restart|try-restart|status}"
+	exit 1
+esac
+
+exit 0

debian/mosquitto.install

@@ -0,0 +1,10 @@
+etc/mosquitto/ca_certificates/README
+etc/mosquitto/certs/README
+etc/mosquitto/conf.d/README
+etc/mosquitto/mosquitto.conf
+etc/mosquitto/*.example
+lib/systemd/system/mosquitto.service
+usr/bin/mosquitto_passwd
+usr/bin/mosquitto_ctrl
+usr/lib/*/mosquitto_dynamic_security.so*
+usr/sbin/mosquitto

debian/mosquitto.logrotate

@@ -0,0 +1,14 @@
+/var/log/mosquitto/mosquitto.log {
+	rotate 7
+	daily
+	compress
+	size 100k
+	nocreate
+	missingok
+	postrotate
+		if invoke-rc.d mosquitto status > /dev/null 2>&1; then \
+			invoke-rc.d mosquitto reload > /dev/null 2>&1; \
+		fi;
+	endscript
+}
+

debian/mosquitto.manpages

@@ -0,0 +1,7 @@
+usr/share/man/man1/mosquitto_ctrl.1
+usr/share/man/man1/mosquitto_ctrl_dynsec.1
+usr/share/man/man1/mosquitto_passwd.1
+usr/share/man/man5/mosquitto.conf.5
+usr/share/man/man7/mosquitto-tls.7
+usr/share/man/man7/mqtt.7
+usr/share/man/man8/mosquitto.8

debian/mosquitto.postinst

@@ -0,0 +1,47 @@
+#!/bin/sh
+# postinst script for mosquitto
+#
+# see: dh_installdeb(1)
+
+set -e
+
+setup_mosquitto_user() {
+	if ! getent group mosquitto >/dev/null; then
+		addgroup --quiet --system mosquitto
+	fi
+
+	if ! getent passwd mosquitto >/dev/null; then
+		adduser --quiet --system --no-create-home --ingroup mosquitto --home /var/lib/mosquitto --shell /usr/sbin/nologin mosquitto
+	fi
+}
+
+fix_permissions() {
+	chown mosquitto /var/lib/mosquitto
+	test ! -e /var/log/mosquitto || chown mosquitto /var/log/mosquitto
+	test ! -e /var/log/mosquitto/mosquitto.log || chown mosquitto /var/log/mosquitto/mosquitto.log
+}
+
+case "$1" in
+	configure)
+		setup_mosquitto_user
+		fix_permissions
+	;;
+
+	abort-upgrade|abort-remove|abort-deconfigure)
+	;;
+
+	*)
+		echo "postinst called with unknown argument \`$1'" >&2
+		exit 1
+	;;
+esac
+
+# Reload AppArmor profile
+APP_PROFILE="/etc/apparmor.d/usr.sbin.mosquitto"
+if [ -f "$APP_PROFILE" ] && aa-status --enabled 2>/dev/null; then
+       apparmor_parser -r "$APP_PROFILE" || true
+fi
+
+#DEBHELPER#
+
+exit 0

debian/mosquitto.postrm

@@ -0,0 +1,40 @@
+#!/bin/sh
+# postrm script for mosquitto
+#
+# see: dh_installdeb(1)
+
+set -e
+
+case "$1" in
+	purge)
+		rm -f /var/lib/mosquitto/mosquitto.db
+		if [ -d /var/lib/mosquitto ]; then
+			rmdir --ignore-fail-on-non-empty /var/lib/mosquitto
+		fi
+		rm -f /var/log/mosquitto/mosquitto.log*
+		if [ -d /var/log/mosquitto ]; then
+			rmdir --ignore-fail-on-non-empty /var/log/mosquitto
+		fi
+		rm -f /run/mosquitto/mosquitto.pid
+		if [ -d /run/mosquitto ]; then
+			rmdir --ignore-fail-on-non-empty /run/mosquitto
+		fi
+        APP_PROFILE="usr.sbin.mosquitto"
+        rm -f /etc/apparmor.d/disable/$APP_PROFILE >/dev/null 2>&1 || true
+	;;
+	remove|abort-install|abort-upgrade|disappear)
+	;;
+
+	upgrade|failed-upgrade)
+	;;
+
+	*)
+		echo "postrm called with unknown argument \`$1'" >&2
+		exit 1
+	;;
+esac
+
+
+#DEBHELPER#
+
+exit 0

debian/patches/1571.patch

@@ -0,0 +1,22 @@
+Upstream-Status: Submitted [https://github.com/eclipse/mosquitto/pull/1571]
+From 3fe5468f1bdca1bff1d18cf43c9e338f41aa9e32 Mon Sep 17 00:00:00 2001
+From: Gianfranco Costamagna <costamagnagianfranco@yahoo.it>
+Date: Wed, 22 Jan 2020 12:39:49 +0100
+Subject: [PATCH] Add dynamic symbols linking with cmake too
+
+Signed-off-by: Gianfranco Costamagna <costamagnagianfranco@yahoo.it>
+---
+ lib/CMakeLists.txt | 2 ++
+ 1 file changed, 2 insertions(+)
+
+--- a/lib/CMakeLists.txt
++++ b/lib/CMakeLists.txt
+@@ -94,6 +94,8 @@
+ 	OUTPUT_NAME mosquitto
+ 	VERSION ${VERSION}
+ 	SOVERSION 1
++	LINK_DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/linker.version
++	LINK_FLAGS "-Wl,--version-script=${CMAKE_CURRENT_SOURCE_DIR}/linker.version"
+ )
+ 
+ install(TARGETS libmosquitto RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}" LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}")

debian/patches/series

@@ -0,0 +1 @@
+1571.patch

debian/rules

@@ -0,0 +1,37 @@
+#!/usr/bin/make -f
+
+%:
+	dh $@ --buildsystem=cmake
+
+override_dh_installchangelogs:
+	dh_installchangelogs ChangeLog.txt
+
+ifeq ($(DEB_BUILD_ARCH_OS), linux)
+SYSTEMD=ON
+else
+SYSTEMD=OFF
+endif
+
+override_dh_auto_configure:
+	dh_auto_configure -- -DWITH_BUNDLED_DEPS=OFF -DWITH_ADNS=ON -DUSE_LIBWRAP=ON -DWITH_WEBSOCKETS=ON -DWITH_DLT=ON -DWITH_SYSTEMD=${SYSTEMD}
+
+override_dh_strip:
+	dh_strip -p mosquitto --dbgsym-migration='mosquitto-dbg (<< 1.5)' -Xlibmosquitto
+	dh_strip -p libmosquitto1 --dbgsym-migration='libmosquitto1-dbg (<< 1.5)' -Xlibmosquittopp -Xsbin/mosquitto
+	dh_strip -p libmosquittopp1 --dbgsym-migration='libmosquittopp1-dbg (<< 1.5)' -Xlibmosquitto.so -Xsbin/mosquitto
+	dh_strip --remaining-packages
+
+override_dh_auto_install:
+	dh_auto_install
+	install -d debian/tmp/etc/mosquitto/conf.d/
+	install -m 644 debian/README-conf-d debian/tmp/etc/mosquitto/conf.d/README
+	install -d debian/tmp/etc/mosquitto/ca_certificates/
+	install -m 644 debian/README-ca_certificates debian/tmp/etc/mosquitto/ca_certificates/README
+	install -d debian/tmp/etc/mosquitto/certs/
+	install -m 644 debian/README-certs debian/tmp/etc/mosquitto/certs/README
+	install -m 644 debian/mosquitto.conf debian/tmp/etc/mosquitto/mosquitto.conf
+	install -d debian/tmp/lib/systemd/system/
+	install -m 644 ./service/systemd/mosquitto.service.notify debian/tmp/lib/systemd/system/mosquitto.service
+
+override_dh_makeshlibs:
+	dh_makeshlibs -- -c4

debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

debian/upstream/metadata

@@ -0,0 +1,16 @@
+Name: mosquitto
+Bug-Database: https://github.com/eclipse/mosquitto/issues
+Bug-Submit: https://github.com/eclipse/mosquitto/issues/new
+Changelog: https://mosquitto.org/ChangeLog.txt
+Contact: https://dev.eclipse.org/mailman/listinfo/mosquitto-dev
+Repository: https://github.com/eclipse/mosquitto
+Security-Contact: https://www.eclipse.org/security/
+Reference:
+  Author: Roger A. Light
+  Title: "Mosquitto: server and client implementation of the MQTT protocol"
+  Journal: The Journal of Open Source Software
+  Year: 2017
+  Volume: 2
+  Number: 13
+  DOI: http://dx.doi.org/10.21105/joss.00265
+  eprint: http://joss.theoj.org/papers/ebbbbf7c7a2f7e98e32ae41ee88a3bca

debian/upstream/signing-key.asc

@@ -0,0 +1,58 @@
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+Version: GnuPG v1
+
+mQINBEoEgPwBEADeSeoLB59SoxrakvdK1WjGQZAbNXUgWhr9k0b08lpjwHhDFxZz
+GalY/9IZ5C9WDzw8+DDvm7gD4vy1O5Q3peZ8qtQ1cD1H8MaM0Vzzz8fnXqWV2oww
+sH7VH+ISKUZODCD76EG8JgUpWRO+TgfMylKWkuJC8BudSYUB5sdTyrcJ3n1PbbtJ
+kZomIICIaoPR3VR5ySML4qe1as7PypxF3BnzgcmSKhByLNQcKyy35Lx86JnZvTm8
+FUcCsp+FgSMCubrvF4nhyJppUAbGoohyiULmfJAVHI01XQcqmQKim02nN88HQgKU
+6FDbvgPMvCSDH9wCAHghPrccYGfAhaWC9/lkVAXo5NnJC7JdXi/l/VlXhZUwsAqc
+pQFj7nJHliZLalrNe9MDdnRnBw5jGx+iRQ6n5a/uNH/ykPbgQKMzWF0O3tAGmqEl
+zfLd46bFr09QNzs2HfBNygUhyKYO8VSLfl+WEsLT1pcpmWQuGNUsrrF1hT/UtAr0
+WTQw2pc2BQV1R/d7lGhAfB3VxtHjI2XIRHEPVJ2+r5bkc4GxVVw6l81AOhzUsoS9
+Bv+3SnRc5c7guR4ck/CgElXCw/xy9BcqyXN0fQtiMRmL33zo2ZE4ZNJeFsmFERUz
+E+fHNfJrBHnVVboE6p/TX8dzIEKbYYGllInQVSQcoAv+Qm2/a19WidUQ8QARAQAB
+tCFSb2dlciBBLiBMaWdodCA8cm9nZXJAYXRjaG9vLm9yZz6JAjoEEwEIACQCGwMC
+HgECF4AFCwkIBwMFFQoJCAsFFgIDAQAFAkoEomgCGQEACgkQd5si37PnF7egPw//
+REmew0Fb45wCVFBJyLHL+0qKQX/B9okac9fud3rYtLTPmeB04OL+tMb3/tOTJbyC
+F2rDLvjE1IrqMwedDAY/bMKSPJ1RQ5NRa0WjXGLxkVBOqJuE8E6qGOLrL6/DSu7v
+zoq8xzcKxbWDRgizSTuKQ9QHEGqPE8RDOyYnkbyGHwshtOhGbhpBeX55gxnIfOPi
+To04f+iF61MbomkXxdlylMnEjEqGuF09jKb4o2U2zhC/pe73ANGIApf9ZRHmUbt8
+jduYgaffsj64FCw+qjTnf68ch+QjgDHFeCyO4BxeVOgYCDiafp7/CSk81K1DN+SF
+n9Kjbcee4QGdIv2HmGTB576XBBbJ6bOgxYyuX1nw4m5a7cXKf0dpCimKQG/aUq2h
+eGdD2KKs30bqPeaZRucFAZnrLxgfAvaj2eTEynJnSYoVB2ZNYs7qCe+oMtp8kkSl
+za091I9rrBVFAEDGrRstJOOEtHJ8Qh4NT+yW/yKmpm7DyWYOJlR5ah+9G8njjlM8
+sFHwWNdbbWgO6zPNC/VktiLc0aCeu101M3ay1+RexT2bq1pFBKU/4DGRdE4vVERY
+gHejkDVP4xml8j1JA6Azk4ik4/mQ+tDyxQsJJz0edIlTVwH8X4dwLp91wJajpFQQ
+VQN/tMkyGHnrrrcfsri44URvDwdlvOtsAxPeipniavuIRgQTEQgABgUCSgTUVQAK
+CRC88Em0D7n+z8RfAJ9Ie7JMWStpeYck6Ay8IbQHyJLJCwCdEzfdkmpK4a1sIk32
+fc/5ss3NtjuJAhwEEAECAAYFAkvd9U0ACgkQddvLEIxoAM4PVA/9FIyp7o/goX6G
+If49jBrnUFZacWssL7Cs798PBy68hGbP10wZiKH5yc6ofuZOdEHzWVKvKuMja/Jo
+6eQJtmXwmXAwV0grQ0e/LmadpswuojUA8tawch5xe/0f47FAmoGmNrL/yi8bpv2t
+BV/DFKWSg1BAbHM3BoH0qLSwvdL0zOPCWWvX1pkANbWUueREjzc/xNnkwEUFsO2+
+ol19YQmZe7rKpo5pa53DhPqvWuol2z5TXc8YbDNOP4T2rqpdwZjbYpHduttNIzK4
+h8HsAp4QF3u2e2sbro3Uhx0uRp2d/7y3x6hflHK2U6t1yGA5uC5yYT1KaXkFZQTt
+h2kPoEk9Bb1MImnPiqmQeW6g8r/msMq+d/DcOO0KjTkuqhsIN0Xx6W75toXhEjpl
+j2pes8+6lSQnTznd9Kj5GeziWUdYhYmrpS/OJIDl0pKzJM0N6PnhBILMl8vbrpX8
+Zsbn/ipk8xIb1ck8X1hjg92RJPwPOy204yzpgK1xXXch8wKPwTSn8QleEndwrGxp
+BEbTrVaquYNy+lWuXs0RENJEy6EWnebhF3ycGV2vvXLOOlAVE3upgLvNugKhT9qG
+Pxqr/r+FmCfSx05LpX3bUvz0OLmS6JhU/pnZGYrEa8pWY78Mbb3BMpIcwgYzPr+S
+zbLaOpOy4PyGUOAIM+oEcKrSr458/nqJAhwEEAEIAAYFAkvfG7QACgkQYum3VLFy
+NpIY5xAAlNai3YFtzxU7WjdITuVFrOSH2xJlWAzdbZ+7ijSuPzeBmHI+fYFxfkv2
+76sh+A4K9QV1tdJn9cZAiH4cSuRdnCGdWFnPh+bAgsEjuLyt8U/OzvSOmbMT9g10
+iYiuR+qZNEde/NHUOTUWvgQcwATb8sREx4bxgdrtB503DVs5WeOg8MpVJwp66xHt
+zxCRWj/6urvnqkmicIDeR2nMc/D9yJWP90wxBeZoJGqiqcCeCWknQeBj7Qijr0Jt
+Ys/If1g9fwj4vSXBctZb49xT/Kj/hwBnSWro8dQVz0iU1vxfGhxkRTQwXWfqiA6X
+FJPYKLdvN4wU/3xP3jEy7rLyyQaIOcx9K7F/UUn/C7TOOq47PEXeLGPp4DR12pPC
+urmWqcZQlB+GpVKP1W6c+1WGUmhRvOKx5KJBj8IdFcOG0Y0OK4+2xaEq4aZOPg+t
+djoULu38AW2yzHW6vzE9toZXMRXtoPmbs5i+MCvOGp1HJkSnkVIdFS1Wnp1boQ3Z
+C+eCF2tScI8Ulbj99LlodipomHeIxvo3DJcra9zV1KGGWCwU9hkLWugrcyWJPX1m
+asdx2S7Y6dIurDV+M8PcNOY7nYbST2qwnnS7dGeQbV17RzNeeppfSwYCfwY9qmLZ
+thkC1keFi/AoRIpIwGiQ/7RA9/4wdKIBMaTKuqlgNUgc9+QcXvyIRgQQEQIABgUC
+S96lpwAKCRBhGkhEuMJTwdVYAJoD4voyORSCjlz32RPCMiE7ru4iJACeJweng6lC
+jBrgT93OSCI/59FLKyKIRgQQEQIABgUCS+dHZwAKCRC6bhqXQ3UZAxAIAJ0VvKnK
+qeGmZpNdJwK/6Kdzfd0K6wCgrX0vJPcp7ZFLQpHeCB0yt+O7zr6IRgQQEQIABgUC
+S/ZX+gAKCRAgmbZMvxVJCw4NAJ4z1YF3InURoqE/ZBHWCPvICqtWewCg30QxvdLz
+0nYf/elPCss1nZIWOa8=
+=S/ue
+-----END PGP PUBLIC KEY BLOCK-----

debian/watch

@@ -0,0 +1,3 @@
+version=4
+opts="pgpsigurlmangle=s/$/.asc/" \
+ https://mosquitto.org/files/source/mosquitto-(.*)\.tar\.gz

man/libmosquitto.3.xml

@@ -15,8 +15,488 @@
 	</refnamediv>
 
 	<refsect1>
-		<title>Documentation</title>
-		<para>See <ulink url="https://mosquitto.org/api/"/></para>
+		<title>Description</title>
+		<para>This is an overview of how to use libmosquitto to create MQTT
+		aware client programs. There may be separate man pages on each of the
+		functions described here in the future.</para>
+		<para>This man page is woefully incomplete, please see the comments
+		in mosquitto.h for missing functions and a description of the
+		functions.</para>
+	</refsect1>
+
+	<refsect1>
+		<title>libmosquitto symbol names</title>
+		<para>All public functions in libmosquitto have the prefix
+		"mosquitto_". Any other functions defined in the source code are to be
+		treated as private functions and may change between any release. Do not
+		use these functions!</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Functions</title>
+
+		<refsect2>
+			<title>Library version</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_lib_version</function></funcdef>
+					<paramdef>int *<parameter>major</parameter></paramdef>
+					<paramdef>int *<parameter>minor</parameter></paramdef>
+					<paramdef>int *<parameter>revision</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+			<para>Obtain version information about the library. If any of
+			major, minor or revision are not NULL they will return the
+			corresponding version numbers. The return value is an integer
+			representation of the complete version number (e.g. 1009001 for 1.9.1)
+			that can be used for comparisons.</para>
+		</refsect2>
+
+		<refsect2>
+			<title>Library initialisation and cleanup</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_lib_init</function></funcdef>
+			<void/></funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_lib_cleanup</function></funcdef>
+			<void/></funcprototype></funcsynopsis>
+			<para>Call mosquitto_lib_init() before using any of the other
+				library functions and mosquitto_lib_cleanup() after finishing
+				with the library.</para>
+		</refsect2>
+
+		<refsect2>
+			<title>Client constructor/destructor</title>
+
+			<funcsynopsis><funcprototype><funcdef>struct mosquitto *<function>mosquitto_new</function></funcdef>
+					<paramdef>const char *<parameter>id</parameter></paramdef>
+					<paramdef>bool <parameter>clean_session</parameter></paramdef>
+					<paramdef>void *<parameter>userdata</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+			<para>Create a new mosquitto client instance.</para>
+
+			<funcsynopsis><funcprototype><funcdef>void <function>mosquitto_destroy</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+			<para>Use to free memory associated with a mosquitto client instance.</para>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_reinitialise</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>id</parameter></paramdef>
+					<paramdef>bool <parameter>clean_session</parameter></paramdef>
+					<paramdef>void *<parameter>userdata</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Authentication and encryption</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_username_pw_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>username</parameter></paramdef>
+					<paramdef>const char *<parameter>password</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_tls_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>cafile</parameter></paramdef>
+					<paramdef>const char *<parameter>capath</parameter></paramdef>
+					<paramdef>const char *<parameter>certfile</parameter></paramdef>
+					<paramdef>const char *<parameter>keyfile</parameter></paramdef>
+					<paramdef>int <parameter>(*pw_callback)(char *buf, int size, int rwflag, void *userdata)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_tls_opts_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int <parameter>cert_reqs</parameter></paramdef>
+					<paramdef>const char *<parameter>tls_version</parameter></paramdef>
+					<paramdef>const char *<parameter>ciphers</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_tls_insecure_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>bool <parameter>value</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_tls_psk_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>psk</parameter></paramdef>
+					<paramdef>const char *<parameter>identity</parameter></paramdef>
+					<paramdef>const char *<parameter>ciphers</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Wills</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_will_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>topic</parameter></paramdef>
+					<paramdef>int <parameter>payloadlen</parameter></paramdef>
+					<paramdef>const void *<parameter>payload</parameter></paramdef>
+					<paramdef>int <parameter>qos</parameter></paramdef>
+					<paramdef>bool <parameter>retain</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_will_clear</function></funcdef>
+					<paramdef><parameter>struct mosquitto *mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Connect/disconnect</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_connect</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_connect_bind</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+					<paramdef>const char *<parameter>bind_address</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_connect_async</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_connect_bind_async</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+					<paramdef>const char *<parameter>bind_address</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_reconnect</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_reconnect_async</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_disconnect</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Publish</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_publish</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int *<parameter>mid</parameter></paramdef>
+					<paramdef>const char *<parameter>topic</parameter></paramdef>
+					<paramdef>int <parameter>payloadlen</parameter></paramdef>
+					<paramdef>const void *<parameter>payload</parameter></paramdef>
+					<paramdef>int <parameter>qos</parameter></paramdef>
+					<paramdef>bool <parameter>retain</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Subscribe/unsubscribe</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_subscribe</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int *<parameter>mid</parameter></paramdef>
+					<paramdef>const char *<parameter>sub</parameter></paramdef>
+					<paramdef>int <parameter>qos</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_unsubscribe</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int *<parameter>mid</parameter></paramdef>
+					<paramdef>const char *<parameter>sub</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Network loop</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int <parameter>timeout</parameter></paramdef>
+					<paramdef>int <parameter>max_packets</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_read</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int <parameter>max_packets</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_write</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int <parameter>max_packets</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_misc</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_forever</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>int <parameter>timeout</parameter></paramdef>
+					<paramdef>int <parameter>max_packets</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_socket</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>bool <function>mosquitto_want_write</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Threaded network loop</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_start</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_loop_stop</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>bool <parameter>force</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Misc client functions</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_max_inflight_messages_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>unsigned int <parameter>max_inflight_messages</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_reconnect_delay_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>unsigned int <parameter>reconnect_delay</parameter></paramdef>
+					<paramdef>unsigned int <parameter>reconnect_delay_max</parameter></paramdef>
+					<paramdef>bool <parameter>reconnect_exponential_backoff</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_user_data_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void *<parameter>userdata</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Callbacks</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_connect_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_connect)(struct mosquitto *, void *, int)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_disconnect_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_disconnect)(struct mosquitto *, void *, int)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_publish_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_publish)(struct mosquitto *, void *, int)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_message_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_message)(struct mosquitto *, void *, const struct mosquitto_message *)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_subscribe_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_subscribe)(struct mosquitto *, void *, int, int, const int *)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_unsubscribe_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_unsubscribe)(struct mosquitto *, void *, int)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_log_callback_set</function></funcdef>
+					<paramdef>struct mosquitto *<parameter>mosq</parameter></paramdef>
+					<paramdef>void <parameter>(*on_unsubscribe)(struct mosquitto *, void *, int, const char *)</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Utility functions</title>
+
+			<funcsynopsis><funcprototype><funcdef>const char *<function>mosquitto_connack_string</function></funcdef>
+					<paramdef>int <parameter>connack_code</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_message_copy</function></funcdef>
+					<paramdef>struct mosquitto_message *<parameter>dst</parameter></paramdef>
+					<paramdef>const struct mosquitto_message *<parameter>src</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_message_free</function></funcdef>
+					<paramdef>struct mosquitto_message **<parameter>message</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>const char *<function>mosquitto_strerror</function></funcdef>
+					<paramdef>int <parameter>mosq_errno</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_sub_topic_tokenise</function></funcdef>
+					<paramdef>const char *<parameter>subtopic</parameter></paramdef>
+					<paramdef>char ***<parameter>topics</parameter></paramdef>
+					<paramdef>int *<parameter>count</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_sub_topic_tokens_free</function></funcdef>
+					<paramdef>char ***<parameter>topics</parameter></paramdef>
+					<paramdef>int <parameter>count</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_topic_matches_sub</function></funcdef>
+					<paramdef>const char *<parameter>sub</parameter></paramdef>
+					<paramdef>const char *<parameter>topic</parameter></paramdef>
+					<paramdef>bool *<parameter>result</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+
+		<refsect2>
+			<title>Helper functions</title>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_subscribe_simple</function></funcdef>
+					<paramdef>struct mosquitto_message **<parameter>message</parameter></paramdef>
+					<paramdef>int <parameter>msg_count</parameter></paramdef>
+					<paramdef>bool <parameter>want_retained</parameter></paramdef>
+					<paramdef>const char *<parameter>topic</parameter></paramdef>
+					<paramdef>int<parameter>qos</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>const char *<parameter>client_id</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+					<paramdef>bool <parameter>clean_session</parameter></paramdef>
+					<paramdef>const char *<parameter>username</parameter></paramdef>
+					<paramdef>const char *<parameter>password</parameter></paramdef>
+					<paramdef>const struct libmosquitto_will *<parameter>will</parameter></paramdef>
+					<paramdef>const struct libmosquitto_tls *<parameter>tls</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+
+			<funcsynopsis><funcprototype><funcdef>int <function>mosquitto_subscribe_callback</function></funcdef>
+					<paramdef>int <parameter>(*callback)(struct mosquitto *, void *, const struct mosquitto_message *)</parameter></paramdef>
+					<paramdef>void *<parameter>userdata</parameter></paramdef>
+					<paramdef>const char *<parameter>topic</parameter></paramdef>
+					<paramdef>int <parameter>qos</parameter></paramdef>
+					<paramdef>const char *<parameter>host</parameter></paramdef>
+					<paramdef>int <parameter>port</parameter></paramdef>
+					<paramdef>const char *<parameter>client_id</parameter></paramdef>
+					<paramdef>int <parameter>keepalive</parameter></paramdef>
+					<paramdef>bool <parameter>clean_session</parameter></paramdef>
+					<paramdef>const char *<parameter>username</parameter></paramdef>
+					<paramdef>const char *<parameter>password</parameter></paramdef>
+					<paramdef>const struct libmosquitto_will *<parameter>will</parameter></paramdef>
+					<paramdef>const struct libmosquitto_tls *<parameter>tls</parameter></paramdef>
+			</funcprototype></funcsynopsis>
+		</refsect2>
+	</refsect1>
+
+	<refsect1>
+		<title>Examples</title>
+		<para><programlisting language="C">
+#include &lt;stdio.h&gt;
+#include &lt;mosquitto.h&gt;
+
+void my_message_callback(struct mosquitto *mosq, void *userdata, const struct mosquitto_message *message)
+{
+	if(message->payloadlen){
+		printf("%s %s\n", message->topic, message->payload);
+	}else{
+		printf("%s (null)\n", message->topic);
+	}
+	fflush(stdout);
+}
+
+void my_connect_callback(struct mosquitto *mosq, void *userdata, int result)
+{
+	int i;
+	if(!result){
+		/* Subscribe to broker information topics on successful connect. */
+		mosquitto_subscribe(mosq, NULL, "$SYS/#", 2);
+	}else{
+		fprintf(stderr, "Connect failed\n");
+	}
+}
+
+void my_subscribe_callback(struct mosquitto *mosq, void *userdata, int mid, int qos_count, const int *granted_qos)
+{
+	int i;
+
+	printf("Subscribed (mid: %d): %d", mid, granted_qos[0]);
+	for(i=1; i&lt;qos_count; i++){
+		printf(", %d", granted_qos[i]);
+	}
+	printf("\n");
+}
+
+void my_log_callback(struct mosquitto *mosq, void *userdata, int level, const char *str)
+{
+	/* Pring all log messages regardless of level. */
+	printf("%s\n", str);
+}
+
+int main(int argc, char *argv[])
+{
+	int i;
+	char *host = "localhost";
+	int port = 1883;
+	int keepalive = 60;
+	bool clean_session = true;
+	struct mosquitto *mosq = NULL;
+
+	mosquitto_lib_init();
+	mosq = mosquitto_new(NULL, clean_session, NULL);
+	if(!mosq){
+		fprintf(stderr, "Error: Out of memory.\n");
+		return 1;
+	}
+	mosquitto_log_callback_set(mosq, my_log_callback);
+	mosquitto_connect_callback_set(mosq, my_connect_callback);
+	mosquitto_message_callback_set(mosq, my_message_callback);
+	mosquitto_subscribe_callback_set(mosq, my_subscribe_callback);
+
+	if(mosquitto_connect(mosq, host, port, keepalive)){
+		fprintf(stderr, "Unable to connect.\n");
+		return 1;
+	}
+
+	mosquitto_loop_forever(mosq, -1, 1);
+
+	mosquitto_destroy(mosq);
+	mosquitto_lib_cleanup();
+	return 0;
+}
+		</programlisting></para>
+	</refsect1>
+	<refsect1>
+		<title>See Also</title>
+		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>
+					<manvolnum>8</manvolnum>
+				</citerefentry>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
+		</simplelist>
 	</refsect1>
 
 	<refsect1>