Note that zero length retained messages are never retained.

Closes #1871. Thanks to James Kleeh.
This commit is contained in:
Roger A. Light 2020-10-29 19:39:29 +00:00
parent 66d16280d8
commit e95327789e

View File

@ -454,7 +454,15 @@
<term><option>-r</option></term>
<term><option>--retain</option></term>
<listitem>
<para>If retain is given, the message will be retained as a "last known good" value on the broker. See <citerefentry><refentrytitle>mqtt</refentrytitle><manvolnum>7</manvolnum></citerefentry> for more information.</para>
<para>
If retain is given, the message will be retained as a
"last known good" value on the broker. See
<citerefentry><refentrytitle>mqtt</refentrytitle><manvolnum>7</manvolnum></citerefentry>
for more information. Note that zero length payloads
are never retained. If you send a zero length
payload retained message it will clear any retained
message on the topic.
</para>
</listitem>
</varlistentry>
<varlistentry>
@ -605,7 +613,11 @@
<listitem>
<para>If given, if the client disconnects unexpectedly the
message sent out will be treated as a retained message.
This must be used in conjunction with <option>--will-topic</option>.</para>
This must be used in conjunction with <option>--will-topic</option>.
Note that zero length payloads are never retained. If you send a zero length
payload retained message it will clear any retained
message on the topic.
</para>
</listitem>
</varlistentry>
<varlistentry>