NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

RDMA-STATISTIC(8)                   Linux                  RDMA-STATISTIC(8)

NAME         top

       rdma-statistic - RDMA statistic counter configuration

SYNOPSIS         top

       rdma [ OPTIONS ] statistic  { COMMAND | help }

       rdma statistic [ OBJECT ] show

       rdma statistic [ OBJECT ] show link [ DEV/PORT_INDX ]

       rdma statistic OBJECT mode

       rdma statistic OBJECT set COUNTER_SCOPE [ DEV/PORT_INDEX] auto {
               CRITERIA | off }

       rdma statistic OBJECT bind COUNTER_SCOPE [ DEV/PORT_INDEX] [ OBJECT-
               ID ] [ COUNTER-ID ]

       rdma statistic OBJECT unbind COUNTER_SCOPE [ DEV/PORT_INDEX] [
               COUNTER-ID ] [ OBJECT-ID ]

       COUNTER_SCOPE := { link | dev }

       OBJECT := { qp }

       CRITERIA := { type }

DESCRIPTION         top

   rdma statistic [object] show - Queries the specified RDMA device for RDMA
       and driver-specific statistics. Show the default hw counters if
       object is not specified
       DEV - specifies counters on this RDMA device to show.

       PORT_INDEX - specifies counters on this RDMA port to show.

   rdma statistic <object> set - configure counter statistic auto-mode for a
       specific device/port
       In auto mode all objects belong to one category are bind
       automatically to a single counter set.

   rdma statistic <object> bind - manually bind an object (e.g., a qp) with
       a counter
       When bound the statistics of this object are available in this
       counter.

   rdma statistic <object> unbind - manually unbind an object (e.g., a qp)
       from the counter previously bound
       When unbound the statistics of this object are no longer available in
       this counter; And if object id is not specified then all objects on
       this counter will be unbound.

       COUNTER-ID - specifies the id of the counter to be bound.  If this
       argument is omitted then a new counter will be allocated.

EXAMPLES         top

       rdma statistic show
           Shows the state of the default counter of all RDMA devices on the
           system.

       rdma statistic show link mlx5_2/1
           Shows the state of the default counter of specified RDMA port

       rdma statistic qp show
           Shows the state of all qp counters of all RDMA devices on the
           system.

       rdma statistic qp show link mlx5_2/1
           Shows the state of all qp counters of specified RDMA port.

       rdma statistic qp show link mlx5_2 pid 30489
           Shows the state of all qp counters of specified RDMA port and
           belonging to pid 30489

       rdma statistic qp mode
           List current counter mode on all devices

       rdma statistic qp mode link mlx5_2/1
           List current counter mode of device mlx5_2 port 1

       rdma statistic qp set link mlx5_2/1 auto type on
           On device mlx5_2 port 1, for each new QP bind it with a counter
           automatically. Per counter for QPs with same qp type in each
           process. Currently only "type" is supported.

       rdma statistic qp set link mlx5_2/1 auto off
           Turn-off auto mode on device mlx5_2 port 1. The allocated
           counters can be manually accessed.

       rdma statistic qp bind link mlx5_2/1 lqpn 178
           On device mlx5_2 port 1, allocate a counter and bind the
           specified qp on it

       rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
           On device mlx5_2 port 1, bind the specified qp on the specified
           counter

       rdma statistic qp unbind link mlx5_2/1 cntn 4
           On device mlx5_2 port 1, unbind all QPs on the specified counter.
           After that this counter will be released automatically by the
           kernel.

SEE ALSO         top

       rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),

AUTHOR         top

       Mark Zhang <markz@mellanox.com>

COLOPHON         top

       This page is part of the iproute2 (utilities for controlling TCP/IP
       networking and traffic) project.  Information about the project can
       be found at 
       ⟨http://www.linuxfoundation.org/collaborate/workgroups/networking/iproute2⟩.
       If you have a bug report for this manual page, send it to
       netdev@vger.kernel.org, shemminger@osdl.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://git.kernel.org/pub/scm/network/iproute2/iproute2.git⟩ on
       2019-07-28.  (At that time, the date of the most recent commit that
       was found in the repository was 2019-07-26.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

iproute2                         17 Mar 2019               RDMA-STATISTIC(8)

Pages that refer to this page: rdma(8)rdma-dev(8)rdma-link(8)rdma-resource(8)