NAME¶
FascistCheck - a pro-active password checker library
SYNOPSIS¶
#include <crack.h>
static char const CRACKLIB_DICTPATH[] = ...;
extern char const *
FascistCheck(char const passwd[], char const dictpath[]);
DESCRIPTION¶
cracklib is a library containing the
FascistCheck C function which may be
used in a "passwd" like program. The idea is simple: try to prevent
users from choosing passwords that could be guessed by "crack" by
filtering them out, at source. cracklib is an offshoot of the the version 5 of
the "crack" software and contains a considerable number of ideas
nicked from the new software.
The first formal argument
password is the potential password. The second
formal argument
dictpath is the full path name + filename prefix of the
cracklib dictionary database.
FascistCheck returns the NULL pointer for
a good password, or a pointer to a diagnostic string if it is a weak password.
The database is in a binary format generated by the utilities
crack_mkdict(8) and
crack_packer(8). On a Debian system the
database is located in the directory defined by the static constant
CRACKLIB_DICTPATH and is set to /var/cache/cracklib/cracklib_dict. None
of the subroutines in the cracklib libraries have this location hard-coded
into their implementations. It is generated daily with the program
/etc/cron.daily/cracklib.
FILES¶
- /var/cache/cracklib/cracklib_dict.[hwm|pwd|pwi]
- cracklib dictionary database files used by utilities.
- /etc/cron.daily/cracklib
- cracklib daily cron program to rebuild the cracklib dictionary
database.
- /etc/cracklib/cracklib.conf
- cracklib configuration file used by the cracklib daily cron program to
rebuild the cracklib dictionary database.
- /usr/sbin/crack_mkdict
- cracklib shell script to create initial list of words for dictionary
database.
- /usr/share/doc/cracklib2-dev/examples
- Example cc(1) source files that show how FascistCheck is
used.
SEE ALSO¶
crack_teststr(8),
crack_mkdict(8),
update-cracklib(8)
/usr/share/doc/cracklib2-dev/examples
/usr/share/doc/cracklib2/cracklib2.html
/usr/share/doc/cracklib2-dev/cracklib2-dev.html
AUTHOR¶
cracklib2 is written by Alec Muffett <alecm@crypto.dircon.co.uk>.
Manual added by Jean Pierre LeJacq <jplejacq@quoininc.com>.