Document "reset on zero vc"

diff --git a/docs/smbdotconf/misc/resetonzerovc.xml b/docs/smbdotconf/misc/resetonzerovc.xml
new file mode 100644 (file)
index 0000000..dd63a4f
--- /dev/null
+++ b/docs/smbdotconf/misc/resetonzerovc.xml
@@ -0,0 +1,28 @@
+<samba:parameter name="reset on zero vc"
+                context="S"
+                type="boolean"
+                advanced="1" developer="0"
+                xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+       <para>
+       This boolean option controls whether an incoming session setup
+       should kill other connections coming from the same IP. This matches
+        the default Windows 2003 behaviour.
+
+       Setting this parameter to yes becomes necessary when you have a flaky
+       network and windows decides to reconnect while the old connection
+       still has files with share modes open. These files become inaccessible
+       over the new connection.
+
+       The client sends a zero VC on the new connection, and Windows 2003
+       kills all other connections coming from the same IP. This way the
+       locked files are accessible again.
+
+       Please be aware that enabling this option will kill connections behind
+       a masquerading router.
+
+       </para>
+</description>
+
+<value type="default">no</value>
+</samba:parameter>