MQTT Client: MQTT Client library for C

An MQTT client library in C.© Copyright IBM Corp. 2009, 2013

These pages describe the original more synchronous API which might be considered easier to use. Some of the calls will block. For the new totally asynchronous API where no calls block, which is especially suitable for use in windowed environments, see the MQTT C Client Asynchronous API Documentation.

An MQTT client application connects to MQTT-capable servers. A typical client is responsible for collecting information from a telemetry device and publishing the information to the server. It can also subscribe to topics, receive messages, and use this information to control the telemetry device.

MQTT clients implement the published MQTT v3 protocol. You can write your own API to the MQTT protocol using the programming language and platform of your choice. This can be time-consuming and error-prone.

To simplify writing MQTT client applications, WebSphere MQ Telemetry provides C and Java client libraries that encapsulate the MQTT v3 protocol for a number of platforms. If you incorporate these libraries in your MQTT applications, a fully functional MQTT client can be written in a few lines of code. The information presented here documents the API provided by the IBM MQTT Client library for C.

Using the client
Applications that use the client library typically use a similar structure:

Create a clent
Set the options to connect to an MQTT server
Set up callback functions if multi-threaded (asynchronous mode) operation is being used (see Asynchronous vs synchronous client applications).
Subscribe to any topics the client needs to receive
Repeat until finished:
- Publish any messages the client needs to
- Handle any incoming messages
Disconnect the client
Free any memory being used by the client

Some simple examples are shown here:

Additional information about important concepts is provided here: