php-doc-en/reference/crack/reference.xml
Gabor Hojtsy c945fc03ab Fix abbreviated title
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@124647 c90b9560-bf6c-de11-be94-00142212c4b1
2003-04-25 20:08:35 +00:00

100 lines
2.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<reference id="ref.crack">
<title>Crack functions</title>
<titleabbrev>Crack</titleabbrev>
<partintro>
<section id="crack.intro">
&reftitle.intro;
<para>
These functions allow you to use the CrackLib library to test the
'strength' of a password. The 'strength' of a password is tested by that
checks length, use of upper and lower case and checked against the
specified CrackLib dictionary. CrackLib will also give helpful diagnostic
messages that will help 'strengthen' the password.
</para>
</section>
<section id="crack.requirements">
&reftitle.required;
<para>
More information regarding CrackLib along with the library can be found at
<ulink url="&url.crack;">&url.crack;</ulink>.
</para>
</section>
&reference.crack.configure;
&reference.crack.ini;
<section id="crack.resources">
&reftitle.resources;
&no.resource;
</section>
<section id="crack.constants">
&reftitle.constants;
&no.constants;
</section>
<section id="crack.examples">
&reftitle.examples;
<para>
This example shows how to open a CrackLib dictionary, test a given
password, retrieve any diagnostic messages, and close the dictionary.
<example>
<title>CrackLib example</title>
<programlisting role="php">
<![CDATA[
<?php
// Open CrackLib Dictionary
$dictionary = crack_opendict('/usr/local/lib/pw_dict')
or die('Unable to open CrackLib dictionary');
// Perform password check
$check = crack_check($dictionary, 'gx9A2s0x');
// Retrieve messages
$diag = crack_getlastmessage();
echo $diag; // 'strong password'
// Close dictionary
crack_closedict($dictionary);
?>
]]>
</programlisting>
</example>
</para>
<note>
<para>
If <function>crack_check</function> returns &true;,
<function>crack_getlastmessage</function> will return 'strong password'.
</para>
</note>
</section>
</partintro>
&reference.crack.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->