|
1 '\" t |
|
2 .\" Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved. |
|
3 .\" Modified for Solaris to add the Solaris stability classification, |
|
4 .\" and to add a note about source availability. |
|
5 .\" |
|
6 .TH IB_WRITE_BW/IB_WRITE_BW_POST_LIST/IB_WRITE_LAT 1 " Oct 15, 2011" |
|
7 .SH "NAME" |
|
8 ib_write_bw, ib_write_bw_poslist, ib_write_lat - Bandwith and latency test using RDMA write transactions. |
|
9 .PP |
|
10 .SH SYNOPSIS |
|
11 .HP |
|
12 .nf |
|
13 ib_write_bw [-p, --port=<port>] [-d, --ib-dev=<dev>] |
|
14 [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] |
|
15 [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] |
|
16 [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] |
|
17 [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] |
|
18 [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] |
|
19 [-I, --inline_size=<size>] [-b, --bidirectional] |
|
20 [-N, --no peak-bw] [-q, --qp=<num>] [server] |
|
21 .fi |
|
22 .HP |
|
23 |
|
24 .nf |
|
25 ib_write_bw_postlist [-p, --port=<port>] [-d, --ib-dev=<dev>] |
|
26 [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] |
|
27 [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] |
|
28 [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] |
|
29 [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] |
|
30 [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] |
|
31 [-I, --inline_size=<size>] [-b, --bidirectional] |
|
32 [-N, --no peak-bw] [-q, --qp=<num>] [server] |
|
33 .fi |
|
34 .HP |
|
35 |
|
36 .nf |
|
37 ib_write_lat [-p, --port=<port>] [-d, --ib-dev=<dev>] |
|
38 [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] |
|
39 [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] |
|
40 [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] |
|
41 [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] |
|
42 [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] |
|
43 [--I, --inline_size=<size>] [-C, --report-cycles] |
|
44 [-H, --report-histogram] [-U, --report-unsorted] [server] |
|
45 .fi |
|
46 |
|
47 |
|
48 .SH DESCRIPTION |
|
49 .PP |
|
50 .Nm |
|
51 The ib_write_bw, ib_write_bw_postlist and ib_write_lat tests are part of the "perftest" utilities that are used for InfiniBand related performance testing. The "perftest" utilities are micro bench mark utilities. |
|
52 |
|
53 .PP |
|
54 First a passive receiving instance is started. |
|
55 .RS 12 |
|
56 |
|
57 #ib_write_bw |
|
58 .RE |
|
59 .PP |
|
60 Then an active sending instance is started, giving it the address at which it will find a listening passive receiver. |
|
61 .PP |
|
62 .RS 12 |
|
63 #ib_write_bw server |
|
64 .RE |
|
65 .PP |
|
66 If options are used then the same options must be used for both client and server. |
|
67 .PP |
|
68 .SH OPTIONS |
|
69 .PP |
|
70 The following options are available for use on the command line: |
|
71 |
|
72 .TP 7 |
|
73 \fB\-p, --port <port> |
|
74 Listen on/connect to port <port> (default 18515) |
|
75 .TP |
|
76 \fB\-d, --ib-dev <dev> |
|
77 Use IB device <dev> (default first device found) |
|
78 .TP |
|
79 \fB\-i, --ib-port <port number> |
|
80 Use port <port number> of IB device (default 1) |
|
81 .TP |
|
82 \fB\-c, --connection <RC|UD> |
|
83 Connection type RC or UD (default RC) |
|
84 .TP |
|
85 \fB\-m, --mtu <mtu>s |
|
86 Mtu size : 256 - 4096 (default port mtu) |
|
87 .TP |
|
88 \fB\-s, --size <size> |
|
89 Size of message to exchange (default 2) |
|
90 .TP |
|
91 \fB\-a, --all |
|
92 Run sizes from 2 till 2^23 |
|
93 .TP |
|
94 \fB\-n, --iters <iterations> |
|
95 Number of exchanges (at least 5, default 1000) |
|
96 .TP |
|
97 \fB\-t, --tx-depth <depth> |
|
98 Size of tx queue (default 50) |
|
99 .TP |
|
100 \fB\-u, --qp-timeout <timeout> |
|
101 QP timeout, timeout value is 4 usec * 2 ^(timeout), default 14 |
|
102 .TP |
|
103 \fB\-S, --sl <sl> |
|
104 SL (default 0) |
|
105 .TP |
|
106 \fB\-x, --gid-index <index> |
|
107 Test uses GID with GID index (Default : IB - no gid) |
|
108 .TP |
|
109 \fB\-F, --CPU-freq |
|
110 Do not fail even if cpufreq_ondemand module is loaded |
|
111 .TP |
|
112 \fB\-V, --version |
|
113 Display version number |
|
114 .TP |
|
115 \fB\-I, --inline_size <size> |
|
116 Max size of message to be sent in inline (default 0) |
|
117 .TP |
|
118 \fB\-b, --bidirectional |
|
119 Measure bidirectional bandwidth (default unidirectional) |
|
120 .TP |
|
121 \fB\-N, --no peak-bw |
|
122 Cancel peak-bw calculation (default with peak) |
|
123 .TP |
|
124 \fB\-q, --qp <num> |
|
125 Specify <num> as number of QPs to use (default 1). |
|
126 .TP |
|
127 \fB\-C, --report-cycles |
|
128 report times in cpu cycle units (default microseconds) |
|
129 .TP |
|
130 \fB\-H, --report-histogram |
|
131 Print out all results (default print summary only) |
|
132 .TP |
|
133 \fB\-U, --report-unsorted |
|
134 (implies -H) print out unsorted results (default sorted) |
|
135 .PP |
|
136 .SH SEE ALSO |
|
137 ib_send_bw(1), ib_read_bw(1), rdma_lat(1), rdma_bw(1), ib_read_lat(1), ib_send_lat(1), ib_clock_test(1) |