--- a/doc/web/source/howto/manage_accounts.rst Sun Feb 23 18:16:57 2014 +0000
+++ b/doc/web/source/howto/manage_accounts.rst Sun Feb 23 23:38:12 2014 +0000
@@ -151,8 +151,10 @@
.. program:: vmm userpassword
Syntax:
- | **vmm userpassword** *address* [**-p** *password*] [**-s** *scheme*]
- | **vmm up** *address* [**-p** *password*] [**-s** *scheme*]
+ | **vmm userpassword** *address* ([**-p** *password*] [**-s** *scheme*] | \
+ [**‒‒hash** *pwhash*])
+ | **vmm up** *address* ([**-p** *password*] [**-s** *scheme*] | \
+ [**‒‒hash** *pwhash*])
.. option:: -p password
@@ -163,9 +165,22 @@
When a *scheme* was specified, it overrides the *misc.password_scheme*
setting, configured in the :file:`vmm.cfg` file.
+.. option:: --hash pwhash
+
+ A hashed password, prefixed with **{**\ *SCHEME*\ **}**; as generated by
+ :command:`doveadm pw`.
+ You should enclose the hashed password in single quotes, if it contains
+ one ore more dollar signs (**$**).
+
The password of an account can be updated with this subcommand.
-If no *password* was provided, :command:`vmm` will prompt for it interactively.
+If no *password* or *pwhash* was provided, :command:`vmm` will prompt for a
+password interactively.
+
+.. note::
+ When passing a hashed password, :command:`vmm` checks only if the included
+ *SCHEME* is supported by your Dovecot installation. No further checks are
+ done.
Example: