RDMA-STATISTIC(8)        (27 June 2019)         RDMA-STATISTIC(8)

     NAME
          rdma-statistic - RDMA statistic counter configuration

     SYNOPSIS
          rdma [ OPTIONS ] statistic { COMMAND | help }

          rdma statistic { OBJECT } show

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

          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 | mr }

          CRITERIA :=  { type | pid }

          FILTER_NAME :=  { cntn | lqpn | pid

     DESCRIPTION
        rdma statistic [object] show - Queries
          DEV - specifies counters on this RDMA device to show.

          PORT_INDEX - specifies counters on this RDMA port to show.

          FILTER_NAME - specifies a filter to show only the results
          matching it.

        rdma statistic <object> set - configure
          In auto mode all objects belong to one category are bind
          automatically to a single counter set. The "off" is global
          for all auto modes together. Not applicable for MR's.

        rdma statistic <object> bind - manually
          When bound the statistics of this object are available in

     Page 1                      iproute2            (printed 5/25/22)

     RDMA-STATISTIC(8)        (27 June 2019)         RDMA-STATISTIC(8)

          this counter. Not applicable for MR's.

        rdma statistic <object> unbind - manually
          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. Not appli-
          cable for MR's.

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

     EXAMPLES
          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 show link mlx5_2 qp-type UD
              Shows the state of all qp counters of specified RDMA
              port and with QP type UD

          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 user QP bind it
              with a counter automatically. Per counter for QPs with
              same qp type.

          rdma statistic qp set link mlx5_2/1 auto pid on
              On device mlx5_2 port 1, for each new user QP bind it

     Page 2                      iproute2            (printed 5/25/22)

     RDMA-STATISTIC(8)        (27 June 2019)         RDMA-STATISTIC(8)

              with a counter automatically. Per counter for QPs with
              same pid.

          rdma statistic qp set link mlx5_2/1 auto pid,type on
              On device mlx5_2 port 1, for each new user QP bind it
              with a counter automatically. Per counter for QPs with
              same pid and same type.

          rdma statistic qp set link mlx5_2/1 auto off
              Turn-off auto mode on device mlx5_2 port 1. The allo-
              cated 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 auto-
              matically by the kernel.

          rdma statistic show mr
              List all currently allocated MR's and their counters.

          rdma statistic show mr mrn 6
              Dump a specific MR statistics with mrn 6. Dumps nothing
              if does not exists.

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

     AUTHORS
          Mark Zhang <markz@mellanox.com>
          Erez Alfasi <ereza@mellanox.com>

     Page 3                      iproute2            (printed 5/25/22)