1RDMA-STATISTIC(8) Linux RDMA-STATISTIC(8)
2
6 rdma-statistic - RDMA statistic counter configuration
7
9 rdma [ OPTIONS ] statistic { COMMAND | help }
10 rdma statistic { OBJECT } show
13 rdma statistic [ OBJECT ] show link [ DEV/PORT_INDX ] [ FILTER_NAME
15 FILTER_VALUE ]
16 rdma statistic OBJECT mode
18 rdma statistic OBJECT set COUNTER_SCOPE [ DEV/PORT_INDEX ] auto { CRI‐
20 TERIA | off }
21 rdma statistic OBJECT bind COUNTER_SCOPE [ DEV/PORT_INDEX ] [ OBJECT-ID
23 ] [ COUNTER-ID ]
24 rdma statistic OBJECT unbind COUNTER_SCOPE [ DEV/PORT_INDEX ] [
26 COUNTER-ID ] [ OBJECT-ID ]
27 rdma statistic mode [ supported ] link [ DEV/PORT_INDEX ]
29 rdma statistic set link [ DEV/PORT_INDEX ] optional-counters [ OP‐
31 TIONAL-COUNTERS ]
32 rdma statistic unset link [ DEV/PORT_INDEX ] optional-counters
34 COUNTER_SCOPE := { link | dev }
36 OBJECT := { qp | mr }
38 CRITERIA := { type | pid }
40 FILTER_NAME := { cntn | lqpn | pid | qp-type }
42
45 rdma statistic [object] show - Queries the specified RDMA device for RDMA
46 and driver-specific statistics. Show the default hw counters if object
47 is not specified
48 DEV - specifies counters on this RDMA device to show.
49 PORT_INDEX - specifies counters on this RDMA port to show.
51 FILTER_NAME - specifies a filter to show only the results matching it.
53 rdma statistic <object> set - configure counter statistic auto-mode for a
56 specific device/port
57 In auto mode all objects belong to one category are bind automatically
58 to a single counter set. The "off" is global for all auto modes to‐
59 gether. Not applicable for MR's.
60 rdma statistic <object> bind - manually bind an object (e.g., a qp) with a
63 counter
64 When bound the statistics of this object are available in this counter.
65 Not applicable for MR's.
66 rdma statistic <object> unbind - manually unbind an object (e.g., a qp)
69 from the counter previously bound
70 When unbound the statistics of this object are no longer available in
71 this counter; And if object id is not specified then all objects on
72 this counter will be unbound. Not applicable for MR's.
73 COUNTER-ID - specifies the id of the counter to be bound. If this ar‐
75 gument is omitted then a new counter will be allocated.
76 rdma statistic mode - Display the enabled optional counters for each link.
79 rdma statistic mode supported - Display the supported optional counters for
80 each link.
81 rdma statistic set - Enable a set of optional counters for a specific de‐
82 vice/port.
83 OPTIONAL-COUNTERS - specifies the name of the optional counters to en‐
84 able. Optional counters that are not specified will be disabled. Note
85 that optional counters are driver-specific.
86 rdma statistic unset - Disable all optional counters for a specific de‐
89 vice/port.
91 rdma statistic show
92 Shows the state of the default counter of all RDMA devices on the
93 system.
94 rdma statistic show link mlx5_2/1
96 Shows the state of the default counter of specified RDMA port
97 rdma statistic qp show
99 Shows the state of all qp counters of all RDMA devices on the sys‐
100 tem.
101 rdma statistic qp show link mlx5_2/1
103 Shows the state of all qp counters of specified RDMA port.
104 rdma statistic qp show link mlx5_2 pid 30489
106 Shows the state of all qp counters of specified RDMA port and be‐
107 longing to pid 30489
108 rdma statistic qp show link mlx5_2 qp-type UD
110 Shows the state of all qp counters of specified RDMA port and with
111 QP type UD
112 rdma statistic qp mode
114 List current counter mode on all devices
115 rdma statistic qp mode link mlx5_2/1
117 List current counter mode of device mlx5_2 port 1
118 rdma statistic qp set link mlx5_2/1 auto type on
120 On device mlx5_2 port 1, for each new user QP bind it with a
121 counter automatically. Per counter for QPs with same qp type.
122 rdma statistic qp set link mlx5_2/1 auto pid on
124 On device mlx5_2 port 1, for each new user QP bind it with a
125 counter automatically. Per counter for QPs with same pid.
126 rdma statistic qp set link mlx5_2/1 auto pid,type on
128 On device mlx5_2 port 1, for each new user QP bind it with a
129 counter automatically. Per counter for QPs with same pid and same
130 type.
131 rdma statistic qp set link mlx5_2/1 auto off
133 Turn-off auto mode on device mlx5_2 port 1. The allocated counters
134 can be manually accessed.
135 rdma statistic qp bind link mlx5_2/1 lqpn 178
137 On device mlx5_2 port 1, allocate a counter and bind the specified
138 qp on it
139 rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
141 On device mlx5_2 port 1, bind the specified qp on the specified
142 counter
143 rdma statistic qp unbind link mlx5_2/1 cntn 4
145 On device mlx5_2 port 1, unbind all QPs on the specified counter.
146 After that this counter will be released automatically by the ker‐
147 nel.
148 rdma statistic show mr
150 List all currently allocated MR's and their counters.
151 rdma statistic show mr mrn 6
153 Dump a specific MR statistics with mrn 6. Dumps nothing if does not
154 exists.
155 rdma statistic mode link mlx5_2/1
157 Display the optional counters that was enabled on mlx5_2/1.
158 rdma statistic mode supported link mlx5_2/1
160 Display the optional counters that mlx5_2/1 supports.
161 rdma statistic set link mlx5_2/1 optional-counters
163 cc_rx_ce_pkts,cc_rx_cnp_pkts
164 Enable the cc_rx_ce_pkts,cc_rx_cnp_pkts counters on device mlx5_2
165 port 1.
166 rdma statistic unset link mlx5_2/1 optional-counters
168 Disable all the optional counters on device mlx5_2 port 1.
169
172 rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),
173
176 Mark Zhang <markz@mellanox.com>
177 Erez Alfasi <ereza@mellanox.com>
178 Neta Ostrovsky <netao@nvidia.com>
179iproute2 27 June 2019 RDMA-STATISTIC(8)