Eclipse Mosquitto - An open source MQTT broker
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
doragasu 4471ee9e47 Call disconnect callback on TLS error.
When using the library asynchronously, TLS errors caused e.g. because
of the date/time not set correctly, cause the connection to be silently
dropped without the disconnection callback being invoked, as described
in issue #1052.

This commit fixes the issue, returning the behavior to the one the
library had previous to version 1.5.4, if a TLS error occurs, the
disconnect callback will be invoked for the client to get notified of
the error.

Signed-off-by: doragasu <doragasu@protonmail.com>
4 years ago
.github Add issue template. 5 years ago
apps Fix `mosquitto_ctrl dynsec setDefaultACLAccess` command not working. 4 years ago
client mosquitto_sub and mosquitto_rr now open stdout in binary mode on Windows 4 years ago
cmake Fix cjson include paths. 5 years ago
deps Move deps directory to root. 5 years ago
doc JOSS paper. 8 years ago
docker Docker apk upgrade no longer needed. 4 years ago
examples Merge remote-tracking branch 'origin/fixes' into develop 5 years ago
include Bump version, update web page. 4 years ago
installer Bump version, update web page. 4 years ago
lib Call disconnect callback on TLS error. 4 years ago
logo Improve logo files. 9 years ago
man Fix `max_keepalive` option not being able to be set to 0. 4 years ago
misc Fix letsencrypt case when RENEWED_DOMAINS is empty. 4 years ago
plugins Fix openssl not being linked to dynamic security plugin. 4 years ago
security Fix apparmor incorrectly denying access db tmp file. 5 years ago
service Fix pid paths in systemd unit. 4 years ago
snap Bump version, update web page. 4 years ago
src Fix `max_keepalive` option not being able to be set to 0. 4 years ago
test Fix for #575314. 4 years ago
www Web page updates. 4 years ago
.gitignore Ignore windows 64 bit build dir. 5 years ago
.travis.yml Travis: Use bionic distro. 6 years ago
CMakeLists.txt Bump version, update web page. 4 years ago
CONTRIBUTING.md Fix link in CONTRIBUTING.md. 6 years ago
ChangeLog.txt Fix `max_keepalive` option not being able to be set to 0. 4 years ago
LICENSE.txt Update to EPL-2.0 5 years ago
Makefile Update notice file. 4 years ago
NOTICE.md Update notice file. 4 years ago
README-compiling.md Add man page deps to readme. 4 years ago
README-letsencrypt.md Breaking: Drop privileges after loading the configuration 5 years ago
README-tests.md Consistency in readme naming. 5 years ago
README-windows.txt Document reason for Windows connection limit. 4 years ago
README.md Add more documentation on pthread support. 5 years ago
SECURITY.md Add SECURITY.md. 6 years ago
THANKS.txt Merge branch 'master' into develop 9 years ago
about.html Update to EPL-2.0 5 years ago
aclfile.example Initial contribution. 12 years ago
appveyor.yml Update appveyor to take into account now available packages. 8 years ago
buildtest.py Build warning fixes. 4 years ago
config.h Fix building with Visual Studio 2008 5 years ago
config.mk Bump version, update web page. 4 years ago
edl-v10 Initial contribution. 12 years ago
epl-v20 Update to EPL-2.0 5 years ago
libmosquitto.pc.in Add pkg-config files to CMake build (#213) 9 years ago
libmosquittopp.pc.in Add pkg-config files to CMake build (#213) 9 years ago
mosquitto.conf Fix `max_keepalive` option not being able to be set to 0. 4 years ago
pskfile.example Initial contribution. 12 years ago
pwfile.example Initial contribution. 12 years ago
set-version.sh Bump version, update web page. 4 years ago
travis-configure.sh Better attempt at fixing mac travis. 7 years ago
travis-install.sh Don't update homebrew in travis, it takes an age otherwise. 5 years ago

README.md

Eclipse Mosquitto

Mosquitto is an open source implementation of a server for version 5.0, 3.1.1, and 3.1 of the MQTT protocol. It also includes a C and C++ client library, and the mosquitto_pub and mosquitto_sub utilities for publishing and subscribing.

See the following links for more information on MQTT:

Mosquitto project information is available at the following locations:

There is also a public test server available at https://test.mosquitto.org/

Installing

See https://mosquitto.org/download/ for details on installing binaries for various platforms.

Quick start

If you have installed a binary package the broker should have been started automatically. If not, it can be started with a basic configuration:

mosquitto

Then use mosquitto_sub to subscribe to a topic:

mosquitto_sub -t 'test/topic' -v

And to publish a message:

mosquitto_pub -t 'test/topic' -m 'hello world'

Documentation

Documentation for the broker, clients and client library API can be found in the man pages, which are available online at https://mosquitto.org/man/. There are also pages with an introduction to the features of MQTT, the mosquitto_passwd utility for dealing with username/passwords, and a description of the configuration file options available for the broker.

Detailed client library API documentation can be found at https://mosquitto.org/api/

Building from source

To build from source the recommended route for end users is to download the archive from https://mosquitto.org/download/.

On Windows and Mac, use cmake to build. On other platforms, just run make to build. For Windows, see also README-windows.md.

If you are building from the git repository then the documentation will not already be built. Use make binary to skip building the man pages, or install docbook-xsl on Debian/Ubuntu systems.

Build Dependencies

  • c-ares (libc-ares-dev on Debian based systems) - only when compiled with make WITH_SRV=yes
  • cJSON - for client JSON output support. Disable with make WITH_CJSON=no Auto detected with CMake.
  • libwebsockets (libwebsockets-dev) - enable with make WITH_WEBSOCKETS=yes
  • openssl (libssl-dev on Debian based systems) - disable with make WITH_TLS=no
  • pthreads - for client library thread support. This is required to support the mosquitto_loop_start() and mosquitto_loop_stop() functions. If compiled without pthread support, the library isn't guaranteed to be thread safe.
  • uthash / utlist - bundled versions of these headers are provided, disable their use with make WITH_BUNDLED_DEPS=no
  • xsltproc (xsltproc and docbook-xsl on Debian based systems) - only needed when building from git sources - disable with make WITH_DOCS=no

Equivalent options for enabling/disabling features are available when using the CMake build.

Credits

Mosquitto was written by Roger Light roger@atchoo.org

Master: Travis Build Status (master) Develop: Travis Build Status (develop) Fixes: Travis Build Status (fixes)