From 69bb1094f934e7c42bd3d9df0cc7f10c7b4e3c30 Mon Sep 17 00:00:00 2001
From: Casey Bodley <cbodley@citi.umich.edu>
Date: Tue, 8 May 2012 16:02:08 -0400
Subject: [PATCH] readme: added installation step for DisableDFS

Signed-off-by: Casey Bodley <cbodley@citi.umich.edu>
---
 README.html | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/README.html b/README.html
index dec6a9a..c96aa0a 100644
--- a/README.html
+++ b/README.html
@@ -29,6 +29,7 @@
 <ol>
     <li><a href="#build">Building from Source</a></li>
     <li><a href="#install">Installing Binaries</a></li>
+    <li><a href="#dfs">Disable the DFS Client</a></li>
     <li><a href="#ldap">Ldap Configuration</a></li>
     <li><a href="#startup">Starting the Client</a></li>
     <li><a href="#mount">Mounting</a></li>
@@ -91,7 +92,16 @@
     <br/><code>&gt; bcdedit /set testsigning on</code></li>
     <li>Reboot.</li>
 </ol>
-<h2>3. <a name="ldap">Ldap Configuration</a></h2>
+<h2>3. <a name="dfs">Disable the DFS Client</a></h2>
+<ul>
+  <li>The Windows DFS client interferes with some requests, indicated by long delays during operation. See <a href="http://support.microsoft.com/kb/171386">http://support.microsoft.com/kb/171386</a> for more information.</li>
+</ul>
+<h3>Instructions</h3>
+<ol>
+    <li>Open <strong>regedit.exe</strong> and navigate to <code>HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Mup</code>.</li>
+    <li>Add a DWORD value named <code>DisableDfs</code> with a value of 1.</li>
+</ol>
+<h2>4. <a name="ldap">Ldap Configuration</a></h2>
 <h3>Requirements:</h3>
 <ul>
     <li><strong>C:\etc\ms-nfs41-idmap.conf</strong> from <a href="#install">Installation</a> step 7.</li>
@@ -101,7 +111,7 @@
     <li>Open <strong>C:\etc\ms-nfs41-idmap.conf</strong> in a text editor.</li>
     <li>Uncomment the <code>ldap_hostname</code> and <code>ldap_base</code> lines, and configure as appropriate to match your ldap server configuration (we'll add suggestions later).</li>
 </ol>
-<h2>4. <a name="startup">Starting the Client</a></h2>
+<h2>5. <a name="startup">Starting the Client</a></h2>
 <ul>
     <li>If you've installed the binary distribution, you'll find two versions of the nfs client daemon: <strong>nfsd.exe</strong> and <strong>nfsd_debug.exe</strong>. <strong>nfsd.exe</strong> is built to run as a service, and does not provide easy access to debug output. We strongly recommend trying <strong>nfsd_debug.exe</strong> first (using the Instructions below) to verify that you can start the daemon and mount/unmount an nfs share. You can then close <strong>nfsd_debug.exe</strong> and start running <strong>nfsd.exe</strong> as a service with:<br /><code>&gt nfsd.exe -install</code>.</li>
 </ul>
@@ -116,7 +126,7 @@
         <li><code>--uid, --gid</code> changes the default uid/gid when no mapping is available (must be nonzero)</li>
     </ul></li>
 </ol>
-<h2>5. <a name="mount">Mounting</a></h2>
+<h2>6. <a name="mount">Mounting</a></h2>
 <h3>Instructions</h3>
 <ol>
     <li>From a Windows command prompt run <strong>nfs_mount.exe</strong> to mount a share:
@@ -126,7 +136,7 @@
     <li>You can later unmount with:
     <br/><code>&gt; nfs_mount.exe -d Z</code></li>
 </ol>
-<h2>6. <a name="cthon">Connectathon</a></h2>
+<h2>7. <a name="cthon">Connectathon</a></h2>
 <h3>Requirements</h3>
 <ul>
     <li><a href="http://www.cygwin.com" title="www.cygwin.com">Cygwin</a>, including packages gcc-core, make, time, tirpc, git</li>
@@ -148,14 +158,13 @@
     <li>Run the test suite on a mounted directory:
     <br/><code>&gt; ./runtests -a -t z:/testdir</code></li>
 </ol>
-<h2>7. <a name="issues">Known Issues</a></h2>
+<h2>8. <a name="issues">Known Issues</a></h2>
 <ul>
     <li>krb5p security with AES keys do not work against the linux server, as it does not support gss krb5 v2 tokens with rotated data.</li>
     <li>When recovering opens and locks outside of the server's grace period, client does not check whether the file has been modified by another client.</li>
     <li>If nfsd.exe is restarted while a drive is mapped, that drive needs to be remounted before further use.</li>
     <li>Symbolic links are not supported in Cygwin. Connectathon's basic test8 and special test nfsidem have been commented out.</li>
     <li>Does not allow renaming a file on top of an existing open file. Connectathon's special test op_ren has been commented out.</li>
-    <li>The Windows DFS client interferes with some requests, indicated by long delays during operation. To disable the DFS client, use regedit.exe to navigate to HKLM\System\CurrentControlSet\Services\Mup, and add a REG_DWORD entry named 'DisableDfs' with a value of 1. See <a href="http://support.microsoft.com/kb/171386">http://support.microsoft.com/kb/171386</a> for more information.</li>
     <li>Extended attributes are supported with some limitations: a) the server must support <a href="https://tools.ietf.org/html/rfc5661#section-5.3" title="RFC 5661: 5.3. Named Attributes">NFS Named Attributes</a>, b) the order of listings cannot be guaranteed by NFS, and c) the EaSize field cannot be reported for directory queries of FileBothDirInformation, FileFullDirInfo, or FileIdFullDirInfo.</li>
 </ul>
 <p>Please direct any questions to <a href="mailto:ms-nfs41-client-devel@lists.sourceforge.net">ms-nfs41-client-devel@lists.sourceforge.net</a>.</p>