Mercurial > projects > pwm
comparison pwm.1.xml @ 12:8768fbd09bc5
Add generatepassword command to generate random passwords
Refactor and generalize handling of named arguments.
| author | Guido Berhoerster <guido+pwm@berhoerster.name> |
|---|---|
| date | Thu, 03 Aug 2017 10:22:07 +0200 |
| parents | 85bce13237cf |
| children | cf81eb0c2d5a |
comparison
equal
deleted
inserted
replaced
| 11:85bce13237cf | 12:8768fbd09bc5 |
|---|---|
| 32 <surname>Berhoerster</surname> | 32 <surname>Berhoerster</surname> |
| 33 </personname> | 33 </personname> |
| 34 <email>guido+pwm@berhoerster.name</email> | 34 <email>guido+pwm@berhoerster.name</email> |
| 35 <personblurb/> | 35 <personblurb/> |
| 36 </author> | 36 </author> |
| 37 <date>31 July, 2017</date> | 37 <date>3 August, 2017</date> |
| 38 </info> | 38 </info> |
| 39 <refmeta> | 39 <refmeta> |
| 40 <refentrytitle>pwm</refentrytitle> | 40 <refentrytitle>pwm</refentrytitle> |
| 41 <manvolnum>1</manvolnum> | 41 <manvolnum>1</manvolnum> |
| 42 <refmiscinfo class="source"/> | 42 <refmiscinfo class="source"/> |
| 391 <para>Remove the empty group named | 391 <para>Remove the empty group named |
| 392 <replaceable>name</replaceable>.</para> | 392 <replaceable>name</replaceable>.</para> |
| 393 </listitem> | 393 </listitem> |
| 394 </varlistentry> | 394 </varlistentry> |
| 395 <varlistentry> | 395 <varlistentry> |
| 396 <term>Generate a random password</term> | |
| 397 <listitem> | |
| 398 <cmdsynopsis> | |
| 399 <command>generatepassword</command> | |
| 400 <arg choice="opt"> | |
| 401 <replaceable>id</replaceable> | |
| 402 </arg> | |
| 403 <arg choice="opt"> | |
| 404 len=<replaceable>n</replaceable> | |
| 405 </arg> | |
| 406 <arg choice="opt" rep="repeat"> | |
| 407 chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable> | |
| 408 </arg> | |
| 409 <arg choice="opt" rep="repeat"> | |
| 410 charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable> | |
| 411 </arg> | |
| 412 </cmdsynopsis> | |
| 413 <cmdsynopsis> | |
| 414 <command>gp</command> | |
| 415 <arg choice="opt"> | |
| 416 <replaceable>id</replaceable> | |
| 417 </arg> | |
| 418 <arg choice="opt"> | |
| 419 len=<replaceable>n</replaceable> | |
| 420 </arg> | |
| 421 <arg choice="opt" rep="repeat"> | |
| 422 chars=<replaceable>n</replaceable>:<replaceable>chars</replaceable> | |
| 423 </arg> | |
| 424 <arg choice="opt" rep="repeat"> | |
| 425 charclass=<replaceable>n</replaceable>:<replaceable>class</replaceable> | |
| 426 </arg> | |
| 427 <sbr/> | |
| 428 </cmdsynopsis> | |
| 429 <para>Randomly generate a new password according to the specified | |
| 430 constraints. The <literal>len</literal> argument sets the length of | |
| 431 the generated password to <replaceable>n</replaceable> characters. | |
| 432 The <literal>chars</literal> argument constrains the password to | |
| 433 <replaceable>n</replaceable> from the set of characters | |
| 434 <replaceable>chars</replaceable>. Similarly, the | |
| 435 <literal>charclass</literal> argument to | |
| 436 <replaceable>n</replaceable> characters from the extended regular | |
| 437 expression character class <replaceable>class</replaceable>. | |
| 438 Multiple <literal>char</literal> and <literal>charclass</literal> | |
| 439 arguments may be specified, in which case the generated passwords | |
| 440 match all of them.</para> | |
| 441 </listitem> | |
| 442 </varlistentry> | |
| 443 <varlistentry> | |
| 396 <term>Change the master password</term> | 444 <term>Change the master password</term> |
| 397 <listitem> | 445 <listitem> |
| 398 <cmdsynopsis> | 446 <cmdsynopsis> |
| 399 <command>changepassword</command> | 447 <command>changepassword</command> |
| 400 </cmdsynopsis> | 448 </cmdsynopsis> |