1RDMA-STATISTIC(8)                    Linux                   RDMA-STATISTIC(8)
2
3
4

NAME

6       rdma-statistic - RDMA statistic counter configuration
7

SYNOPSIS

9       rdma [ OPTIONS ] statistic  { COMMAND | help }
10
11
12       rdma statistic { OBJECT } show
13
14       rdma statistic [ OBJECT ] show link [ DEV/PORT_INDX ]
15
16       rdma statistic OBJECT mode
17
18       rdma statistic OBJECT set COUNTER_SCOPE [ DEV/PORT_INDEX] auto { CRITE‐
19               RIA | off }
20
21       rdma statistic OBJECT bind COUNTER_SCOPE [ DEV/PORT_INDEX] [ OBJECT-ID
22               ] [ COUNTER-ID ]
23
24       rdma statistic OBJECT unbind COUNTER_SCOPE [ DEV/PORT_INDEX] [ COUNTER-
25               ID ] [ OBJECT-ID ]
26
27       COUNTER_SCOPE := { link | dev }
28
29       OBJECT := { qp | mr }
30
31       CRITERIA := { type }
32
33

DESCRIPTION

35   rdma statistic [object] show - Queries the specified RDMA device for RDMA
36       and driver-specific statistics. Show the default hw counters if object
37       is not specified
38       DEV - specifies counters on this RDMA device to show.
39
40       PORT_INDEX - specifies counters on this RDMA port to show.
41
42
43   rdma statistic <object> set - configure counter statistic auto-mode for a
44       specific device/port
45       In auto mode all objects belong to one category are bind automatically
46       to a single counter set. Not applicable for MR's.
47
48
49   rdma statistic <object> bind - manually bind an object (e.g., a qp) with a
50       counter
51       When bound the statistics of this object are available in this counter.
52       Not applicable for MR's.
53
54
55   rdma statistic <object> unbind - manually unbind an object (e.g., a qp)
56       from the counter previously bound
57       When unbound the statistics of this object are no longer available in
58       this counter; And if object id is not specified then all objects on
59       this counter will be unbound. Not applicable for MR's.
60
61       COUNTER-ID - specifies the id of the counter to be bound.  If this
62       argument is omitted then a new counter will be allocated.
63
64

EXAMPLES

66       rdma statistic show
67           Shows the state of the default counter of all RDMA devices on the
68           system.
69
70       rdma statistic show link mlx5_2/1
71           Shows the state of the default counter of specified RDMA port
72
73       rdma statistic qp show
74           Shows the state of all qp counters of all RDMA devices on the sys‐
75           tem.
76
77       rdma statistic qp show link mlx5_2/1
78           Shows the state of all qp counters of specified RDMA port.
79
80       rdma statistic qp show link mlx5_2 pid 30489
81           Shows the state of all qp counters of specified RDMA port and
82           belonging to pid 30489
83
84       rdma statistic qp mode
85           List current counter mode on all devices
86
87       rdma statistic qp mode link mlx5_2/1
88           List current counter mode of device mlx5_2 port 1
89
90       rdma statistic qp set link mlx5_2/1 auto type on
91           On device mlx5_2 port 1, for each new QP bind it with a counter
92           automatically. Per counter for QPs with same qp type in each
93           process. Currently only "type" is supported.
94
95       rdma statistic qp set link mlx5_2/1 auto off
96           Turn-off auto mode on device mlx5_2 port 1. The allocated counters
97           can be manually accessed.
98
99       rdma statistic qp bind link mlx5_2/1 lqpn 178
100           On device mlx5_2 port 1, allocate a counter and bind the specified
101           qp on it
102
103       rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
104           On device mlx5_2 port 1, bind the specified qp on the specified
105           counter
106
107       rdma statistic qp unbind link mlx5_2/1 cntn 4
108           On device mlx5_2 port 1, unbind all QPs on the specified counter.
109           After that this counter will be released automatically by the ker‐
110           nel.
111
112       rdma statistic show mr
113           List all currently allocated MR's and their counters.
114
115       rdma statistic show mr mrn 6
116           Dump a specific MR statistics with mrn 6. Dumps nothing if does not
117           exists.
118
119

SEE ALSO

121       rdma(8), rdma-dev(8), rdma-link(8), rdma-resource(8),
122
123

AUTHORS

125       Mark Zhang <markz@mellanox.com>
126       Erez Alfasi <ereza@mellanox.com>
127
128
129
130iproute2                         27 June 2019                RDMA-STATISTIC(8)
Impressum