From fe32e2506b96e524654808abc0ca846ed737d2f9 Mon Sep 17 00:00:00 2001
From: "Roger A. Light" <roger@atchoo.org>
Date: Thu, 19 May 2022 15:28:37 +0100
Subject: [PATCH] Add more mosquitto_passwd examples

---
 man/mosquitto_passwd.1.xml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/man/mosquitto_passwd.1.xml b/man/mosquitto_passwd.1.xml
index bd90fa51..30cb6bb2 100644
--- a/man/mosquitto_passwd.1.xml
+++ b/man/mosquitto_passwd.1.xml
@@ -191,6 +191,22 @@
 		<itemizedlist mark="circle">
 			<listitem><para>mosquitto_passwd <literal>-c</literal> /etc/mosquitto/passwd <literal>ral</literal></para></listitem>
 		</itemizedlist>
+		<para>Add a user to an existing password file:</para>
+		<itemizedlist mark="circle">
+			<listitem><para>mosquitto_passwd /etc/mosquitto/passwd <literal>ral</literal></para></listitem>
+		</itemizedlist>
+		<para>Add a user to an existing password file, passing the password on the command line:</para>
+		<itemizedlist mark="circle">
+			<listitem><para>mosquitto_passwd -b /etc/mosquitto/passwd <literal>ral</literal> <literal>z2Dr0BsvtZ</literal></para></listitem>
+		</itemizedlist>
+		<para>Update the password for a user in an existing password file:</para>
+		<itemizedlist mark="circle">
+			<listitem><para>mosquitto_passwd /etc/mosquitto/passwd <literal>ral</literal></para></listitem>
+		</itemizedlist>
+		<para>Add a user to an existing password file using the sha512 hash for Mosquitto 1.6 compatibility:</para>
+		<itemizedlist mark="circle">
+			<listitem><para>mosquitto_passwd -H sha512 /etc/mosquitto/passwd <literal>ral</literal></para></listitem>
+		</itemizedlist>
 		<para>Delete a user from a password file</para>
 		<itemizedlist mark="circle">
 			<listitem><para>mosquitto_passwd <literal>-D</literal> /etc/mosquitto/passwd <literal>ral</literal></para></listitem>