s3:docs: document "winbind max domain connections"

Autobuild-User: Michael Adam <obnox@samba.org>
Autobuild-Date: Fri Jan 21 14:33:57 CET 2011 on sn-devel-104

diff --git a/docs-xml/smbdotconf/winbind/winbindmaxdomainconnections.xml b/docs-xml/smbdotconf/winbind/winbindmaxdomainconnections.xml
new file mode 100644 (file)
index 0000000..3e48356
--- /dev/null
+++ b/docs-xml/smbdotconf/winbind/winbindmaxdomainconnections.xml
@@ -0,0 +1,24 @@
+<samba:parameter name="winbind max domain connections"
+                context="G"
+                type="integer"
+                advanced="1" developer="1"
+                xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+       <para>This parameter specifies the maximum number of simultaneous
+       connections that the <citerefentry><refentrytitle>winbindd</refentrytitle>
+       <manvolnum>8</manvolnum></citerefentry> daemon should open to the
+       domain controller of one domain.
+       Setting this parameter to a value greater than 1 can improve
+       scalability with many simultaneous winbind requests,
+       some of which might be slow.
+       </para>
+       <para>
+       Note that if <smbconfoption name="winbind offline logon"/> is set to
+       <constant>Yes</constant>, then only one
+       DC connection is allowed per domain, regardless of this setting.
+       </para>
+</description>
+
+<value type="default">1</value>
+<value type="example">10</value>
+</samba:parameter>