| 1 |
[10-17-07] Last update. |
| 2 |
|
| 3 |
========== |
| 4 |
BUILD: |
| 5 |
========== |
| 6 |
|
| 7 |
The default build includes both debug(checked) & non-debug (free) version of |
| 8 |
dat2d.dll and dapl2d.dll uDAPL provider, free versions are dat2.dll & dapl2.dll. |
| 9 |
Included in the build are test suites dtest (simple DAT example), dtestx |
| 10 |
(DAT IB extensions test) and the main DAT/uDAPL tester dapl2test (see dt-svr & |
| 11 |
dt-cli, see manual.htm for details). |
| 12 |
Additionally, DAT v1.1 and/or DAT v2.0 build environments can be installed; see |
| 13 |
manual.htm for details. |
| 14 |
|
| 15 |
Building a free/non-debug version: |
| 16 |
---------------------------------- |
| 17 |
Requires Windows Server 2003 DDK & Platform SDK. |
| 18 |
From a DDK command window (free build) for a specific architecture |
| 19 |
(x86, x64, ia64); |
| 20 |
|
| 21 |
cd gen1\trunk\ulp\dapl2 |
| 22 |
build -wg |
| 23 |
Binaries are located in gen1\bin\{kernel|user}\os-arch-folder\... |
| 24 |
|
| 25 |
Building debug version: |
| 26 |
----------------------- |
| 27 |
Same as above except the DDK command window is for a Checked build |
| 28 |
|
| 29 |
|
| 30 |
Installing: |
| 31 |
----------- |
| 32 |
|
| 33 |
dat2.dll & dapl.dll --> %SystemRoot% |
| 34 |
|
| 35 |
=================== |
| 36 |
CONFIGURATION: |
| 37 |
=================== |
| 38 |
|
| 39 |
sample C:\dat\dat.conf |
| 40 |
|
| 41 |
# |
| 42 |
# DAT 1.2 configuration file, |
| 43 |
# |
| 44 |
# Each entry should have the following fields: |
| 45 |
# |
| 46 |
# <ia_name> <api_version> <threadsafety> <default> <lib_path> \ |
| 47 |
# <provider_version> <ia_params> <platform_params> |
| 48 |
# |
| 49 |
# For openib-cma provider you can specify <ia_params> as either: |
| 50 |
# network address, network hostname, or netdev name and 0 for port |
| 51 |
# |
| 52 |
# |
| 53 |
ibnic0v2 u2.0 nonthreadsafe default C:\Windows\dapl2.dll ri.2.0 "IbalHca0 1" "" |
| 54 |
|
| 55 |
|
| 56 |
============================= |
| 57 |
Bugs/Known issues |
| 58 |
============================= |
| 59 |
|
| 60 |
|
| 61 |
|
| 62 |
============================= |
| 63 |
4.0 SAMPLE uDAPL APPLICATION: |
| 64 |
============================= |
| 65 |
|
| 66 |
There are 2 sample programs provided with this package. |
| 67 |
|
| 68 |
(dapl2/test/dtest/) |
| 69 |
(dapl2/test/dtestx/) |
| 70 |
|
| 71 |
NAME |
| 72 |
dtest - simple uDAPL send/receive and RDMA test |
| 73 |
|
| 74 |
SYNOPSIS |
| 75 |
dtest [-P provider] [-b buf size] [-B burst count][-v] [-c] [-p] [-d] [-s] |
| 76 |
|
| 77 |
dtest [-P provider] [-b buf size] [-B burst count][-v] [-c] [-p] [-d] [-h HOSTNAME] |
| 78 |
|
| 79 |
DESCRIPTION |
| 80 |
dtest is a simple test used to exercise and verify the uDAPL interfaces. |
| 81 |
At least two instantiations of the test must be run. One acts as the |
| 82 |
server and the other the client. The server side of the test listens for |
| 83 |
connection requests, until timing out or killed. Upon receipt of a cd |
| 84 |
connection request, the connection is established, the server and client |
| 85 |
sides exchange information necessary to perform RDMA writes and reads. |
| 86 |
|
| 87 |
OPTIONS |
| 88 |
-P=PROVIDER |
| 89 |
use PROVIDER to specify uDAPL interface using C:\DAT\dat.conf |
| 90 |
(default ibnic0v2) |
| 91 |
|
| 92 |
-b=BUFFER_SIZE |
| 93 |
use buffer size BUFFER_SIZE for RDMA(default 64) |
| 94 |
|
| 95 |
-B=BURST_COUNT |
| 96 |
use busrt count BURST_COUNT for interations (default 10) |
| 97 |
|
| 98 |
-v, verbose output(default off) |
| 99 |
|
| 100 |
-c, use consumer notification events (default off) |
| 101 |
|
| 102 |
-p, use polling (default wait for event) |
| 103 |
|
| 104 |
-d, delay in seconds before close (default off) |
| 105 |
|
| 106 |
-s, run as server (default - run as server) |
| 107 |
|
| 108 |
-h=HOSTNAME |
| 109 |
use HOSTNAME to specify server hostname or IP address (default - none) |
| 110 |
|
| 111 |
EXAMPLES |
| 112 |
dtest -v -s |
| 113 |
Starts a server process with debug verbosity using provider ibnic0v2 |
| 114 |
|
| 115 |
dtest -h server1-ib0 |
| 116 |
|
| 117 |
Starts a client process, using ibnic0v2 provider to connect to |
| 118 |
hostname server1-ib0. |
| 119 |
|
| 120 |
SEE ALSO |
| 121 |
dapltest(1) |
| 122 |
|
| 123 |
AUTHORS |
| 124 |
Arlin Davis |
| 125 |
<[email protected]> |
| 126 |
|
| 127 |
BUGS |
| 128 |
|
| 129 |
/dapl/test/dapltest/ |
| 130 |
|
| 131 |
NAME |
| 132 |
dapltest - test for the Direct Access Programming Library (DAPL) |
| 133 |
|
| 134 |
DESCRIPTION |
| 135 |
Dapltest is a set of tests developed to exercise, characterize, and |
| 136 |
verify the DAPL interfaces during development and porting. At least two |
| 137 |
instantiations of the test must be run. One acts as the server, fielding |
| 138 |
requests and spawning server-side test threads as needed. Other client(s) |
| 139 |
connect to the server and issue test requests. The server side of the |
| 140 |
test, once invoked, listens continuously for client connection requests |
| 141 |
until stopped or killed. Upon receipt of a connection request, the |
| 142 |
connection is established, the server and client sides swap version |
| 143 |
numbers to verify that they are able to communicate, and the client |
| 144 |
sends the test request to the server. If the version numbers match, and |
| 145 |
the test request is well-formed, the server spawns the threads |
| 146 |
needed to run the test before awaiting further connections. |
| 147 |
|
| 148 |
USAGE |
| 149 |
See manual.htm and or dt-svr.bat & dt-cli.bat. |
| 150 |
|
| 151 |
EXAMPLES |
| 152 |
dapltest -T S -d -D ibnic0v2 |
| 153 |
|
| 154 |
Starts a server process with debug verbosity. |
| 155 |
|
| 156 |
dapltest -T T -d -s host1-ib0 -D ibnic0v2 -i 100 client SR 4096 2 \ |
| 157 |
server SR 4096 2 |
| 158 |
|
| 159 |
Runs a transaction test, with both sides sending one buffer with |
| 160 |
two 4KB segments, one hundred times. |
| 161 |
|
| 162 |
dapltest -T P -d -s host1-ib0 -D ibnic0v2 -i 100 SR 4096 2 |
| 163 |
|
| 164 |
Runs a performance test, with the client sending one buffer with |
| 165 |
two 4KB segments, one hundred times. |
| 166 |
|
| 167 |
dapltest -T Q -s host1-ib0 -D ibnic0v2 |
| 168 |
|
| 169 |
Asks the server to clean up and exit. |
| 170 |
|
| 171 |
dapltest -T L -D ibnic0v2 -d -w 16 -m 1000 |
| 172 |
|
| 173 |
Runs all of the limit tests, setting up 16 complete sets of DAPL |
| 174 |
objects, and creating at most a thousand instances when trying to |
| 175 |
exhaust resources. |
| 176 |
|
| 177 |
dapltest -T T -V -d -t 2 -w 4 -i 55555 -s linux3 -D ibnic0v2 \ |
| 178 |
client RW 4096 1 server RW 2048 4 client SR 1024 4 server SR 4096 \ |
| 179 |
2 client SR 1024 3 -f server SR 2048 1 -f |
| 180 |
|
| 181 |
Runs a more complicated transaction test, with two thread using four |
| 182 |
EPs each, sending a more complicated buffer pattern for a larger |
| 183 |
number of iterations, validating the data received. |
| 184 |
|
| 185 |
BUGS (and To Do List) |
| 186 |
|
| 187 |
Use of CNOs (-Q) is not yet supported. |
| 188 |
|
| 189 |
Further limit tests could be added. |
| 190 |
|