diff --git a/README.html b/README.html
index a08e01f..758d35d 100644
--- a/README.html
+++ b/README.html
@@ -29,6 +29,8 @@
- Building
- Installation
+ - Ldap Configuration
+ - Starting the Client
- Mounting
- Connectation
- Known Issues
@@ -38,31 +40,31 @@
Requirements
- Windows Vista x64, Windows Server 2008 R2 x64, or Windows 7 x64. (Windows XP and previous versions are not supported. 32-bit builds have not been tested.)
- - Windows Driver Development Kit (WinDDK 6000 or later)
- Microsoft Visual Studio 2010
+ - Windows Driver Development Kit (WinDDK 6000 or later)
- ms-nfs41-client source code:
> git clone git://citi.umich.edu/projects/ms-nfs41-client.git
-Building the userspace daemon
-- WinDDK does not include the ldap library, so we build the nfs client daemon with Microsoft Visual Studio 2010.
+Building the rpc library and nfs client daemon
+- WinDDK does not include the ldap library, so we build the rpc library and nfs client daemon with Visual Studio 2010.
- Open Windows Explorer and navigate to ms-nfs41-client\build.vc10.
- Make a copy of env.props.example, and rename it to env.props.
- Open env.props in a text editor, and verify that the value in
<WDKPATH>C:\WinDDK\7600.16385.0</WDKPATH> points to your WinDDK installation.
- Open the solution file ms-nfs41-client.sln in Visual Studio 2010.
- - Select the x64 platform and desired configuration (Debug or Release).
- - Right-click on the daemon project and select Build. The project and its dependencies should build without errors. Binaries can be found under build.vc10\x64\(Configuration)\.
+ - Select the Debug configuration and x64 platform (accessible via Build->Configuration Manager).
+ - Right-click on the daemon project and select Build. The project and its dependencies should build without errors. The resulting binaries, nfsd.exe and libtirpc.dll, can be found under ms-nfs41-client\build.vc10\x64\Debug\.
-Building the driver
+Building the driver and utilities
- From the Start menu, open the WinDDK 'x64 Checked Build Environment' for the target platform.
- - Change directory to ms-nfs41-client and type
build. The project should build without errors.
+ - Change directory to ms-nfs41-client and type
build. All projects should build without errors.
Requirements
- ms-nfs41-client binaries: nfs41_driver.sys, nfs41_np.dll, libtirpc.dll, nfs_install.exe, nfsd.exe, nfs_mount.exe
- - ms-nfs41-client configuration files: nfs41rdr.inf, install.bat, uninstall.bat, etc_netconfig
+ - ms-nfs41-client configuration files: nfs41rdr.inf, install.bat, uninstall.bat, etc_netconfig, ms-nfs41-idmap.conf
Instructions
@@ -76,23 +78,44 @@
> certmgr /add /c nfs41_test.cer /s /r localMachine root
- Install the driver and update the registry:
> install.bat
- - Copy the libtirpc configuration:
+
- Copy configuration files:
> mkdir C:\etc
-
> copy etc_netconfig C:\etc\netconfig
+
> copy etc_netconfig C:\etc\netconfig
+
> copy ms-nfs41-idmap.conf C:\etc\
- Allow windows to load test-signed drivers:
> bcdedit /set testsigning on
- Reboot.
-
+
+Requirements:
+
Instructions
- - From a Windows command prompt, run nfsd.exe.
- - Open a new Windows command prompt and run nfs_mount.exe to mount a share:
-
> nfs_mount.exe Z: nfs.citi.umich.edu:\
+ - Open C:\etc\ms-nfs41-idmap.conf in a text editor.
+ - Uncomment the
ldap_hostname and ldap_base lines, and configure as appropriate to match your ldap server configuration (we'll add suggestions later).
+
+
+Instructions
+
+ - From a Windows command prompt, run nfsd.exe to start the nfs client daemon. Leave this running in the background until all mapped drives are unmounted.
+
Usage:
+
> nfsd.exe -d <debug level> [--noldap]
+
+ <debug level> determines the log verbosity (1, 2, 3 or 0 to disable)
+ --noldap disables id mapping and uses a default uid=666 and gid=777
+
+
+
+Instructions
+
+ - From a Windows command prompt run nfs_mount.exe to mount a share:
+
> nfs_mount.exe Z: <server_name>:\
- You can later unmount with:
> nfs_mount.exe -d Z
-
+
Requirements
- Cygwin, including packages gcc-core, make, time, tirpc, git
@@ -114,9 +137,10 @@
- Run the test suite on a mounted directory:
> ./runtests -a -t z:/testdir
-
+
- - AUTH_SYS is not fully implemented, and uses a fake uid=666 and gid=777. Keep this in mind when setting up exports.
+ - AUTH_SYS does not handle multiple users, so all operations are sent as the user that established the mount.
+ - 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.
- When nfs_mount.exe is run without arguments, it does not properly list mounted drives.
- If nfsd.exe is restarted while a drive is mapped, that drive needs to be remounted before further use.
- Symbolic links are not supported in Cygwin. Connectathon's basic test8 and special test nfsidem have been commented out.