---
name: "crack_teststr"
section: "8"
platform: "linux"
package: "cracklib-runtime"
version: "2.7-19"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/crack_teststr"
---

# crack\_teststr(8)

cracklib test utilities

## NAME

crack\_testlib, crack\_testnum, crack\_teststr - cracklib test utilities

## SYNOPSIS

**crack\_testlib**

**crack\_testnum**

**crack\_teststr**

## DESCRIPTION

**crack\_testlib** tests if the input string will be accepted as a valid password by the installed cracklib dictionary using the [**FascistCheck**(3)](/FascistCheck/3.md) subroutine. **crack\_testnum** tests if the input integer is an index to a word in the installed cracklib dictionary and returns the word if found. **crack\_teststr** tests if the input string is in the installed cracklib dictionary and  returns its index number if found.

The database is in a binary format generated by the utilities [**crack\_mkdict**(8)](/crack_mkdict/8.md) and [**crack\_packer**(8)](/crack_packer/8.md). On a Debian system the database is located in the directory /var/cache/cracklib/cracklib\_dict and is generated daily with the program **update-cracklib** (8), which is called from the cron job **/etc/cron.daily/cracklib** . The location is also defined in the header file **crack.h** using the constant **CRACKLIB\_DICTPATH** though none of the subroutines in the cracklib libraries have this location hardcoded into their implementations.

Each take one string or number per line.  Enter ^C when done.

## 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/include/crack.h*

  cracklib header file defining the subroutine [**FascistCheck**(3)](/FascistCheck/3.md) and the constant **CRACKLIB\_DICTPATH** used to compile in the location of the cracklib dictionary database for these utilities.

## SEE ALSO

[**crack\_mkdict**(8)](/crack_mkdict/8.md), [**FascistCheck**(3)](/FascistCheck/3.md)\
 /usr/share/doc/cracklib2/cracklib2.html\
 /usr/share/doc/cracklib-runtime/cracklib-runtime.html

## AUTHOR

**cracklib2** is written by Alec Muffett \<alecm@crypto.dircon.co.uk\>. Manual added by Jean Pierre LeJacq \<jplejacq@quoininc.com\>.