diff -r 81f4bfc34ed8 -r 935b4901d652 doc/web/source/howto/manage_accounts.rst --- 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: