NAME

       mkpasswd.pl - example to generate new password with String::MkPasswd

SYNOPSIS

         mkpasswd.pl [-options]

         #!/bin/sh
         NEW_PASSWD=`mkpasswd.pl`

DESCRIPTION

       This program generates a random password, allowing for some tuning of character distribution.  The
       password is sent to standard output.

   OPTIONS
       -l # | --length=#
           The total length of the password.  The default is 9.

       -d # | --digits=#
           The minimum number of digits that will appear in the final password.  The default is 2.

       -c # | --lower=#
           The minimum number of lower-case characters that will appear in the final password.  The default is
           2.

       -C # | --upper=#
           The minimum number of upper-case characters that will appear in the final password.  The default is
           2.

       -s # | --special=#
           The minimum number of non-alphanumeric characters that will appear in the final password.  The
           default is 1.

       -2 | --distribute
           If specified, password characters will be distributed between the left- and right-hand sides of the
           keyboard.  This makes it more difficult for an onlooker to see the password as it is typed.

       --nodigits | --no-digits
           Alias for --digits=0.

       --nolower | --no-lower
           Alias for --lower=0.

       --noupper | --no-upper
           Alias for --upper=0.

       --nospecial | --no-special
           Alias for --special=0.

BUGS

       •   While not really a bug, the .pl extension has been added to avoid conflict with the program of the
           same name distributed with Expect.

TODO

       •   For completeness, add user password setting functionality as found in Expect's mkpasswd(1) example.

SEE ALSO

       <http://expect.nist.gov/#examples>, mkpasswd(1), String::MkPasswd

AKNOWLEDGEMENTS

       Don Libes of the National Institute of Standards and Technology, who wrote the Expect example,
       mkpasswd(1).

AUTHOR

       Chris Grau <cgrau@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2003-2004 by Chris Grau

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself, either Perl version 5.8.1 or, at your option, any later version of Perl 5 you may have available.