README
1Crypt::PassGen
2--------------
3
4This module provides a single command for generating random password
5that is close enough to a real word that it is easy to remember.
6It does this by using the frequency of letter combinations in
7a language (the frequency table is generated during installation
8although multiple tables can be generated and used for different
9languages).
10
11This module should not be used for high security applications
12(such as user accounts) since it returns passwords that are not
13mixed case, have no punctuation and no letters. This word can be
14used as a basis for a more secure password.
15
16The language of the password depends on the language used to construct
17the frequency table.
18
19The source repository is on github: https://github.com/timj/perl-Crypt-PassGen
20
21Requirements
22------------
23
24Currently assumes /usr/dict/words or /usr/share/dict/words is available so that the
25frequency table can be constructed. On non-unix systems it might
26be easier simply to include a dictionary for this within the
27distribution.
28
29Also requires the Storable module.
30
31Installation
32------------
33
34 perl Makefile.PL
35 make
36 make test
37 make install
38
39The first step may take a well since a freqeuncy table is generated
40as part of the installation. If /usr/dict/words is not available
41the location of a suitable dictionary must be put into the
42Makefile.PL
43
44
45Derivation
46----------
47
48This algorithm is based on that used in the PASSGEN program written by
49Mike Bartman of SAR, Inc as part of the SPAN security toolkit in 1989.
50
51
52Status
53------
54
55This is an early release of this module. It has not been tested
56extensively and must be considered in alpha release.
57
58Author
59------
60
61This module was written by Tim Jenness <tjenness@cpan.org>
62
63Copyright (C) 2000-2008, 2012 Tim Jenness. All rights reserved. This
64program is free software; you can redistribute it and/or modify it
65under the same terms as Perl itself.
66
67Release Notes
68-------------
69
70V0.06 - Ensure that passwords are always the right length. In rare
71 cases the loop would exit early and return a shorter password.
72 Thanks to Vadim Pushtaev for the fix.
73
74V0.05 - Fix typo in call to _scale_thirds_down preventing the
75 module from working in some situations. Fix typo in call
76 to _scale_seconds_down during database build
77
78