
pam_pwgen module:
	Password generator module.
	
	The generator code was taken from from gpw.c by
	Tom Van Vleck <thvv@multicians.org>.  See README.gpw for details.

WHAT IT DOES:
	This module ganerates (pronouncable) passwords.

ARGUMENTS RECOGNIZED:
	debug		verbose logging

	retry=N		Prompt user at most N times before returning with
			error. Default N=1.

	minlen=N	minimal length of generated password. Default N=10.

	count=N		propose N passwords for the user. Default N=5.

	trifile=path	path to file with letter statistics used by
			pronouncable password generator.
			Default path=/etc/security/trigram.

	upper=N		Uppercase N letters. Default N=0, max N=minlen/2.

	digit=N		Convert N letters to digits, module tries to be
			smart and first changes look-alike letters
			(A=4,E=3,I=1,O=0,S=5,T=7,Z=2).
			Default N=0, max N=minlen/2.

MODULE SERVICES PROVIDED:
	password	chauthtok
	
USAGE:
	/etc/pam.d/passwd:

#%PAM-1.0
auth		required	pam_unix.so
account		required	pam_unix.so
password	[default=bad authtok_recover_err=die success=ok ignore=1 abort=done]	pam_pwgen.so minlen=9 retry=3 upper=1 digit=1
password	[success=1 default=bad]		pam_cracklib.so use_authtok
password	required	pam_cracklib.so retry=3
password	required	pam_unix.so md5 shadow use_authtok

AUTHOR:
        Jan Rêkorajski <baggins@mimuw.edu.pl>

