.TH PWGEN 1
.SH NAME
pwgen \- generate pronounceable passwords
.SH SYNOPSIS
.I pwgen maxlength
[
.B count
]

If you compile pwgen with 
.I -DALLBYOPTS,
 then the synopsis becomes:

.I pwgen 
[ 
.B -acnsh 
.B --alt-phonics
.B --capitalize
.B --numerals
.B --secure
.B --help
]
.I maxlength
[
.B count
]
.SH DESCRIPTION
.I pwgen
generates random, meaningless but pronounceable passwords. Depending
on how the program was installed, these words contain either only
lowercase letters, or upper and lower case mixed, or digits thrown
in. Uppercase letters and digits are placed in a way that eases
remembering their position when memorizing only the word.
.P
Prefer pwgen -s to pwgen if you want a "secure" password.
.P
.I pwgen
does not interact with the system's password handling. All it does is
print out one or more passwords that can subsequently be used as input
for
.I passwd
(1) or for similar applications.
.SH COMMAND-LINE OPTIONS
.PP
If 
.I pwgen 
was compiled with the 
.I -DALLBYOPTS
compile-time option, then the following options are recognized:

.TP
\fB\-a, --alt-phonics\fR
Use an alternate phonics table. Identical to using a 
.I pwgen
which was compiled with
.I -DALTPHON.

.TP
\fB\-c, --capitalize\fR
Semi-random capitalization (not so random yet...) Identical to using a 
.I pwgen
which was compiled with
.I -DCAPITALIZE.

.TP
\fB\-n, --numerals\fR
Semi-random numeral insertion (not so random yet...) Identical to using a 
.I pwgen
which was compiled with
.I -DNUMERALS.

.TP
\fB\-s, --secure\fR
Generate totally random, secure, unpronouncible passwords. Identical to using
.I spwgen.

.TP
\fB\-h, --help\fR
Print a help message to standard output, then exit successfully.

.SH PARAMETERS
.TP
.I length
(number from 4 to 16) specifies the maximum password length. This
parameter is required.
.TP
.I count
specifies how many passwords to produce. Defaults to one.
.SH SEE ALSO
.I passwd
(1)
.SH BUGS
.PD 0
Not always uses the whole
.I length,
in fact mostly it generates one character less.
.P
The position of capitals and digits is too predictable.
.P
Sometimes misses the capitals/digits.
.PD
.SH AUTHOR
.PD 0
Brandon S. Allbery <allbery@ncoast.UUCP>
.P
Capitals/digits and man page by Olaf Titz
<titz@askdonald.ask.uni-karlsruhe.de>
.P
spwgen by Vincent Renardias <vincent@waw.com>
and Bruce Perens <bruce@pixar.com>
.P
Modifications to pwgen causing it to accept the options -a, -c, -n
and -s by Jim Lynch <jim@laney.edu> who also updated the man page 
and the makefile to suit. The functionality made available by these
options were not modified; the only change was to make them all
accessible from a single pwgen binary. The package is otherwise
identical.