RDMA\-STATISTIC
Section: Linux (8)
Updated: 27 June 2019
Page Index
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 | qp-type }
DESCRIPTION
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.
FILTER_NAME
- specifies a filter to show only the results matching it.
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. The "off" is global for all auto modes together. Not applicable for MR's.
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. Not applicable for MR's.
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. Not applicable 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 allocated.
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 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 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.
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>