MKDICT(1)

NAME
mkdict, packer, unpacker - cracklib dictionary utilities

SYNOPSIS
mkdict file... packer cracklib_dictpath unpacker cracklib_dictpath

DESCRIPTION
mkdict takes a list of text files each containing a list of words, one per line, It lowercases all words, removes control characters, and sorts the lists. It outputs the cleaned up list to standard output. The text files may be optionally compressed with gzip(1). If you supply massive amounts of text to mkdict you must have enough free space available for use by the sort(1) command. If you do not have 20Mb free in /var/tmp (or whatever temporary area your sort(1) command uses), have a look at the @PREFIX@/bin/mkdict program which is a sh(1) program. You can usually tweak the sort(1) command to use any large area of disk you desire, by use of the -T option. mkdict has a hook for this. packer reads from standard input a list of sorted and cleaned words and creates a database in the directory and prefix given by the command line argument cracklib_dictpath. Three files are created with the suffixes of .hwm, .pwd, and .pwi. These three files are in the format that the FascistCheck(3) subroutine and unpacker, testlib(1), testnum(1), and teststr(1) utilities understand. The number of words read and written are printed on stdout(3). unpacker reads from the database in the directory and prefix given by the command line argument cracklib_dictpath and outputs on standard output the list of words that make up the database. The database is in a binary format generated by the utilities mkdict(1) and packer(1). The database is located in the directory @PREFIX@/lib/cracklib.

FILES

@PREFIX@/lib/cracklib/pw_dict.[hwm|pwd|pwi]
    cracklib dictionary database files used by utilities.

@PREFIX@/include/packer.h
    cracklib header file defining the subroutine FascistCheck(3) and necessary constants.

@PREFIX@/bin/mkdict
    cracklib shell script to create initial list of words for dictionary database.

SEE ALSO
teststr(1), cracklib(3)

AUTHOR
CrackLib is written by Alec Muffett <alecm@crypto.dircon.co.uk>.