add mosquitto_delay_puback option

[linuxbasic]

Signed-off-by: Linus Basig [email protected]
Signed-off-by: Fabrizio Lazzaretti [email protected]

Thank you for contributing your time to the Mosquitto project!

Before you go any further, please note that we cannot accept contributions if
you haven't signed the Eclipse Contributor Agreement.
If you aren't able to do that, or just don't want to, please describe your bug
fix/feature change in an issue. For simple bug fixes it is can be just as easy
for us to be told about the problem and then go fix it directly.

Then please check the following list of things we ask for in your pull request:

• Have you signed the Eclipse Contributor Agreement, using the same email address as you used in your commits?
• Do each of your commits have a "Signed-off-by" line, with the correct email address? Use "git commit -s" to generate this line for you.
• If you are contributing a new feature, is your work based off the develop branch?
• If you are contributing a bugfix, is your work based off the fixes branch?
• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you successfully run make test with your changes locally?

---

This PR adds a method mosquitto_delay_puback. After calling mosquitto_delay_puback the library will delay the PUBACK message required for QoS 1 message transfers until after the on_message callback returns.

This change ensures the message does not get lost if the client crashes during the processing of the message.

If the mosquitto_delay_puback is not called, the previous behavior (PUBACK before calling on_message) applies.

related issues:

• Support delaying PUBACKs in libmosquitto API eclipse-mosquitto/mosquitto#118
• Mosquitto client implements QoS 1 a zero or more times and QoS 2 as at most once eclipse-mosquitto/mosquitto#188

My use-case is a messaging middleware that forwards the messages to other systems and we need to maintain the "At Least Once" delivery guarantee of QoS 1.