docs/docbook/smbdotconf/security/passwdchatdebug.xml

   1 <samba:parameter name="passwd chat debug"
   2                  context="G"
   3                  advanced="1" developer="1"
   4                  xmlns:samba="http://samba.org/common">
   5 <listitem>
   6     <para>This boolean specifies if the passwd chat script
   7     parameter is run in <emphasis>debug</emphasis> mode. In this mode the
   8     strings passed to and received from the passwd chat are printed
   9     in the <citerefentry><refentrytitle>smbd</refentrytitle>
  10     <manvolnum>8</manvolnum></citerefentry> log with a
  11     <link linkend="DEBUGLEVEL"><parameter moreinfo="none">debug level</parameter></link>
  12     of 100. This is a dangerous option as it will allow plaintext passwords
  13     to be seen in the <command moreinfo="none">smbd</command> log. It is available to help
  14     Samba admins debug their <parameter moreinfo="none">passwd chat</parameter> scripts
  15     when calling the <parameter moreinfo="none">passwd program</parameter> and should
  16     be turned off after this has been done. This option has no effect if the
  17     <link linkend="PAMPASSWORDCHANGE"><parameter moreinfo="none">pam password change</parameter></link>
  18     paramter is set. This parameter is off by default.</para>
  19
  20     <para>See also <link linkend="PASSWDCHAT"><parameter moreinfo="none">passwd chat</parameter>
  21     </link>, <link linkend="PAMPASSWORDCHANGE"><parameter moreinfo="none">pam password change</parameter>
  22     </link>, <link linkend="PASSWDPROGRAM"><parameter moreinfo="none">passwd program</parameter>
  23     </link>.</para>
  24
  25     <para>Default: <command moreinfo="none">passwd chat debug = no</command></para>
  26 </listitem>
  27 </samba:parameter>