man/man8/rdma-statistic.8

   1 .TH RDMA\-STATISTIC 8 "27 June 2019" "iproute2" "Linux"
   2 .SH NAME
   3 rdma-statistic \- RDMA statistic counter configuration
   4 .SH SYNOPSIS
   5 .sp
   6 .ad l
   7 .in +8
   8 .ti -8
   9 .B rdma
  10 .RI "[ " OPTIONS " ]"
  11 .B statistic
  12 .RI  "{ " COMMAND " | "
  13 .BR help " }"
  14 .sp
  15
  16 .ti -8
  17 .B rdma statistic
  18 .RI "{ " OBJECT " }"
  19 .B show
  20
  21 .ti -8
  22 .B rdma statistic
  23 .RI "[ " OBJECT " ]"
  24 .B show link
  25 .RI "[ " DEV/PORT_INDX " ]"
  26 .RI "[ " FILTER_NAME " " FILTER_VALUE " ]"
  27
  28 .ti -8
  29 .B rdma statistic
  30 .IR OBJECT
  31 .B mode
  32
  33 .ti -8
  34 .B rdma statistic
  35 .IR OBJECT
  36 .B set
  37 .IR COUNTER_SCOPE
  38 .RI "[ " DEV/PORT_INDEX " ]"
  39 .B auto
  40 .RI "{ " CRITERIA " | "
  41 .BR off " }"
  42
  43 .ti -8
  44 .B rdma statistic
  45 .IR OBJECT
  46 .B bind
  47 .IR COUNTER_SCOPE
  48 .RI "[ " DEV/PORT_INDEX " ]"
  49 .RI "[ " OBJECT-ID " ]"
  50 .RI "[ " COUNTER-ID " ]"
  51
  52 .ti -8
  53 .B rdma statistic
  54 .IR OBJECT
  55 .B unbind
  56 .IR COUNTER_SCOPE
  57 .RI "[ " DEV/PORT_INDEX " ]"
  58 .RI "[ " COUNTER-ID " ]"
  59 .RI "[ " OBJECT-ID " ]"
  60
  61 .ti -8
  62 .IR COUNTER_SCOPE " := "
  63 .RB "{ " link " | " dev " }"
  64
  65 .ti -8
  66 .IR OBJECT " := "
  67 .RB "{ " qp " | " mr " }"
  68
  69 .ti -8
  70 .IR CRITERIA " := "
  71 .RB "{ " type " | " pid " }"
  72
  73 .ti -8
  74 .IR FILTER_NAME " := "
  75 .RB "{ " cntn " | " lqpn " | " pid " | " qp-type " }"
  76
  77 .SH "DESCRIPTION"
  78 .SS 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
  79
  80 .PP
  81 .I "DEV"
  82 - specifies counters on this RDMA device to show.
  83
  84 .I "PORT_INDEX"
  85 - specifies counters on this RDMA port to show.
  86
  87 .I "FILTER_NAME
  88 - specifies a filter to show only the results matching it.
  89
  90 .SS rdma statistic <object> set - configure counter statistic auto-mode for a specific device/port
  91 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.
  92
  93 .SS rdma statistic <object> bind - manually bind an object (e.g., a qp) with a counter
  94 When bound the statistics of this object are available in this counter. Not applicable for MR's.
  95
  96 .SS rdma statistic <object> unbind - manually unbind an object (e.g., a qp) from the counter previously bound
  97 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.
  98
  99 .I "COUNTER-ID"
 100 - specifies the id of the counter to be bound.
 101 If this argument is omitted then a new counter will be allocated.
 102
 103 .SH "EXAMPLES"
 104 .PP
 105 rdma statistic show
 106 .RS 4
 107 Shows the state of the default counter of all RDMA devices on the system.
 108 .RE
 109 .PP
 110 rdma statistic show link mlx5_2/1
 111 .RS 4
 112 Shows the state of the default counter of specified RDMA port
 113 .RE
 114 .PP
 115 rdma statistic qp show
 116 .RS 4
 117 Shows the state of all qp counters of all RDMA devices on the system.
 118 .RE
 119 .PP
 120 rdma statistic qp show link mlx5_2/1
 121 .RS 4
 122 Shows the state of all qp counters of specified RDMA port.
 123 .RE
 124 .PP
 125 rdma statistic qp show link mlx5_2 pid 30489
 126 .RS 4
 127 Shows the state of all qp counters of specified RDMA port and belonging to pid 30489
 128 .RE
 129 .PP
 130 rdma statistic qp show link mlx5_2 qp-type UD
 131 .RS 4
 132 Shows the state of all qp counters of specified RDMA port and with QP type UD
 133 .RE
 134 .PP
 135 rdma statistic qp mode
 136 .RS 4
 137 List current counter mode on all devices
 138 .RE
 139 .PP
 140 rdma statistic qp mode link mlx5_2/1
 141 .RS 4
 142 List current counter mode of device mlx5_2 port 1
 143 .RE
 144 .PP
 145 rdma statistic qp set link mlx5_2/1 auto type on
 146 .RS 4
 147 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.
 148 .RE
 149 .PP
 150 rdma statistic qp set link mlx5_2/1 auto pid on
 151 .RS 4
 152 On device mlx5_2 port 1, for each new user QP bind it with a counter automatically. Per counter for QPs with same pid.
 153 .RE
 154 .PP
 155 rdma statistic qp set link mlx5_2/1 auto pid,type on
 156 .RS 4
 157 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.
 158 .RE
 159 .PP
 160 rdma statistic qp set link mlx5_2/1 auto off
 161 .RS 4
 162 Turn-off auto mode on device mlx5_2 port 1. The allocated counters can be manually accessed.
 163 .RE
 164 .PP
 165 rdma statistic qp bind link mlx5_2/1 lqpn 178
 166 .RS 4
 167 On device mlx5_2 port 1, allocate a counter and bind the specified qp on it
 168 .RE
 169 .PP
 170 rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
 171 .RS 4
 172 On device mlx5_2 port 1, bind the specified qp on the specified counter
 173 .RE
 174 .PP
 175 rdma statistic qp unbind link mlx5_2/1 cntn 4
 176 .RS 4
 177 On device mlx5_2 port 1, unbind all QPs on the specified counter. After that this counter will be released automatically by the kernel.
 178 .RE
 179 .PP
 180 rdma statistic show mr
 181 .RS 4
 182 List all currently allocated MR's and their counters.
 183 .RE
 184 .PP
 185 rdma statistic show mr mrn 6
 186 .RS 4
 187 Dump a specific MR statistics with mrn 6. Dumps nothing if does not exists.
 188 .RE
 189
 190 .SH SEE ALSO
 191 .BR rdma (8),
 192 .BR rdma-dev (8),
 193 .BR rdma-link (8),
 194 .BR rdma-resource (8),
 195 .br
 196
 197 .SH AUTHORS
 198 Mark Zhang <markz@mellanox.com>
 199 .br
 200 Erez Alfasi <ereza@mellanox.com>