0de3f3a3f7
Why not if xsltproc available? Moreover why try to install not existent files? Signed-off-by: Konstantin Podsvirov <konstantin@podsvirov.pro> |
4 years ago | |
|---|---|---|
| .github | 5 years ago | |
| apps | 4 years ago | |
| client | 4 years ago | |
| cmake | 5 years ago | |
| deps | 5 years ago | |
| doc | 4 years ago | |
| docker | 4 years ago | |
| examples | 4 years ago | |
| include | 4 years ago | |
| installer | 4 years ago | |
| lib | 4 years ago | |
| logo | 9 years ago | |
| man | 4 years ago | |
| misc | 4 years ago | |
| plugins | 4 years ago | |
| security | 5 years ago | |
| service | 4 years ago | |
| snap | 4 years ago | |
| src | 4 years ago | |
| test | 4 years ago | |
| www | 4 years ago | |
| .gitignore | 5 years ago | |
| .travis.yml | 6 years ago | |
| CMakeLists.txt | 4 years ago | |
| CONTRIBUTING.md | 6 years ago | |
| ChangeLog.txt | 4 years ago | |
| LICENSE.txt | 5 years ago | |
| Makefile | 4 years ago | |
| NOTICE.md | 4 years ago | |
| README-compiling.md | 4 years ago | |
| README-letsencrypt.md | 5 years ago | |
| README-tests.md | 5 years ago | |
| README-windows.txt | 4 years ago | |
| README.md | 5 years ago | |
| SECURITY.md | 6 years ago | |
| THANKS.txt | 4 years ago | |
| about.html | 4 years ago | |
| aclfile.example | 12 years ago | |
| appveyor.yml | 8 years ago | |
| buildtest.py | 4 years ago | |
| config.h | 5 years ago | |
| config.mk | 4 years ago | |
| edl-v10 | 4 years ago | |
| epl-v20 | 4 years ago | |
| libmosquitto.pc.in | 9 years ago | |
| libmosquittopp.pc.in | 9 years ago | |
| mosquitto.conf | 4 years ago | |
| pskfile.example | 12 years ago | |
| pwfile.example | 12 years ago | |
| set-version.sh | 4 years ago | |
| travis-configure.sh | 7 years ago | |
| travis-install.sh | 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.
Links
See the following links for more information on MQTT:
- Community page: http://mqtt.org/
- MQTT v3.1.1 standard: https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
- MQTT v5.0 standard: https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html
Mosquitto project information is available at the following locations:
- Main homepage: https://mosquitto.org/
- Find existing bugs or submit a new bug: https://github.com/eclipse/mosquitto/issues
- Source code repository: https://github.com/eclipse/mosquitto
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=noAuto 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()andmosquitto_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: 
Develop: 
Fixes: 