'\" te
'\" t
.\" Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
.\" Modified for Solaris to add the Solaris stability classification,
.\" and to add a note about source availability.
.\"
.TH IB_SEND_BW/IB_SEND_LAT 1 " Oct 15, 2011"
.SH "NAME"
ib_send_bw, ib_send_lat - Bandwith and latency test using send transactions. 
.PP
.SH SYNOPSIS
.HP
.nf
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]
.fi
.HP

.nf
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]
.fi


.SH DESCRIPTION
.PP
.Nm
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.

.PP
First a passive receiving instance is started.
.RS 12

	#ib_send_bw
.RE
.PP
Then an active sending instance is started, giving it the address at which it will find a listening passive receiver.
.PP
.RS 12
	#ib_send_bw server 
.RE
.PP
If options are used then the same options must be  used for both client and server.
.PP
.SH OPTIONS
.PP
The following options are available for use on the command line:

.TP 7
\fB\-p, --port  <port>
Listen on/connect to port <port> (default 18515)
.TP
\fB\-d, --ib-dev <dev>
Use IB device <dev> (default first device found)
.TP
\fB\-i, --ib-port <port number>
Use port <port number> of IB device (default 1)
.TP
\fB\-c, --connection <RC|UD>
 Connection type RC or UD (default RC)
.TP
\fB\-m, --mtu <mtu>s
Mtu size : 256 - 4096 (default port mtu)
.TP
\fB\-s, --size <size>
Size of message to exchange (default 2)
.TP
\fB\-a, --all
Run sizes from 2 till 2^23
.TP
\fB\-n, --iters <iterations>
Number of exchanges (at least 5, default 1000)
.TP
\fB\-t, --tx-depth  <depth>
Size of tx queue (default 50)
.TP
\fB\-u, --qp-timeout <timeout>
QP timeout, timeout value is 4 usec * 2 ^(timeout), default 14
.TP
\fB\-S, --sl <sl>
SL (default 0)
.TP
\fB\-x, --gid-index <index>
Test uses GID with GID index (Default : IB - no gid)
.TP
\fB\-F, --CPU-freq
Do not fail even if cpufreq_ondemand module is loaded
.TP
\fB\-V, --version
Display version number
.TP
\fB\-I, --inline_size <size>
Max size of message to be sent in inline (default 0)
.TP
\fB\-e, --events
Sleep on CQ events (default poll)
.TP
\fB\-g, --mcg=<num_of_qps>
Send messages to multicast group with <num_of_qps> qps attached to it.
.TP
\fB\-M, --MGID=<multicast_gid>
In multicast, uses <multicast_gid> as the group MGID
.TP
\fB\-b, --bidirectional
Measure bidirectional bandwidth (default unidirectional)
.TP
\fB\-N, --no peak-bw
Cancel peak-bw calculation (default with peak)
.TP
\fB\-C, --report-cycles
report times in cpu cycle units (default microseconds)
.TP
\fB\-H, --report-histogram
Print out all results (default print summary only)
.TP
\fB\-U, --report-unsorted
(implies -H) print out unsorted results (default sorted)
.PP

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	network/open-fabrics
=
Stability	Volatile
.TE 
.PP
.SH 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)


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  ['http://download.oracle.com/otn-pub/oss/networking/libsif-1.0.tar.gz', 'http://www.openfabrics.org/downloads/ibutils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/downloads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz', 'http://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfabrics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfabrics.org/downloads/management/infiniband-diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/management/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'http://www.openfabrics.org/downloads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfabrics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://www.openfabrics.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/.