From 36671b6dbca8bd709725555512673ef1a9c84e29 Mon Sep 17 00:00:00 2001 From: stansmith Date: Sat, 8 Sep 2007 18:10:14 +0000 Subject: [PATCH] [DAT/DAPL] document DAT build environment. Document DAPLtest scripts: dt-svr.bat & dt-cli.bat git-svn-id: svn://openib.tc.cornell.edu/gen1@794 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86 --- trunk/docs/Manual.htm | 64 +++++++++++++++++++++++++++++++++---------- 1 file changed, 49 insertions(+), 15 deletions(-) diff --git a/trunk/docs/Manual.htm b/trunk/docs/Manual.htm index b310d8a8..3f58fe83 100644 --- a/trunk/docs/Manual.htm +++ b/trunk/docs/Manual.htm @@ -13,9 +13,9 @@ div.Section1

Windows OpenFabrics

User's Manual

-

Release 1.0

+

Release 1.0.1

-08/14/2007

+09/07/2007

Overview

The Windows OpenFabrics (WinOF) package is composed of software modules intended @@ -132,6 +132,9 @@ Display HCA attributes, statistics and error counters.
 

  • DAPLtest Examples

    • +
  • +

    DAT Application Build
    + 

  • SRP - SCSI RDMA Protocol

    • @@ -1141,7 +1144,7 @@ IPoIB.

     

    -

    DAT EXECUTION ENVIRONMENT:

    +

    DAT ENVIRONMENT:

    In order for DAT/uDAPL @@ -1167,14 +1170,35 @@ IPoIB.

    all backslashes in the library path must be duplicated when enclosed in double-quotes (e.g., "C:\\Programs Files\\WinOF\\dapl.dll").

    -

    A sample dat.conf file is - installed as '\Program Files\WinOF\dat.conf '.
    - After the WinOF installation, move the \Program Files\WinOF\dat.conf file to - the default DAT configuration file location - '%SystemDrive%\DAT\dat.conf'.

    -

    In order to preserve existing installations, - the dat.conf file is not automatically installed in it's default location.

    -

     

    +

    A sample InfiniBand dat.conf file is + installed as '\Program Files\WinOF\dat.conf '.  If dat.conf does not + exist in the DAT default configuration folder '%SystemDrive%\DAT\', dat.conf + will be copied there.

    +

    +DAT application build environment:

    +

    DAT library header files + are selectively installed in the DAT default configuration folder as
    '%SystemDrive%\DAT\v1-1' + or + '%SystemDrive%\DAT\v2-0'. Your C language based DAT 1.1 application compilation command line + should include'/I%SystemDrive%\DAT\v1-1' with C code referencing '#include <DAT\dat.h>'.
    +
    + Visual Studio 2005 command window - (nmake) Makefile Fragments:

    +
    +

    DAT_PATH=%SystemDrive%\DAT\v1-1
    + CC = cl
    + INC_FLAGS = /I $(DAT_PATH)
    +
    + CC_FLAGS= /nologo /Gy /W3 /Gm- /GR- /GF /O2 /Oi /Oy- /D_CRT_SECURE_NO_WARNINGS + \
    +            /D_WIN64 + /D_X64_ /D_AMD64_ $(INC_FLAGS)
    +
    + LINK = link
    + LIBS = ws2_32.lib advapi32.lib User32.lib bufferoverflowU.lib dat.lib
    +
    + LINK_FLAGS = /nologo /subsystem:console /machine:X64 + /libpath:$(DAT_PATH) $(LIBS)
     

    +

    DAT library environment variables:
     

    @@ -1187,8 +1211,8 @@ default location, 'C:\DAT\dat.conf'. Example: set DAT_OVERRIDE=%SystemDrive%\path\to\my\private.conf -DAT_DBG_TYPE ------------- +DAT_DBG_LEVEL +------------- Value specifies which parts of the registry will print debugging information, valid values are @@ -1204,7 +1228,7 @@ DAT_OS_DBG_TYPE_ALL = 0xff or any combination of these. For example you can use 0xC to get both static and dynamic registry output. -Example set DAT_DBG_TYPE=0xC +Example set DAT_DBG_LEVEL=0xC DAT_DBG_DEST ------------ @@ -1545,7 +1569,17 @@ USAGE - Limit test client with two thread using four EPs each, sending a more complicated buffer pattern for a larger number of iterations, - validating the data received. + validating the data received. +
    +dt-svr.bat - DAPLtest server script; starts a DAPLtest server on the local node.
+	dt-svr [-D [hex-debug-bitmask] ]
    +
    +dt-cli.bat - DAPLtest client; drives testing by interacting with dt-svr.bat script.
+	dt-cli host-IPv4-address testname
+		example: dt-cli 10.10.2.20 trans
+		         dt-cli -h  # outputs help text.
    +
    +Verify dt-*.bat script is running same dapltest.exe(v1.1) or dapl2test.exe(v2.0)
 
 
 BUGS  (and  To Do List)
-- 
2.41.0