summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/security/passwdprogram.xml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/smbdotconf/security/passwdprogram.xml')
-rw-r--r--docs/docbook/smbdotconf/security/passwdprogram.xml64
1 files changed, 34 insertions, 30 deletions
diff --git a/docs/docbook/smbdotconf/security/passwdprogram.xml b/docs/docbook/smbdotconf/security/passwdprogram.xml
index dae24e22a1..dbcc261ce4 100644
--- a/docs/docbook/smbdotconf/security/passwdprogram.xml
+++ b/docs/docbook/smbdotconf/security/passwdprogram.xml
@@ -1,35 +1,39 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="PASSWDPROGRAM"/>passwd program (G)</term>
- <listitem><para>The name of a program that can be used to set
- UNIX user passwords. Any occurrences of <parameter moreinfo="none">%u</parameter>
- will be replaced with the user name. The user name is checked for
- existence before calling the password changing program.</para>
+<samba:parameter name="passwd program"
+ context="G"
+ advanced="1" developer="1"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>The name of a program that can be used to set
+ UNIX user passwords. Any occurrences of <parameter moreinfo="none">%u</parameter>
+ will be replaced with the user name. The user name is checked for
+ existence before calling the password changing program.</para>
- <para>Also note that many passwd programs insist in <emphasis>reasonable
- </emphasis> passwords, such as a minimum length, or the inclusion
- of mixed case chars and digits. This can pose a problem as some clients
- (such as Windows for Workgroups) uppercase the password before sending
- it.</para>
+ <para>Also note that many passwd programs insist in <emphasis>reasonable
+ </emphasis> passwords, such as a minimum length, or the inclusion
+ of mixed case chars and digits. This can pose a problem as some clients
+ (such as Windows for Workgroups) uppercase the password before sending
+ it.</para>
- <para><emphasis>Note</emphasis> that if the <parameter moreinfo="none">unix
- password sync</parameter> parameter is set to <constant>yes
- </constant> then this program is called <emphasis>AS ROOT</emphasis>
- before the SMB password in the <ulink url="smbpasswd.5.html">smbpasswd(5)
- </ulink> file is changed. If this UNIX password change fails, then
- <command moreinfo="none">smbd</command> will fail to change the SMB password also
- (this is by design).</para>
+ <para><emphasis>Note</emphasis> that if the <parameter moreinfo="none">unix
+ password sync</parameter> parameter is set to <constant>yes
+ </constant> then this program is called <emphasis>AS ROOT</emphasis>
+ before the SMB password in the <ulink url="smbpasswd.5.html"><citerefentry>
+ <refentrytitle>smbpasswd</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ </ulink> file is changed. If this UNIX password change fails, then
+ <command moreinfo="none">smbd</command> will fail to change the SMB password also
+ (this is by design).</para>
- <para>If the <parameter moreinfo="none">unix password sync</parameter> parameter
- is set this parameter <emphasis>MUST USE ABSOLUTE PATHS</emphasis>
- for <emphasis>ALL</emphasis> programs called, and must be examined
- for security implications. Note that by default <parameter moreinfo="none">unix
- password sync</parameter> is set to <constant>no</constant>.</para>
+ <para>If the <parameter moreinfo="none">unix password sync</parameter> parameter
+ is set this parameter <emphasis>MUST USE ABSOLUTE PATHS</emphasis>
+ for <emphasis>ALL</emphasis> programs called, and must be examined
+ for security implications. Note that by default <parameter moreinfo="none">unix
+ password sync</parameter> is set to <constant>no</constant>.</para>
- <para>See also <link linkend="UNIXPASSWORDSYNC"><parameter moreinfo="none">unix
- password sync</parameter></link>.</para>
+ <para>See also <link linkend="UNIXPASSWORDSYNC"><parameter moreinfo="none">unix
+ password sync</parameter></link>.</para>
- <para>Default: <command moreinfo="none">passwd program = /bin/passwd</command></para>
- <para>Example: <command moreinfo="none">passwd program = /sbin/npasswd %u</command>
- </para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">passwd program = /bin/passwd</command></para>
+
+ <para>Example: <command moreinfo="none">passwd program = /sbin/npasswd %u</command></para>
+</listitem>
+</samba:parameter>