www.LinuxHowtos.org
RDMA-STATISTIC
Section: Linux (8)Updated: 27 June 2019
Index Return to Main Contents
NAME
rdm-statistic - RDMA statistic counter configurationSYNOPSIS
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 }
[ optiona-counters | on/off ]
rdma statistic
OBJECT
bind
COUNTER_SCOPE
[ DEV/PORT_INDEX ]
[ OBJEC-ID ]
[ COUNTE-ID ]
rdma statistic
OBJECT
unbind
COUNTER_SCOPE
[ DEV/PORT_INDEX ]
[ COUNTE-ID ]
[ OBJEC-ID ]
rdma statistic
mode
[ supported ]
link
[ DEV/PORT_INDEX ]
rdma statistic
set
link
[ DEV/PORT_INDEX ]
optiona-counters
[ OPTIONA-COUNTERS ]
rdma statistic
unset
link
[ DEV/PORT_INDEX ]
optiona-counters
COUNTER_SCOPE :=
{ link | dev }
OBJECT :=
{ qp | mr }
CRITERIA :=
{ type | pid }
FILTER_NAME :=
{ cntn | lqpn | pid | q-type }
DESCRIPTION
rdma statistic [object] show- Queries the specified RDMA device for RDMA and drive-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 aut-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.COUNTE-ID - specifies the id of the counter to be bound. If this argument is omitted then a new counter will be allocated.
rdma statistic mode- Display the enabled optional counters for each link.
rdma statistic mode supported- Display the supported optional counters for each link.
rdma statistic set- Enable a set of optional counters for a specific device/port.
OPTIONA-COUNTERS - specifies the name of the optional counters to enable. Optional counters that are not specified will be disabled. Note that optional counters are drive-specific.
rdma statistic unset- Disable all optional counters for a specific device/port.
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 q-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 type on optiona-counters 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. Whilst also binding the currently enabled optiona-counters.
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
- Tur-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.
rdma statistic mode link mlx5_2/1
- Display the optional counters that was enabled on mlx5_2/1.
rdma statistic mode supported link mlx5_2/1
- Display the optional counters that mlx5_2/1 supports.
rdma statistic set link mlx5_2/1 optiona-counters cc_rx_ce_pkts,cc_rx_cnp_pkts
- Enable the cc_rx_ce_pkts,cc_rx_cnp_pkts counters on device mlx5_2 port 1.
rdma statistic unset link mlx5_2/1 optiona-counters
- Disable all the optional counters on device mlx5_2 port 1.
SEE ALSO
rdma(8), rdm-dev(8), rdm-link(8), rdm-resource(8),AUTHORS
Mark Zhang <markz@mellanox.com>Erez Alfasi <ereza@mellanox.com>
Neta Ostrovsky <netao@nvidia.com>
Index
- NAME
- SYNOPSIS
- 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
- rdma statistic <object> set - configure counter statistic auto-mode for a specific device/port
- rdma statistic <object> bind - manually bind an object (e.g., a qp) with a counter
- rdma statistic <object> unbind - manually unbind an object (e.g., a qp) from the counter previously bound
- rdma statistic mode - Display the enabled optional counters for each link.
- rdma statistic mode supported - Display the supported optional counters for each link.
- rdma statistic set - Enable a set of optional counters for a specific device/port.
- rdma statistic unset - Disable all optional counters for a specific device/port.
- EXAMPLES
- SEE ALSO
- AUTHORS