149 userpassword |
149 userpassword |
150 ------------ |
150 ------------ |
151 .. program:: vmm userpassword |
151 .. program:: vmm userpassword |
152 |
152 |
153 Syntax: |
153 Syntax: |
154 | **vmm userpassword** *address* [**-p** *password*] [**-s** *scheme*] |
154 | **vmm userpassword** *address* ([**-p** *password*] [**-s** *scheme*] | \ |
155 | **vmm up** *address* [**-p** *password*] [**-s** *scheme*] |
155 [**‒‒hash** *pwhash*]) |
|
156 | **vmm up** *address* ([**-p** *password*] [**-s** *scheme*] | \ |
|
157 [**‒‒hash** *pwhash*]) |
156 |
158 |
157 .. option:: -p password |
159 .. option:: -p password |
158 |
160 |
159 The user's new password. |
161 The user's new password. |
160 |
162 |
161 .. option:: -s scheme |
163 .. option:: -s scheme |
162 |
164 |
163 When a *scheme* was specified, it overrides the *misc.password_scheme* |
165 When a *scheme* was specified, it overrides the *misc.password_scheme* |
164 setting, configured in the :file:`vmm.cfg` file. |
166 setting, configured in the :file:`vmm.cfg` file. |
165 |
167 |
|
168 .. option:: --hash pwhash |
|
169 |
|
170 A hashed password, prefixed with **{**\ *SCHEME*\ **}**; as generated by |
|
171 :command:`doveadm pw`. |
|
172 You should enclose the hashed password in single quotes, if it contains |
|
173 one ore more dollar signs (**$**). |
|
174 |
166 The password of an account can be updated with this subcommand. |
175 The password of an account can be updated with this subcommand. |
167 |
176 |
168 If no *password* was provided, :command:`vmm` will prompt for it interactively. |
177 If no *password* or *pwhash* was provided, :command:`vmm` will prompt for a |
|
178 password interactively. |
|
179 |
|
180 .. note:: |
|
181 When passing a hashed password, :command:`vmm` checks only if the included |
|
182 *SCHEME* is supported by your Dovecot installation. No further checks are |
|
183 done. |
169 |
184 |
170 Example: |
185 Example: |
171 |
186 |
172 .. code-block:: console |
187 .. code-block:: console |
173 |
188 |