From 5c4f9e789f412024dba125999c283fe49d2118d3 Mon Sep 17 00:00:00 2001 From: Casey Bodley Date: Wed, 20 Oct 2010 14:54:14 -0400 Subject: [PATCH] readme: formatting changes use instead of and instead of Signed-off-by: Casey Bodley --- README.html | 56 ++++++++++++++++++++++++++--------------------------- 1 file changed, 27 insertions(+), 29 deletions(-) diff --git a/README.html b/README.html index a1da14a..7f6da88 100644 --- a/README.html +++ b/README.html @@ -18,8 +18,6 @@ h1 { font-size: 2em; text-align: center; background: none; } h2 { margin: 24px 0 8px 0; font-variant: small-caps; border-bottom: 1px dashed #88A; } h3 { margin-left: 8px; } - span.filename { font-weight: bold; } - span.code { font-family: Courier; } /*]]>*/ @@ -40,70 +38,70 @@

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.)
    • -
  • ms-nfs41-client source code: -
    > git clone git://citi.umich.edu/projects/ms-nfs41-client.git
  • Windows Driver Development Kit (WinDDK 6000 or later)
    • +
  • ms-nfs41-client source code: +
    > git clone git://citi.umich.edu/projects/ms-nfs41-client.git

Instructions

    -
  1. Open the WinDDK 'x64 Checked Build Environment' for the target platform.
    2. -
  2. Change directory to ms-nfs41-client and type build. The project should build without errors.
    3. +
  3. From the Start menu, open the WinDDK 'x64 Checked Build Environment' for the target platform.
    4. +
  4. Change directory to ms-nfs41-client and type build. The project should build without errors.

2. Installation

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 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

Instructions

  1. Copy or extract all ms-nfs41-client binaries and configuration files into a directory that's convenient for testing.
  2. Open a WinDDK 'x64 Checked Build Environment' as Administrator in this directory (right click and 'Run as administrator').
  3. Create a certificate for test-signing the driver (Creating Test Certificates): -
    > makecert /pe /ss PrivateCertStore /n CN=nfs41_test nfs41_test.cer
    4. -
  4. Use the certificate to sign nfs41_driver.sys (Test-Signing a Driver File): -
    > signtool sign /v /s PrivateCertStore /n nfs41_test /t http://timestamp.verisign.com/scripts/timestamp.dll nfs41_driver.sys
    5. +
    > makecert /pe /ss PrivateCertStore /n CN=nfs41_test nfs41_test.cer +
  5. Use the certificate to sign nfs41_driver.sys (Test-Signing a Driver File): +
    > signtool sign /v /s PrivateCertStore /n nfs41_test /t http://timestamp.verisign.com/scripts/timestamp.dll nfs41_driver.sys
  6. Install the certificate to the 'Trusted Root Certificate Authorities' store: -
    > certmgr /add /c nfs41_test.cer /s /r localMachine root
    7. +
    > certmgr /add /c nfs41_test.cer /s /r localMachine root
  7. Install the driver and update the registry: -
    > install.bat
    8. +
    > install.bat
  8. Copy the libtirpc configuration: -
    > mkdir C:\etc -
    > copy etc_netconfig C:\etc\netconfig
    9. +
    > mkdir C:\etc +
    > copy etc_netconfig C:\etc\netconfig
  9. Allow windows to load test-signed drivers: -
    > bcdedit /set testsigning on
    10. +
    > bcdedit /set testsigning on
  10. Reboot.

3. Mounting

Instructions

    -
  1. From a Windows command prompt, run nfsd.exe.
    2. -
  2. Open a new Windows command prompt and run nfs_mount.exe to mount a share: -
    > nfs_mount.exe Z: nfs.citi.umich.edu:\
    3. +
  3. From a Windows command prompt, run nfsd.exe.
    4. +
  4. Open a new Windows command prompt and run nfs_mount.exe to mount a share: +
    > nfs_mount.exe Z: nfs.citi.umich.edu:\
  5. You can later unmount with: -
    > nfs_mount.exe -d Z
    6. +
    > nfs_mount.exe -d Z

4. Connectathon

Requirements

  • Cygwin, including packages gcc-core, make, time, tirpc, git
  • Connectathon Test Suite
    • -
  • ms-nfs41-client source code (patches for connectathon are located in ms-nfs41-client\tests)
    • +
  • ms-nfs41-client source code (patches for connectathon are located in ms-nfs41-client\tests)

Instructions

    -
  1. Extract nfstests.zip into a directory that's convenient for testing (i.e. cthon04).
    2. -
  2. Open a Cygwin shell, and change directory to cthon04.
    3. +
  3. Extract nfstests.zip into a directory that's convenient for testing (i.e. cthon04).
    4. +
  4. Open a Cygwin shell, and change directory to cthon04.
  5. Create a git repository to track changes: -
    > git init -
    > git add * -
    > git commit -m "files from nfstests.zip"
    6. +
    > git init +
    > git add * +
    > git commit -m "files from nfstests.zip"
  6. Apply all cthon patches: -
    > git am /path/to/ms-nfs41-client/tests/*.patch
    7. +
    > git am /path/to/ms-nfs41-client/tests/*.patch
  7. Build the tests: -
    > make
    8. +
    > make
  8. Run the test suite on a mounted directory: -
    > ./runtests -a -t z:/testdir
    9. +
    > ./runtests -a -t z:/testdir

5. Known Issues