php man page for crack_check

CRACK_CHECK(3)								 1							    CRACK_CHECK(3)

crack_check - Performs an obscure check with the given password

SYNOPSIS
       bool crack_check (resource  $dictionary, string	$password)

DESCRIPTION
       bool crack_check NULL (string  $password, string  $username = "", string  $gecos = "", resource	$dictionary)

	Performs an obscure check with the given password on the specified dictionary. The alternative signature also takes into account the user-
       name and the GECOS information.

       Warning

	      This function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice	in
	      a future release of PHP. This function should be used at your own risk.

PARAMETERS
	      o $dictionary
		- The crack lib dictionary. If not specified, the last opened dictionary is used.

	      o $password
		- The password to be checked.

	      o $username
		- The username of the account with the password.

	      o $gecos
		- The GECOS information associated with the user account.

RETURN VALUES
	Returns TRUE if $password is strong, or FALSE otherwise.

CHANGELOG
       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       |  0.3	|						    |
       |	|						    |
       |	|  The $username, $gecos and $dictionary parameters |
       |	| were added to the alternative signature.	    |
       |	|						    |
       +--------+---------------------------------------------------+
PHP Documentation Group 													    CRACK_CHECK(3)