Debian Codegraph @

README.windows

raw
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