FreeBSD Manual Pages
CRACKLIB(3) Library Functions Manual CRACKLIB(3) NAME FascistCheck - check a potential password for guessability LIBRARY Cracklib (libcrack, -lcrack) SYNOPSIS #include <packer.h> char *FascistCheck(char *pw, char *dictpath) DESCRIPTION CrackLib is a library containing a C function which may be used in a passwd(1)-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. FascistCheck() takes two arguments: pw a string containing the user's chosen "potential password" dictpath the full path name of the CrackLib dictionary, without the suffix CrackLib is an offshoot of the the version 5 Crack software, and con- tains a considerable number of ideas nicked from the new software. CrackLib makes literally hundreds of tests to determine whether you've chosen a bad password. • It tries to generate words from your username and gecos entry to try to match them against what you've chosen. • It checks for simplistic patterns. • It then tries to reverse-engineer your password into a dic- tionary word, and searches for it in your dictionary. After all that, it's probably a safe(-ish) password. RETURN VALUE FascistCheck() returns the NULL pointer for a good password or a pointer to a diagnostic string if it is a bad password. BUGS It can't catch everything. Just most things. It calls getpwuid(getuid()) to look up the user, which may affect poorly written programs. Using more than one dictionary file, e.g.: char *msg; if (msg = FascistCheck(pw, "onepath") || msg = FascistCheck(pw, "anotherpath")) { printf("Bad Password: because %s\n", msg); } works, but it's a kludge. Avoid it if possible. Using just the one dictionary is more efficient, anyway. PWOpen() routines should cope with having more than one dictionary open at a time. SEE ALSO passwd(1), getpwuid(3), CRACKLIB(3)
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | BUGS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=FascistCheck&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>