mirror of
https://github.com/boostorg/mqtt5.git
synced 2026-01-19 04:22:11 +00:00
Summary: Resolves #40 {F3809560} Reviewers: ivica Reviewed By: ivica Subscribers: miljen Differential Revision: https://repo.mireo.local/D37895
184 lines
10 KiB
Plaintext
184 lines
10 KiB
Plaintext
[/
|
|
Copyright (c) 2023-2025 Ivica Siladic, Bruno Iljazovic, Korina Simicevic
|
|
Distributed under the Boost Software License, Version 1.0.
|
|
(See accompanying file LICENSE or copy at http://www.boost.org/LICENSE_1_0.txt)
|
|
]
|
|
|
|
[library Boost.MQTT5: a C++17 MQTT client
|
|
[quickbook 1.7]
|
|
[copyright 2023-2025 Mireo]
|
|
[id mqtt5]
|
|
[purpose C++17 MQTT client]
|
|
[license
|
|
Distributed under the Boost Software License, Version 1.0.
|
|
(See accompanying file LICENSE_1_0.txt or copy at
|
|
[@http://www.boost.org/LICENSE_1_0.txt])
|
|
]
|
|
[authors [Siladić, Ivica], [Iljazović, Bruno], [Šimičević, Korina]]
|
|
[category template]
|
|
[category generic]
|
|
]
|
|
|
|
[template nochunk[] [block '''<?dbhtml stop-chunking?>''']]
|
|
[template mdash[] '''— ''']
|
|
[template hr[] '''<phrase role="silver">'''[mdash]'''</phrase>''']
|
|
[template link_to_file[path][^'''<ulink url="https://github.com/boostorg/mqtt5/blob/master/'''[path]'''">'''[path]'''</ulink>''']]
|
|
[template include_file[path][^<'''<ulink url="https://github.com/boostorg/mqtt5/blob/master/include/'''[path]'''">'''[path]'''</ulink>'''>]]
|
|
[template indexterm1[term1] '''<indexterm><primary>'''[term1]'''</primary></indexterm>''']
|
|
[template indexterm2[term1 term2] '''<indexterm><primary>'''[term1]'''</primary><secondary>'''[term2]'''</secondary></indexterm>''']
|
|
|
|
[template ghreflink[path text] [@https://github.com/boostorg/mqtt5/blob/master/[path] [text]]]
|
|
[template reflink2[id text][link mqtt5.ref.boost__mqtt5__[id] [^[text]]]]
|
|
[template reflink[id text][link mqtt5.ref.[id] [text]]]
|
|
[template refmem[class mem][reflink2 [class].[mem] [class]::[mem]]]
|
|
[template refmemunq[class mem][reflink2 [class].[mem] [mem]]]
|
|
[template asioreflink[id term][@boost:/doc/html/boost_asio/reference/[id].html [^boost::asio::[term]]]]
|
|
[template asioreflink2[id term][@boost:/doc/html/boost_asio/reference/[id].html [term]]]
|
|
[template beastreflink[id term][@boost:/libs/beast/doc/html/beast/ref/[id].html [^boost::beast::[term]]]]
|
|
[template beastconceptslink[id term][@boost:/libs/beast/doc/html/beast/concepts/[id].html [term]]]
|
|
[template mqttlink[id text][@https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc[id] [text]]]
|
|
|
|
[def __OPENSSL__ [@https://www.openssl.org/ OpenSSL]]
|
|
[def __HIVEMQ__ [@https://www.hivemq.com/ HiveMQ]]
|
|
|
|
[def __CompletionToken__ [@boost:/doc/html/boost_asio/reference/asynchronous_operations.html#boost_asio.reference.asynchronous_operations.completion_tokens_and_handlers ['CompletionToken]]]
|
|
[def __Executor__ [@boost:/doc/html/boost_asio/reference/Executor1.html ['Executor]]]
|
|
[def __ExecutionContext__ [@boost:/doc/html/boost_asio/reference/ExecutionContext.html ['ExecutionContext]]]
|
|
[def __StreamType__ [reflink StreamType ['StreamType]]]
|
|
[def __TlsContext__ [reflink TlsContext ['TlsContext]]]
|
|
[def __Authenticator__ [reflink Authenticator ['Authenticator]]]
|
|
[def __LoggerType__ [reflink LoggerType ['LoggerType]]]
|
|
|
|
[def __Boost__ [@https://www.boost.org/ Boost]]
|
|
[def __Asio__ [@boost:/libs/asio/index.html Boost.Asio]]
|
|
[def __Beast__ [@boost:/libs/beast/index.html Boost.Beast]]
|
|
[def __ASIO_PER_OP_CANCELLATION__ [@boost:/doc/html/boost_asio/overview/core/cancellation.html Per-Operation Cancellation]]
|
|
[def __ASIO_ALLOCATORS__ [@boost:/doc/html/boost_asio/overview/model/allocators.html Allocators]]
|
|
[def __ASIO_CUSTOM_MEMORY_ALLOCATION__ [@boost:/doc/html/boost_asio/overview/core/allocation.html Custom Memory Allocation]]
|
|
[def __ASIO_PARALLEL_GROUP__ [@boost:/doc/html/boost_asio/overview/composition/parallel_group.html Co-ordinating Parallel Operations]]
|
|
[def __ASIO_STRANDS__ [@boost:/doc/html/boost_asio/overview/core/strands.html Strands: Use Threads Without Explicit Locking]]
|
|
[def __IOC__ [@boost:doc/html/boost_asio/reference/io_context.html `boost::asio::io_context`]]
|
|
[def __IOC_RUN__ [@boost:doc/html/boost_asio/reference/io_context/run.html `boost::asio::io_context::run()`]]
|
|
[def __STRAND__ [@boost:doc/html/boost_asio/reference/io_context__strand.html `boost::asio::io_context::strand`]]
|
|
[def __DISPATCH__ [@boost:doc/html/boost_asio/reference/dispatch.html `boost::asio::dispatch`]]
|
|
[def __POST__ [@boost:doc/html/boost_asio/reference/post.html `boost::asio::post`]]
|
|
[def __ASYNC_IMMEDIATE__ [@boost:doc/html/boost_asio/reference/async_immediate.html `boost::asio::async_immediate`]]
|
|
[def __CO_SPAWN__ [@boost:/doc/html/boost_asio/reference/co_spawn.html `boost::asio::co_spawn`]]
|
|
[def __USE_AWAITABLE__ [@boost:/doc/html/boost_asio/reference/use_awaitable.html `boost::asio::use_awaitable`]]
|
|
[def __USE_FUTURE__ [@boost:/doc/html/boost_asio/reference/use_future.html `boost::asio::use_future`]]
|
|
[def __SSL__ [@boost:/doc/html/boost_asio/overview/ssl.html `SSL`]]
|
|
[def __CANCELLATION_TYPE__ [asioreflink cancellation_type cancellation_type]]
|
|
[def __TCP_SOCKET__ [asioreflink ip__tcp/socket ip::tcp::socket]]
|
|
[def __SSL_CONTEXT__ [asioreflink ssl__context ssl::context]]
|
|
[def __SSL_STREAM__ [asioreflink ssl__stream ssl::stream<__TCP_SOCKET__>]]
|
|
[def __WEBSOCKET_STREAM__ [beastreflink boost__beast__websocket__stream websocket::stream<NextLayer>]]
|
|
[def __BEAST_ASYNC_TEARDOWN__ [beastreflink boost__beast__websocket__async_teardown boost::beast::websocket::async_teardown]]
|
|
|
|
[/ MQTT ]
|
|
[def __MQTT__ [@https://mqtt.org/ MQTT]]
|
|
[def __Self__ [@https://github.com/boostorg/mqtt5/ Boost.MQTT5]]
|
|
[def __Client__ [reflink2 mqtt_client `mqtt_client`]]
|
|
|
|
[def __UTF8_STRING_PAIR__ [mqttlink 3901013 `UTF-8 String Pair`]]
|
|
[def __PACKET_SIZE__ [mqttlink 3901024 `packet size`]]
|
|
[def __MAXIMUM_QOS__ [mqttlink 3901084 `Maximum QoS`]]
|
|
[def __RETAIN_AVAILABLE__ [mqttlink 3901085 `Retain Available`]]
|
|
[def __TOPIC_ALIAS_MAX__ [mqttlink 3901051 `Topic Alias Maximum`]]
|
|
[def __QOS__ [mqttlink 3901234 `QoS`]]
|
|
[def __RETAIN__ [mqttlink 3901104 `RETAIN`]]
|
|
[def __SUBSCRIBE_OPTIONS__ [mqttlink 3901169 `Subscribe Options`]]
|
|
[def __ENHANCED_AUTH__ [mqttlink 3901256 `Enhanced Authentication`]]
|
|
[def __RE_AUTHENTICATION__ [mqttlink 3901257 `Re-authentication`]]
|
|
[def __TOPIC_SEMANTIC_AND_USAGE__ [mqttlink 3901247 `Topic semantic and usage`]]
|
|
|
|
[def __CONNECT__ [mqttlink 3901033 `CONNECT`]]
|
|
[def __CONNACK__ [mqttlink 3901074 `CONNACK`]]
|
|
[def __PUBLISH__ [mqttlink 3901100 `PUBLISH`]]
|
|
[def __PUBACK__ [mqttlink 3901121 `PUBACK`]]
|
|
[def __PUBREC__ [mqttlink 3901131 `PUBREC`]]
|
|
[def __PUBREL__ [mqttlink 3901141 `PUBREL`]]
|
|
[def __PUBCOMP__ [mqttlink 3901151 `PUBCOMP`]]
|
|
[def __SUBSCRIBE__ [mqttlink 3901161 `SUBSCRIBE`]]
|
|
[def __SUBACK__ [mqttlink 3901171 `SUBACK`]]
|
|
[def __UNSUBSCRIBE__ [mqttlink 3901179 `UNSUBSCRIBE`]]
|
|
[def __UNSUBACK__ [mqttlink 3901187 `UNSUBACK`]]
|
|
[def __PINGREQ__ [mqttlink 3901195 `PINGREQ`]]
|
|
[def __PINGRESP__ [mqttlink 3901200 `PINGRESP`]]
|
|
[def __DISCONNECT__ [mqttlink 3901205 `DISCONNECT`]]
|
|
[def __AUTH__ [mqttlink 3901217 `AUTH`]]
|
|
|
|
[def __WILL_PROPS__ [reflink will_props `boost::mqtt5::will_props`]]
|
|
[def __CONNECT_PROPS__ [reflink connect_props `boost::mqtt5::connect_props`]]
|
|
[def __CONNACK_PROPS__ [reflink connack_props `boost::mqtt5::connack_props`]]
|
|
[def __PUBLISH_PROPS__ [reflink publish_props `boost::mqtt5::publish_props`]]
|
|
[def __PUBACK_PROPS__ [reflink puback_props `boost::mqtt5::puback_props`]]
|
|
[def __PUBREC_PROPS__ [reflink pubrec_props `boost::mqtt5::pubrec_props`]]
|
|
[def __PUBREL_PROPS__ [reflink pubrel_props `boost::mqtt5::pubrel_props`]]
|
|
[def __PUBCOMP_PROPS__ [reflink pubcomp_props `boost::mqtt5::pubcomp_props`]]
|
|
[def __SUBSCRIBE_PROPS__ [reflink subscribe_props `boost::mqtt5::subscribe_props`]]
|
|
[def __SUBACK_PROPS__ [reflink suback_props `boost::mqtt5::suback_props`]]
|
|
[def __UNSUBSCRIBE_PROPS__ [reflink unsubscribe_props `boost::mqtt5::unsubscribe_props`]]
|
|
[def __UNSUBACK_PROPS__ [reflink unsuback_props `boost::mqtt5::unsuback_props`]]
|
|
[def __DISCONNECT_PROPS__ [reflink disconnect_props `boost::mqtt5::disconnect_props`]]
|
|
[def __AUTH_PROPS__ [reflink auth_props `boost::mqtt5::auth_props`]]
|
|
|
|
[def __KEEP_ALIVE__ [mqttlink 3901045 `Keep Alive`]]
|
|
[def __SERVER_KEEP_ALIVE__ [mqttlink 3901094 `Server Keep Alive`]]
|
|
|
|
[def __ERROR_CODE__ [reflink2 error_code `boost::mqtt5::error_code`]]
|
|
[def __REASON_CODE__ [reflink2 reason_code `boost::mqtt5::reason_code`]]
|
|
|
|
[def __REASON_CODES__ [reflink Reason_codes `Reason Codes`]]
|
|
[def __ERROR_HANDLING__ [reflink Error_handling `Error handling`]]
|
|
|
|
[import ../../example/hello_world_over_tcp.cpp]
|
|
[import ../../example/hello_world_over_tls.cpp]
|
|
[import ../../example/hello_world_over_websocket_tcp.cpp]
|
|
[import ../../example/hello_world_over_websocket_tls.cpp]
|
|
[import ../../example/publisher.cpp]
|
|
[import ../../example/receiver.cpp]
|
|
[import ../../example/multiflight_client.cpp]
|
|
[import ../../example/timeout_with_parallel_group.cpp]
|
|
[import ../../example/timeout_with_awaitable_operators.cpp]
|
|
[import ../../example/hello_world_in_multithreaded_env.cpp]
|
|
[import ../../example/hello_world_in_coro_multithreaded_env.cpp]
|
|
|
|
[include 01_intro.qbk]
|
|
[include 02_getting_started.qbk]
|
|
[include 03_auto_reconnect.qbk]
|
|
[include 04_maintaining_a_stable_connection.qbk]
|
|
[include 05_optimising_communication.qbk]
|
|
[include 06_disconnecting_the_client.qbk]
|
|
[include 07_asio_compliance.qbk]
|
|
[include 11_multithreading.qbk]
|
|
[include 12_examples.qbk]
|
|
|
|
[include examples/Examples.qbk]
|
|
|
|
[section:ref Reference]
|
|
[xinclude reference/quickref.xml]
|
|
[block'''<part label="Two: Reference">''']
|
|
[include reference.qbk]
|
|
[include reference/Error_handling.qbk]
|
|
[include reference/concepts/StreamType.qbk]
|
|
[include reference/concepts/TlsContext.qbk]
|
|
[include reference/concepts/Authenticator.qbk]
|
|
[include reference/concepts/LoggerType.qbk]
|
|
[include reference/reason_codes/Reason_codes.qbk]
|
|
[include reference/properties/will_props.qbk]
|
|
[include reference/properties/connect_props.qbk]
|
|
[include reference/properties/connack_props.qbk]
|
|
[include reference/properties/publish_props.qbk]
|
|
[include reference/properties/puback_props.qbk]
|
|
[include reference/properties/pubrec_props.qbk]
|
|
[include reference/properties/pubrel_props.qbk]
|
|
[include reference/properties/pubcomp_props.qbk]
|
|
[include reference/properties/subscribe_props.qbk]
|
|
[include reference/properties/suback_props.qbk]
|
|
[include reference/properties/unsubscribe_props.qbk]
|
|
[include reference/properties/unsuback_props.qbk]
|
|
[include reference/properties/disconnect_props.qbk]
|
|
[include reference/properties/auth_props.qbk]
|
|
[block'''</part>''']
|
|
[endsect]
|