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 COUNTER_SCOPE := { link | dev }
29 OBJECT := { qp | mr }
31 CRITERIA := { type | pid }
33 FILTER_NAME := { cntn | lqpn | pid | qp-type }
35
38 rdma statistic [object] show - Queries the specified RDMA device for RDMA
39 and driver-specific statistics. Show the default hw counters if object
40 is not specified
41 DEV - specifies counters on this RDMA device to show.
42 PORT_INDEX - specifies counters on this RDMA port to show.
44 FILTER_NAME - specifies a filter to show only the results matching it.
46 rdma statistic <object> set - configure counter statistic auto-mode for a
49 specific device/port
50 In auto mode all objects belong to one category are bind automatically
51 to a single counter set. The "off" is global for all auto modes
52 together. Not applicable for MR's.
53 rdma statistic <object> bind - manually bind an object (e.g., a qp) with a
56 counter
57 When bound the statistics of this object are available in this counter.
58 Not applicable for MR's.
59 rdma statistic <object> unbind - manually unbind an object (e.g., a qp)
62 from the counter previously bound
63 When unbound the statistics of this object are no longer available in
64 this counter; And if object id is not specified then all objects on
65 this counter will be unbound. Not applicable for MR's.
66 COUNTER-ID - specifies the id of the counter to be bound. If this
68 argument is omitted then a new counter will be allocated.
69
72 rdma statistic show
73 Shows the state of the default counter of all RDMA devices on the
74 system.
75 rdma statistic show link mlx5_2/1
77 Shows the state of the default counter of specified RDMA port
78 rdma statistic qp show
80 Shows the state of all qp counters of all RDMA devices on the sys‐
81 tem.
82 rdma statistic qp show link mlx5_2/1
84 Shows the state of all qp counters of specified RDMA port.
85 rdma statistic qp show link mlx5_2 pid 30489
87 Shows the state of all qp counters of specified RDMA port and
88 belonging to pid 30489
89 rdma statistic qp show link mlx5_2 qp-type UD
91 Shows the state of all qp counters of specified RDMA port and with
92 QP type UD
93 rdma statistic qp mode
95 List current counter mode on all devices
96 rdma statistic qp mode link mlx5_2/1
98 List current counter mode of device mlx5_2 port 1
99 rdma statistic qp set link mlx5_2/1 auto type on
101 On device mlx5_2 port 1, for each new user QP bind it with a
102 counter automatically. Per counter for QPs with same qp type.
103 rdma statistic qp set link mlx5_2/1 auto pid on
105 On device mlx5_2 port 1, for each new user QP bind it with a
106 counter automatically. Per counter for QPs with same pid.
107 rdma statistic qp set link mlx5_2/1 auto pid,type on
109 On device mlx5_2 port 1, for each new user QP bind it with a
110 counter automatically. Per counter for QPs with same pid and same
111 type.
112 rdma statistic qp set link mlx5_2/1 auto off
114 Turn-off auto mode on device mlx5_2 port 1. The allocated counters
115 can be manually accessed.
116 rdma statistic qp bind link mlx5_2/1 lqpn 178
118 On device mlx5_2 port 1, allocate a counter and bind the specified
119 qp on it
120 rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
122 On device mlx5_2 port 1, bind the specified qp on the specified
123 counter
124 rdma statistic qp unbind link mlx5_2/1 cntn 4
126 On device mlx5_2 port 1, unbind all QPs on the specified counter.
127 After that this counter will be released automatically by the ker‐
128 nel.
129 rdma statistic show mr
131 List all currently allocated MR's and their counters.
132 rdma statistic show mr mrn 6
134 Dump a specific MR statistics with mrn 6. Dumps nothing if does not
135 exists.
136
139 rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),
140
143 Mark Zhang <markz@mellanox.com>
144 Erez Alfasi <ereza@mellanox.com>
145iproute2 27 June 2019 RDMA-STATISTIC(8)