1FascistCheck(3)             Debian GNU/Linux manual            FascistCheck(3)
2
3
4

NAME

6       FascistCheck - a pro-active password checker library
7

SYNOPSIS

9       #include <crack.h>
10
11       static char const CRACKLIB_DICTPATH[] =  ...;
12
13       extern char const *
14       FascistCheck(char const passwd[], char const dictpath[]);
15

DESCRIPTION

17       cracklib  is a library containing the FascistCheck C function which may
18       be used in a "passwd" like program.  The idea is simple: try to prevent
19       users  from choosing passwords that could be guessed by "crack" by fil‐
20       tering them out, at source.  cracklib is an offshoot of the the version
21       5  of  the "crack" software and contains a considerable number of ideas
22       nicked from the new software.
23
24       The first formal argument password is the potential password.  The sec‐
25       ond formal argument dictpath is the full path name + filename prefix of
26       the  cracklib  dictionary  database.   FascistCheck  returns  the  NULL
27       pointer  for a good password, or a pointer to a diagnostic string if it
28       is a weak password.
29
30       The  database  is  in  a  binary  format  generated  by  the  utilities
31       crack_mkdict(8)  and  crack_packer(8).  On a Debian system the database
32       is located in the directory  defined  by  the  static  constant  CRACK‐
33       LIB_DICTPATH  and is set to /var/cache/cracklib/cracklib_dict.  None of
34       the subroutines in the cracklib libraries have this location hard-coded
35       into  their  implementations.   It  is generated daily with the program
36       /etc/cron.daily/cracklib.
37

FILES

39       /var/cache/cracklib/cracklib_dict.[hwm|pwd|pwi]
40              cracklib dictionary database files used by utilities.
41
42       /etc/cron.daily/cracklib
43              cracklib daily cron program to rebuild the  cracklib  dictionary
44              database.
45
46       /etc/cracklib/cracklib.conf
47              cracklib configuration file used by the cracklib daily cron pro‐
48              gram to rebuild the cracklib dictionary database.
49
50       /usr/sbin/crack_mkdict
51              cracklib shell script to create initial list of words  for  dic‐
52              tionary database.
53
54       /usr/share/doc/cracklib2-dev/examples
55              Example cc(1) source files that show how FascistCheck is used.
56

SEE ALSO

58       crack_teststr(8), crack_mkdict(8), update-cracklib(8)
59       /usr/share/doc/cracklib2-dev/examples
60       /usr/share/doc/cracklib2/cracklib2.html
61       /usr/share/doc/cracklib2-dev/cracklib2-dev.html
62

AUTHOR

64       cracklib2  is written by Alec Muffett <alecm@crypto.dircon.co.uk>. Man‐
65       ual added by Jean Pierre LeJacq <jplejacq@quoininc.com>.
66
67
68
692.7-8.5                 Wed, 3 Oct 2001 01:37:09 +0100         FascistCheck(3)
Impressum