docs-xml/smbdotconf/security/passwdprogram.xml

   1 <samba:parameter name="passwd program"
   2                  context="G"
   3                                  type="string"
   4                  advanced="1" developer="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6  <description>
   7     <para>The name of a program that can be used to set
   8     UNIX user passwords.  Any occurrences of <parameter moreinfo="none">%u</parameter>
   9     will be replaced with the user name. The user name is checked for
  10     existence before calling the password changing program.</para>
  11
  12     <para>Also note that many passwd programs insist in <emphasis>reasonable
  13     </emphasis> passwords, such as a minimum length, or the inclusion
  14     of mixed case chars and digits. This can pose a problem as some clients
  15     (such as Windows for Workgroups) uppercase the password before sending
  16     it.</para>
  17
  18     <para><emphasis>Note</emphasis> that if the <parameter moreinfo="none">unix
  19     password sync</parameter> parameter is set to <constant>yes
  20     </constant> then this program is called <emphasis>AS ROOT</emphasis>
  21     before the SMB password in the smbpasswd
  22     file is changed. If this UNIX password change fails, then
  23     <command moreinfo="none">smbd</command> will fail to change the SMB password also
  24     (this is by design).</para>
  25
  26     <para>If the <parameter moreinfo="none">unix password sync</parameter> parameter
  27     is set this parameter <emphasis>MUST USE ABSOLUTE PATHS</emphasis>
  28     for <emphasis>ALL</emphasis> programs called, and must be examined
  29     for security implications. Note that by default <parameter moreinfo="none">unix
  30     password sync</parameter> is set to <constant>no</constant>.</para>
  31         </description>
  32
  33         <related>unix password symc</related>
  34
  35         <value type="default"></value>
  36 <value type="example">/bin/passwd %u</value>
  37 </samba:parameter>