ib_send_bw
(1)
Name
ib_send_bw - Bandwith and latency test using
send transactions.
Synopsis
ib_send_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]
[-r, --rx-depth=<depth>] [-I, --inline_size=<size>]
[-b, --bidirectional] [-e, --events] [-N, --no peak-bw]
[-g, --mcg=<num>] [-M, --MGID=<multicast_gid>] [server]
ib_send_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>] [-e, --events]
[-g, --mcg=<num>] [-M, --MGID=<multicast_gid>]
[-C, --report-cycles] [-H, --report-histogram]
[-U, --report-unsorted] [server]
Description
User Commands IB_SEND_BW/IB_SEND_LAT(1)
NAME
ib_send_bw, ib_send_lat - Bandwith and latency test using
send transactions.
SYNOPSIS
ib_send_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]
[-r, --rx-depth=<depth>] [-I, --inline_size=<size>]
[-b, --bidirectional] [-e, --events] [-N, --no peak-bw]
[-g, --mcg=<num>] [-M, --MGID=<multicast_gid>] [server]
ib_send_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>] [-e, --events]
[-g, --mcg=<num>] [-M, --MGID=<multicast_gid>]
[-C, --report-cycles] [-H, --report-histogram]
[-U, --report-unsorted] [server]
DESCRIPTION
The ib_send_bw and ib_send_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_send_bw
Then an active sending instance is started, giving it the
address at which it will find a listening passive receiver.
#ib_send_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:
SunOS 5.11 Last change: Oct 15, 2011 1
User Commands IB_SEND_BW/IB_SEND_LAT(1)
-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)
-e, --events
Sleep on CQ events (default poll)
-g, --mcg=<num_of_qps>
Send messages to multicast group with <num_of_qps>
qps attached to it.
SunOS 5.11 Last change: Oct 15, 2011 2
User Commands IB_SEND_BW/IB_SEND_LAT(1)
-M, --MGID=<multicast_gid>
In multicast, uses <multicast_gid> as the group MGID
-b, --bidirectional
Measure bidirectional bandwidth (default unidirec-
tional)
-N, --no peak-bw
Cancel peak-bw calculation (default with peak)
-C, --report-cycles
report times in cpu cycle units (default microsec-
onds)
-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(5) for descriptions of the following
attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | network/open-fabrics |
+---------------+----------------------+
|Stability | Volatile |
+---------------+----------------------+
SEE ALSO
ib_write_bw(1), ib_write_lat(1), rdma_lat(1), ib_read_bw(1),
rdma_bw(1), ib_read_lat(1), ib_send_lat(1),
ib_clock_test(1), ib_write_bw_post_list(1)
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from ['http://www.openfab-
rics.org/downloads/ibutils/ibutils-1.5.7.tar.gz',
'http://www.openfabrics.org/downloads/libibverbs/libib-
verbs-1.1.4-1.22.g7257cd3.tar.gz', 'http://www.openfab-
rics.org/down-
loads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz',
'http://www.openfabrics.org/downloads/libsdp/lib-
sdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfab-
rics.org/downloads/management/infiniband-
diags-1.5.8.tar.gz',
SunOS 5.11 Last change: Oct 15, 2011 3
User Commands IB_SEND_BW/IB_SEND_LAT(1)
'http://www.openfabrics.org/downloads/management/libib-
mad-1.3.7.tar.gz', 'http://www.openfabrics.org/down-
loads/management/libibumad-1.3.7.tar.gz', 'http://www.open-
fabrics.org/downloads/management/opensm-3.3.9.tar.gz',
'http://www.openfabrics.org/down-
loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz',
'http://www.openfabrics.org/down-
loads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz',
'http://www.openfabrics.org/downloads/rdmacm/librd-
macm-1.0.14.1.tar.gz', 'http://www.openfabrics.org/down-
loads/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.openfab-
rics.org/.
SunOS 5.11 Last change: Oct 15, 2011 4