<samba:parameter name="check password script"
                 context="G"
                 type="string"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
    <para>The name of a program that can be used to check password
    complexity. The password is sent to the program's standard input.</para>

    <para>The program must return 0 on a good password, or any other value
    if the password is bad.
    In case the password is considered weak (the program does not return 0) the
    user will be notified and the password change will fail.</para>

    <para>In Samba AD, this script will be run <emphasis>AS ROOT</emphasis> by
    <citerefentry><refentrytitle>samba</refentrytitle> <manvolnum>8</manvolnum>
    </citerefentry> without any substitutions.</para>

    <para>Note: In the example directory is a sample program called <command moreinfo="none">crackcheck</command>
    that uses cracklib to check the password quality.</para>

</description>

<value type="default"><comment>Disabled</comment></value>
<value type="example">/usr/local/sbin/crackcheck</value>
</samba:parameter>
