ib_write_bw - Bandwidth and latency test using RDMA write transactions.
ib_write_bw [-p, --port=<port>] [-d, --ib-dev=<dev>] [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] [-I, --inline_size=<size>] [-b, --bidirectional] [-N, --no peak-bw] [-q, --qp=<num>] [server] ib_write_bw_postlist [-p, --port=<port>] [-d, --ib-dev=<dev>] [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] [-I, --inline_size=<size>] [-b, --bidirectional] [-N, --no peak-bw] [-q, --qp=<num>] [server] ib_write_lat [-p, --port=<port>] [-d, --ib-dev=<dev>] [-i, --ib-port=<port number.] [-c, --connection=<RC|UD>] [-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all] [-n, --iters=<iterations>] [-t, --tx-depth=<depth>] [-u, --qp-timeout=<timeout] [-S, --sl=<sl>] [-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version] [--I, --inline_size=<size>] [-C, --report-cycles] [-H, --report-histogram] [-U, --report-unsorted] [server]
IB_WRITE_BW(1)(1) Oct 15, 2011 IB_WRITE_BW(1)(1)
NAME
ib_write_bw, ib_write_bw_postlist, ib_write_lat - Bandwidth and latency
test using RDMA write transactions.
SYNOPSIS
ib_write_bw [-p, --port=<port>] [-d, --ib-dev=<dev>]
[-i, --ib-port=<port number.] [-c, --connection=<RC|UD>]
[-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all]
[-n, --iters=<iterations>] [-t, --tx-depth=<depth>]
[-u, --qp-timeout=<timeout] [-S, --sl=<sl>]
[-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version]
[-I, --inline_size=<size>] [-b, --bidirectional]
[-N, --no peak-bw] [-q, --qp=<num>] [server]
ib_write_bw_postlist [-p, --port=<port>] [-d, --ib-dev=<dev>]
[-i, --ib-port=<port number.] [-c, --connection=<RC|UD>]
[-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all]
[-n, --iters=<iterations>] [-t, --tx-depth=<depth>]
[-u, --qp-timeout=<timeout] [-S, --sl=<sl>]
[-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version]
[-I, --inline_size=<size>] [-b, --bidirectional]
[-N, --no peak-bw] [-q, --qp=<num>] [server]
ib_write_lat [-p, --port=<port>] [-d, --ib-dev=<dev>]
[-i, --ib-port=<port number.] [-c, --connection=<RC|UD>]
[-m, --mtu=<mtu>] [-s, --size=<size>] [-a, --all]
[-n, --iters=<iterations>] [-t, --tx-depth=<depth>]
[-u, --qp-timeout=<timeout] [-S, --sl=<sl>]
[-x, --gid-index=<index>] [-F, --CPU-freq] [-V, --version]
[--I, --inline_size=<size>] [-C, --report-cycles]
[-H, --report-histogram] [-U, --report-unsorted] [server]
DESCRIPTION
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.
First a passive receiving instance is started.
#ib_write_bw
Then an active sending instance is started, giving it the address at
which it will find a listening passive receiver.
#ib_write_bw server
If options are used then the same options must be used for both client
and server.
OPTIONS
The following options are available for use on the command line:
-p, --port <port>
Listen on/connect to port <port> (default 18515)
-d, --ib-dev <dev>
Use IB device <dev> (default first device found)
-i, --ib-port <port number>
Use port <port number> of IB device (default 1)
-c, --connection <RC|UD>
Connection type RC or UD (default RC)
-m, --mtu <mtu>s
Mtu size : 256 - 4096 (default port mtu)
-s, --size <size>
Size of message to exchange (default 2)
-a, --all
Run sizes from 2 till 2^23
-n, --iters <iterations>
Number of exchanges (at least 5, default 1000)
-t, --tx-depth <depth>
Size of tx queue (default 50)
-u, --qp-timeout <timeout>
QP timeout, timeout value is 4 usec * 2 ^(timeout), default 14
-S, --sl <sl>
SL (default 0)
-x, --gid-index <index>
Test uses GID with GID index (Default : IB - no gid)
-F, --CPU-freq
Do not fail even if cpufreq_ondemand module is loaded
-V, --version
Display version number
-I, --inline_size <size>
Max size of message to be sent in inline (default 0)
-b, --bidirectional
Measure bidirectional bandwidth (default unidirectional)
-N, --no peak-bw
Cancel peak-bw calculation (default with peak)
-q, --qp <num>
Specify <num> as number of QPs to use (default 1).
-C, --report-cycles
report times in cpu cycle units (default microseconds)
-H, --report-histogram
Print out all results (default print summary only)
-U, --report-unsorted
(implies -H) print out unsorted results (default sorted)
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------------+
|Availability | network/open-fabrics |
+---------------+-----------------------+
|Stability | Pass-through volatile |
+---------------+-----------------------+
SEE ALSO
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(8)
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from ['https://www.openfabrics.org/down-
loads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfab-
rics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz',
'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz',
'https://www.openfabrics.org/downloads/libsdp/lib-
sdp-1.1.108-0.15.gd7fdb72.tar.gz', 'https://www.openfabrics.org/down-
loads/management/infiniband-diags-1.6.5.tar.gz', 'https://www.openfab-
rics.org/downloads/management/libibmad-1.3.12.tar.gz',
'https://www.openfabrics.org/downloads/management/libibu-
mad-1.3.10.2.tar.gz', 'https://www.openfabrics.org/downloads/manage-
ment/opensm-3.3.19.tar.gz', 'https://www.openfabrics.org/down-
loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.open-
fabrics.org/downloads/qperf/qperf-0.4.9.tar.gz', 'https://www.openfab-
rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz', 'https://www.open-
fabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz'].
Further information about this software can be found on the open source
community website at http://www.openfabrics.org/.
1 IB_WRITE_LAT IB_WRITE_BW(1)(1)