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_NAMEFILTER_VALUE ]
rdma statisticOBJECTmode
rdma statisticOBJECTsetCOUNTER_SCOPE [ DEV/PORT_INDEX ] auto { CRITERIA | off } [ optional-counters | on/off ]
rdma statisticOBJECTbindCOUNTER_SCOPE [ DEV/PORT_INDEX ] [ OBJECT-ID ] [ COUNTER-ID ]
rdma statisticOBJECTunbindCOUNTER_SCOPE [ DEV/PORT_INDEX ] [ COUNTER-ID ] [ OBJECT-ID ]
rdma statisticmode[ supported ]link [ DEV/PORT_INDEX ]
rdma statisticsetlink [ DEV/PORT_INDEX ] optional-counters [ OPTIONAL-COUNTERS ]
rdma statisticunsetlink [ DEV/PORT_INDEX ] optional-counters
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.
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.
OPTIONAL-COUNTERS - specifies the name of the optional counters to enable. Optional counters that are not specified will be disabled. Note that optional counters are driver-specific.
rdma statistic unset - Disable all optional counters for a specific device/port.
EXAMPLES
rdma statistic show
rdma statistic show link mlx5_2/1
rdma statistic qp show
rdma statistic qp show link mlx5_2/1
rdma statistic qp show link mlx5_2 pid 30489
rdma statistic qp show link mlx5_2 qp-type UD
rdma statistic qp mode
rdma statistic qp mode link mlx5_2/1
rdma statistic qp set link mlx5_2/1 auto type on
rdma statistic qp set link mlx5_2/1 auto type on optional-counters on
rdma statistic qp set link mlx5_2/1 auto pid on
rdma statistic qp set link mlx5_2/1 auto pid,type on
rdma statistic qp set link mlx5_2/1 auto off
rdma statistic qp bind link mlx5_2/1 lqpn 178
rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
rdma statistic qp unbind link mlx5_2/1 cntn 4
rdma statistic show mr
rdma statistic show mr mrn 6
rdma statistic mode link mlx5_2/1
rdma statistic mode supported link mlx5_2/1
rdma statistic set link mlx5_2/1 optional-counters cc_rx_ce_pkts,cc_rx_cnp_pkts
rdma statistic unset link mlx5_2/1 optional-counters
SEE ALSO
rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),
AUTHORS
Mark Zhang <[email protected]> Erez Alfasi <[email protected]> Neta Ostrovsky <[email protected]>