man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

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