1 sysfs interface common for all infiniband devi 1 sysfs interface common for all infiniband devices
2 ---------------------------------------------- 2 -------------------------------------------------
3 3
4 What: /sys/class/infiniband/<device> 4 What: /sys/class/infiniband/<device>/node_type
5 What: /sys/class/infiniband/<device> 5 What: /sys/class/infiniband/<device>/node_guid
6 What: /sys/class/infiniband/<device> 6 What: /sys/class/infiniband/<device>/sys_image_guid
7 Date: Apr, 2005 7 Date: Apr, 2005
8 KernelVersion: v2.6.12 8 KernelVersion: v2.6.12
9 Contact: linux-rdma@vger.kernel.org 9 Contact: linux-rdma@vger.kernel.org
10 Description: 10 Description:
11 =============== ============== <<
12 node_type: (RO) Node type 11 node_type: (RO) Node type (CA, RNIC, usNIC, usNIC UDP,
13 switch or rout 12 switch or router)
14 13
15 node_guid: (RO) Node GUID 14 node_guid: (RO) Node GUID
16 15
17 sys_image_guid: (RO) System im 16 sys_image_guid: (RO) System image GUID
18 =============== ============== <<
19 17
20 18
21 What: /sys/class/infiniband/<device> 19 What: /sys/class/infiniband/<device>/node_desc
22 Date: Feb, 2006 20 Date: Feb, 2006
23 KernelVersion: v2.6.17 21 KernelVersion: v2.6.17
24 Contact: linux-rdma@vger.kernel.org 22 Contact: linux-rdma@vger.kernel.org
25 Description: 23 Description:
26 (RW) Update the node descripti 24 (RW) Update the node description with information such as the
27 node's hostname, so that IB ne 25 node's hostname, so that IB network management software can tie
28 its view to the real world. 26 its view to the real world.
29 27
30 28
31 What: /sys/class/infiniband/<device> 29 What: /sys/class/infiniband/<device>/fw_ver
32 Date: Jun, 2016 30 Date: Jun, 2016
33 KernelVersion: v4.10 31 KernelVersion: v4.10
34 Contact: linux-rdma@vger.kernel.org 32 Contact: linux-rdma@vger.kernel.org
35 Description: 33 Description:
36 (RO) Display firmware version 34 (RO) Display firmware version
37 35
38 36
39 What: /sys/class/infiniband/<device> 37 What: /sys/class/infiniband/<device>/ports/<port-num>/lid
40 What: /sys/class/infiniband/<device> 38 What: /sys/class/infiniband/<device>/ports/<port-num>/rate
41 What: /sys/class/infiniband/<device> 39 What: /sys/class/infiniband/<device>/ports/<port-num>/lid_mask_count
42 What: /sys/class/infiniband/<device> 40 What: /sys/class/infiniband/<device>/ports/<port-num>/sm_sl
43 What: /sys/class/infiniband/<device> 41 What: /sys/class/infiniband/<device>/ports/<port-num>/sm_lid
44 What: /sys/class/infiniband/<device> 42 What: /sys/class/infiniband/<device>/ports/<port-num>/state
45 What: /sys/class/infiniband/<device> 43 What: /sys/class/infiniband/<device>/ports/<port-num>/phys_state
46 What: /sys/class/infiniband/<device> 44 What: /sys/class/infiniband/<device>/ports/<port-num>/cap_mask
47 Date: Apr, 2005 45 Date: Apr, 2005
48 KernelVersion: v2.6.12 46 KernelVersion: v2.6.12
49 Contact: linux-rdma@vger.kernel.org 47 Contact: linux-rdma@vger.kernel.org
50 Description: 48 Description:
51 49
52 =============== ============== <<
53 lid: (RO) Port LID 50 lid: (RO) Port LID
54 51
55 rate: (RO) Port data 52 rate: (RO) Port data rate (active width * active
56 speed) 53 speed)
57 54
58 lid_mask_count: (RO) Port LID 55 lid_mask_count: (RO) Port LID mask count
59 56
60 sm_sl: (RO) Subnet ma 57 sm_sl: (RO) Subnet manager SL for port's subnet
61 58
62 sm_lid: (RO) Subnet ma 59 sm_lid: (RO) Subnet manager LID for port's subnet
63 60
64 state: (RO) Port stat 61 state: (RO) Port state (DOWN, INIT, ARMED, ACTIVE or
65 ACTIVE_DEFER) 62 ACTIVE_DEFER)
66 63
67 phys_state: (RO) Port phys 64 phys_state: (RO) Port physical state (Sleep, Polling,
68 LinkUp, etc) 65 LinkUp, etc)
69 66
70 cap_mask: (RO) Port capa 67 cap_mask: (RO) Port capability mask. 2 bits here are
71 settable- IsCo 68 settable- IsCommunicationManagementSupported
72 (set when CM m !! 69 (set when CM module is loaded) and IsSM (set via
73 via open of is !! 70 open of issmN file).
74 =============== ============== <<
75 71
76 72
77 What: /sys/class/infiniband/<device> 73 What: /sys/class/infiniband/<device>/ports/<port-num>/link_layer
78 Date: Oct, 2010 74 Date: Oct, 2010
79 KernelVersion: v2.6.37 75 KernelVersion: v2.6.37
80 Contact: linux-rdma@vger.kernel.org 76 Contact: linux-rdma@vger.kernel.org
81 Description: 77 Description:
82 (RO) Link layer type informati 78 (RO) Link layer type information (Infiniband or Ethernet type)
83 79
84 80
85 What: /sys/class/infiniband/<device> 81 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/symbol_error
86 What: /sys/class/infiniband/<device> 82 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_errors
87 What: /sys/class/infiniband/<device> 83 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_remote_physical_errors
88 What: /sys/class/infiniband/<device> 84 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_switch_relay_errors
89 What: /sys/class/infiniband/<device> 85 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/link_error_recovery
90 What: /sys/class/infiniband/<device> 86 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_constraint_errors
91 What: /sys/class/infiniband/<device> 87 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_contraint_errors
92 What: /sys/class/infiniband/<device> 88 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/local_link_integrity_errors
93 What: /sys/class/infiniband/<device> 89 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/excessive_buffer_overrun_errors
94 What: /sys/class/infiniband/<device> 90 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_data
95 What: /sys/class/infiniband/<device> 91 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_data
96 What: /sys/class/infiniband/<device> 92 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_packets
97 What: /sys/class/infiniband/<device> 93 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_packets
98 What: /sys/class/infiniband/<device> 94 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_rcv_packets
99 What: /sys/class/infiniband/<device> 95 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_xmit_packets
100 What: /sys/class/infiniband/<device> 96 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_rcv_packets
101 What: /sys/class/infiniband/<device> 97 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_xmit_packets
102 What: /sys/class/infiniband/<device> 98 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/link_downed
103 What: /sys/class/infiniband/<device> 99 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_discards
104 What: /sys/class/infiniband/<device> 100 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/VL15_dropped
105 What: /sys/class/infiniband/<device> 101 What: /sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_wait
106 Date: Apr, 2005 102 Date: Apr, 2005
107 KernelVersion: v2.6.12 103 KernelVersion: v2.6.12
108 Contact: linux-rdma@vger.kernel.org 104 Contact: linux-rdma@vger.kernel.org
109 Description: 105 Description:
110 **Errors info**: !! 106 Errors info:
>> 107 -----------
111 108
112 symbol_error: (RO) Total numbe 109 symbol_error: (RO) Total number of minor link errors detected on
113 one or more physical lanes. 110 one or more physical lanes.
114 111
115 port_rcv_errors : (RO) Total n 112 port_rcv_errors : (RO) Total number of packets containing an
116 error that were received on th 113 error that were received on the port.
117 114
118 port_rcv_remote_physical_error 115 port_rcv_remote_physical_errors : (RO) Total number of packets
119 marked with the EBP delimiter 116 marked with the EBP delimiter received on the port.
120 117
121 port_rcv_switch_relay_errors : 118 port_rcv_switch_relay_errors : (RO) Total number of packets
122 received on the port that were 119 received on the port that were discarded because they could not
123 be forwarded by the switch rel 120 be forwarded by the switch relay.
124 121
125 link_error_recovery: (RO) Tota 122 link_error_recovery: (RO) Total number of times the Port
126 Training state machine has suc 123 Training state machine has successfully completed the link error
127 recovery process. 124 recovery process.
128 125
129 port_xmit_constraint_errors: ( 126 port_xmit_constraint_errors: (RO) Total number of packets not
130 transmitted from the switch ph 127 transmitted from the switch physical port due to outbound raw
131 filtering or failing outbound 128 filtering or failing outbound partition or IP version check.
132 129
133 port_rcv_constraint_errors: (R 130 port_rcv_constraint_errors: (RO) Total number of packets
134 received on the switch physica 131 received on the switch physical port that are discarded due to
135 inbound raw filtering or faili 132 inbound raw filtering or failing inbound partition or IP version
136 check. 133 check.
137 134
138 local_link_integrity_errors: ( 135 local_link_integrity_errors: (RO) The number of times that the
139 count of local physical errors 136 count of local physical errors exceeded the threshold specified
140 by LocalPhyErrors 137 by LocalPhyErrors
141 138
142 excessive_buffer_overrun_error 139 excessive_buffer_overrun_errors: (RO) This counter, indicates an
143 input buffer overrun. It indic 140 input buffer overrun. It indicates possible misconfiguration of
144 a port, either by the Subnet M 141 a port, either by the Subnet Manager (SM) or by user
145 intervention. It can also indi 142 intervention. It can also indicate hardware issues or extremely
146 poor link signal integrity 143 poor link signal integrity
147 144
148 **Data info**: !! 145 Data info:
>> 146 ---------
149 147
150 port_xmit_data: (RO) Total num 148 port_xmit_data: (RO) Total number of data octets, divided by 4
151 (lanes), transmitted on all VL 149 (lanes), transmitted on all VLs. This is 64 bit counter
152 150
153 port_rcv_data: (RO) Total numb 151 port_rcv_data: (RO) Total number of data octets, divided by 4
154 (lanes), received on all VLs. 152 (lanes), received on all VLs. This is 64 bit counter.
155 153
156 port_xmit_packets: (RO) Total 154 port_xmit_packets: (RO) Total number of packets transmitted on
157 all VLs from this port. This m 155 all VLs from this port. This may include packets with errors.
158 This is 64 bit counter. 156 This is 64 bit counter.
159 157
160 port_rcv_packets: (RO) Total n 158 port_rcv_packets: (RO) Total number of packets (this may include
161 packets containing Errors. Thi 159 packets containing Errors. This is 64 bit counter.
162 160
163 link_downed: (RO) Total number 161 link_downed: (RO) Total number of times the Port Training state
164 machine has failed the link er 162 machine has failed the link error recovery process and downed
165 the link. 163 the link.
166 164
167 unicast_rcv_packets: (RO) Tota 165 unicast_rcv_packets: (RO) Total number of unicast packets,
168 including unicast packets cont 166 including unicast packets containing errors.
169 167
170 unicast_xmit_packets: (RO) Tot 168 unicast_xmit_packets: (RO) Total number of unicast packets
171 transmitted on all VLs from th 169 transmitted on all VLs from the port. This may include unicast
172 packets with errors. 170 packets with errors.
173 171
174 multicast_rcv_packets: (RO) To 172 multicast_rcv_packets: (RO) Total number of multicast packets,
175 including multicast packets co 173 including multicast packets containing errors.
176 174
177 multicast_xmit_packets: (RO) T 175 multicast_xmit_packets: (RO) Total number of multicast packets
178 transmitted on all VLs from th 176 transmitted on all VLs from the port. This may include multicast
179 packets with errors. 177 packets with errors.
180 178
181 **Misc info**: !! 179 Misc info:
>> 180 ---------
182 181
183 port_xmit_discards: (RO) Total 182 port_xmit_discards: (RO) Total number of outbound packets
184 discarded by the port because 183 discarded by the port because the port is down or congested.
185 184
186 VL15_dropped: (RO) Number of i 185 VL15_dropped: (RO) Number of incoming VL15 packets dropped due
187 to resource limitations (e.g., 186 to resource limitations (e.g., lack of buffers) of the port.
188 187
189 port_xmit_wait: (RO) The numbe 188 port_xmit_wait: (RO) The number of ticks during which the port
190 had data to transmit but no da 189 had data to transmit but no data was sent during the entire tick
191 (either because of insufficien 190 (either because of insufficient credits or because of lack of
192 arbitration). 191 arbitration).
193 192
194 Each of these files contains t 193 Each of these files contains the corresponding value from the
195 port's Performance Management 194 port's Performance Management PortCounters attribute, as
196 described in the InfiniBand Ar 195 described in the InfiniBand Architecture Specification.
197 196
198 197
199 What: /sys/class/infiniband/<device- 198 What: /sys/class/infiniband/<device-name>/hw_counters/lifespan
200 What: /sys/class/infiniband/<device- 199 What: /sys/class/infiniband/<device-name>/ports/<port-num>/hw_counters/lifespan
201 Date: May, 2016 200 Date: May, 2016
202 KernelVersion: 4.6 201 KernelVersion: 4.6
203 Contact: linux-rdma@vger.kernel.org 202 Contact: linux-rdma@vger.kernel.org
204 Description: 203 Description:
205 The optional "hw_counters" sub 204 The optional "hw_counters" subdirectory can be under either the
206 parent device or the port subd 205 parent device or the port subdirectories or both. If present,
207 there are a list of counters p 206 there are a list of counters provided by the hardware. They may
208 match some of the counters in 207 match some of the counters in the counters directory, but they
209 often include many other count 208 often include many other counters. In addition to the various
210 counters, there will be a file 209 counters, there will be a file named "lifespan" that configures
211 how frequently the core should 210 how frequently the core should update the counters when they are
212 being accessed (counters are n 211 being accessed (counters are not updated if they are not being
213 accessed). The lifespan is in 212 accessed). The lifespan is in milliseconds and defaults to 10
214 unless set to something else b 213 unless set to something else by the driver. Users may echo a
215 value between 0-10000 to the l 214 value between 0-10000 to the lifespan file to set the length
216 of time between updates in mil 215 of time between updates in milliseconds.
217 216
218 217
219 What: /sys/class/infiniband/<hca>/po 218 What: /sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/ndevs/<gid-index>
220 Date: November 29, 2015 219 Date: November 29, 2015
221 KernelVersion: 4.4.0 220 KernelVersion: 4.4.0
222 Contact: linux-rdma@vger.kernel.org 221 Contact: linux-rdma@vger.kernel.org
223 Description: The net-device's name associat 222 Description: The net-device's name associated with the GID resides
224 at index <gid-index>. 223 at index <gid-index>.
225 224
226 What: /sys/class/infiniband/<hca>/po 225 What: /sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/types/<gid-index>
227 Date: November 29, 2015 226 Date: November 29, 2015
228 KernelVersion: 4.4.0 227 KernelVersion: 4.4.0
229 Contact: linux-rdma@vger.kernel.org 228 Contact: linux-rdma@vger.kernel.org
230 Description: The RoCE type of the associate 229 Description: The RoCE type of the associated GID resides at index <gid-index>.
231 This could either be "IB/RoCE 230 This could either be "IB/RoCE v1" for IB and RoCE v1 based GIDs
232 or "RoCE v2" for RoCE v2 based 231 or "RoCE v2" for RoCE v2 based GIDs.
233 232
234 233
235 What: /sys/class/infiniband_mad/umad !! 234 What: /sys/class/infiniband_mad/umadN/ibdev
236 What: /sys/class/infiniband_mad/umad !! 235 What: /sys/class/infiniband_mad/umadN/port
237 What: /sys/class/infiniband_mad/issm !! 236 What: /sys/class/infiniband_mad/issmN/ibdev
238 What: /sys/class/infiniband_mad/issm !! 237 What: /sys/class/infiniband_mad/issmN/port
239 Date: Apr, 2005 238 Date: Apr, 2005
240 KernelVersion: v2.6.12 239 KernelVersion: v2.6.12
241 Contact: linux-rdma@vger.kernel.org 240 Contact: linux-rdma@vger.kernel.org
242 Description: 241 Description:
243 Each port of each InfiniBand d 242 Each port of each InfiniBand device has a "umad" device and an
244 "issm" device attached. For ex 243 "issm" device attached. For example, a two-port HCA will have
245 two umad devices and two issm 244 two umad devices and two issm devices, while a switch will have
246 one device of each type (for s 245 one device of each type (for switch port 0).
247 246
248 ======= ====================== <<
249 ibdev: (RO) Show Infiniband ( 247 ibdev: (RO) Show Infiniband (IB) device name
250 248
251 port: (RO) Display port numb 249 port: (RO) Display port number
252 ======= ====================== <<
253 250
254 251
255 What: /sys/class/infiniband_mad/abi_ 252 What: /sys/class/infiniband_mad/abi_version
256 Date: Apr, 2005 253 Date: Apr, 2005
257 KernelVersion: v2.6.12 254 KernelVersion: v2.6.12
258 Contact: linux-rdma@vger.kernel.org 255 Contact: linux-rdma@vger.kernel.org
259 Description: 256 Description:
260 (RO) Value is incremented if a 257 (RO) Value is incremented if any changes are made that break
261 userspace ABI compatibility of 258 userspace ABI compatibility of umad & issm devices.
262 259
263 260
264 What: /sys/class/infiniband_verbs/uv !! 261 What: /sys/class/infiniband_cm/ucmN/ibdev
265 What: /sys/class/infiniband_verbs/uv !! 262 Date: Oct, 2005
>> 263 KernelVersion: v2.6.14
>> 264 Contact: linux-rdma@vger.kernel.org
>> 265 Description:
>> 266 (RO) Display Infiniband (IB) device name
>> 267
>> 268
>> 269 What: /sys/class/infiniband_cm/abi_version
>> 270 Date: Oct, 2005
>> 271 KernelVersion: v2.6.14
>> 272 Contact: linux-rdma@vger.kernel.org
>> 273 Description:
>> 274 (RO) Value is incremented if any changes are made that break
>> 275 userspace ABI compatibility of ucm devices.
>> 276
>> 277
>> 278 What: /sys/class/infiniband_verbs/uverbsN/ibdev
>> 279 What: /sys/class/infiniband_verbs/uverbsN/abi_version
266 Date: Sept, 2005 280 Date: Sept, 2005
267 KernelVersion: v2.6.14 281 KernelVersion: v2.6.14
268 Contact: linux-rdma@vger.kernel.org 282 Contact: linux-rdma@vger.kernel.org
269 Description: 283 Description:
270 =============== ============== <<
271 ibdev: (RO) Display I 284 ibdev: (RO) Display Infiniband (IB) device name
272 285
273 abi_version: (RO) Show ABI 286 abi_version: (RO) Show ABI version of IB device specific
274 interfaces. 287 interfaces.
275 =============== ============== <<
276 288
277 289
278 What: /sys/class/infiniband_verbs/ab 290 What: /sys/class/infiniband_verbs/abi_version
279 Date: Sep, 2005 291 Date: Sep, 2005
280 KernelVersion: v2.6.14 292 KernelVersion: v2.6.14
281 Contact: linux-rdma@vger.kernel.org 293 Contact: linux-rdma@vger.kernel.org
282 Description: 294 Description:
283 (RO) Value is incremented if a 295 (RO) Value is incremented if any changes are made that break
284 userspace ABI compatibility of 296 userspace ABI compatibility of uverbs devices.
285 297
286 298
287 sysfs interface for Mellanox IB HCA low-level 299 sysfs interface for Mellanox IB HCA low-level driver (mthca)
288 ---------------------------------------------- 300 ------------------------------------------------------------
289 301
290 What: /sys/class/infiniband/mthcaX/h 302 What: /sys/class/infiniband/mthcaX/hw_rev
291 What: /sys/class/infiniband/mthcaX/h 303 What: /sys/class/infiniband/mthcaX/hca_type
292 What: /sys/class/infiniband/mthcaX/b 304 What: /sys/class/infiniband/mthcaX/board_id
293 Date: Apr, 2005 305 Date: Apr, 2005
294 KernelVersion: v2.6.12 306 KernelVersion: v2.6.12
295 Contact: linux-rdma@vger.kernel.org 307 Contact: linux-rdma@vger.kernel.org
296 Description: 308 Description:
297 =============== ============== <<
298 hw_rev: (RO) Hardware 309 hw_rev: (RO) Hardware revision number
299 310
300 hca_type: (RO) Host Chan 311 hca_type: (RO) Host Channel Adapter type: MT23108, MT25208
301 (MT23108 compa 312 (MT23108 compat mode), MT25208 or MT25204
302 313
303 board_id: (RO) Manufactu 314 board_id: (RO) Manufacturing board ID
304 =============== ============== <<
305 315
306 316
307 sysfs interface for Mellanox ConnectX HCA IB d 317 sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
308 ---------------------------------------------- 318 ----------------------------------------------------------
309 319
310 What: /sys/class/infiniband/mlx4_X/h 320 What: /sys/class/infiniband/mlx4_X/hw_rev
311 What: /sys/class/infiniband/mlx4_X/h 321 What: /sys/class/infiniband/mlx4_X/hca_type
312 What: /sys/class/infiniband/mlx4_X/b 322 What: /sys/class/infiniband/mlx4_X/board_id
313 Date: Sep, 2007 323 Date: Sep, 2007
314 KernelVersion: v2.6.24 324 KernelVersion: v2.6.24
315 Contact: linux-rdma@vger.kernel.org 325 Contact: linux-rdma@vger.kernel.org
316 Description: 326 Description:
317 =============== ============== <<
318 hw_rev: (RO) Hardware 327 hw_rev: (RO) Hardware revision number
319 328
320 hca_type: (RO) Host chan 329 hca_type: (RO) Host channel adapter type
321 330
322 board_id: (RO) Manufactu 331 board_id: (RO) Manufacturing board ID
323 =============== ============== <<
324 332
325 333
326 What: /sys/class/infiniband/mlx4_X/i 334 What: /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
327 What: /sys/class/infiniband/mlx4_X/i 335 What: /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/admin_guids/<n>
328 What: /sys/class/infiniband/mlx4_X/i 336 What: /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/pkeys/<n>
329 What: /sys/class/infiniband/mlx4_X/i 337 What: /sys/class/infiniband/mlx4_X/iov/ports/<port-num>/mcgs/
330 What: /sys/class/infiniband/mlx4_X/i 338 What: /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/gid_idx/0
331 What: /sys/class/infiniband/mlx4_X/i 339 What: /sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/pkey_idx/<n>
332 Date: Aug, 2012 340 Date: Aug, 2012
333 KernelVersion: v3.6.15 341 KernelVersion: v3.6.15
334 Contact: linux-rdma@vger.kernel.org 342 Contact: linux-rdma@vger.kernel.org
335 Description: 343 Description:
336 The sysfs iov directory is use 344 The sysfs iov directory is used to manage and examine the port
337 P_Key and guid paravirtualizat 345 P_Key and guid paravirtualization. This directory is added only
338 for the master -- slaves do no 346 for the master -- slaves do not have it.
339 347
340 Under iov/ports, the administr 348 Under iov/ports, the administrator may examine the gid and P_Key
341 tables as they are present in 349 tables as they are present in the device (and as are seen in the
342 "network view" presented to th 350 "network view" presented to the SM).
343 351
344 The "pkeys" and "gids" subdire 352 The "pkeys" and "gids" subdirectories contain one file for each
345 entry in the port's P_Key or G 353 entry in the port's P_Key or GID table respectively. For
346 example, ports/1/pkeys/10 cont 354 example, ports/1/pkeys/10 contains the value at index 10 in port
347 1's P_Key table. 355 1's P_Key table.
348 356
349 ======================= ====== <<
350 gids/<n>: (RO) T 357 gids/<n>: (RO) The physical port gids n = 0..127
351 358
352 admin_guids/<n>: (RW) A 359 admin_guids/<n>: (RW) Allows examining or changing the
353 admini 360 administrative state of a given GUID
354 n = 0. 361 n = 0..127
355 362
356 pkeys/<n>: (RO) D 363 pkeys/<n>: (RO) Displays the contents of the physical
357 key ta 364 key table n = 0..126
358 365
359 mcgs/: (RO) M !! 366 mcgs/: (RO) Muticast group table
360 367
361 <m>/gid_idx/0: (RO) D 368 <m>/gid_idx/0: (RO) Display the GID mapping m = 1..2
362 369
363 <m>/pkey_idx/<n>: (RW) W 370 <m>/pkey_idx/<n>: (RW) Writable except for RoCE pkeys.
364 m = 1. 371 m = 1..2, n = 0..126
365 372
366 Under 373 Under the iov/<pci slot number>
367 direct 374 directories, the admin may map the index
368 number 375 numbers in the physical tables (as under
369 iov/po 376 iov/ports) to the paravirtualized index
370 number 377 numbers that guests see.
371 378
372 For ex 379 For example, if the administrator, for
373 port 1 380 port 1 on guest 2 maps physical pkey
374 index 381 index 10 to virtual index 1, then that
375 guest, 382 guest, whenever it uses its pkey index
376 1, wil 383 1, will actually be using the real pkey
377 index 384 index 10.
378 ======================= ====== <<
379 385
380 386
381 What: /sys/class/infiniband/mlx4_X/i 387 What: /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
382 What: /sys/class/infiniband/mlx4_X/i 388 What: /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/enable_smi_admin
383 Date: May, 2014 389 Date: May, 2014
384 KernelVersion: v3.15.7 390 KernelVersion: v3.15.7
385 Contact: linux-rdma@vger.kernel.org 391 Contact: linux-rdma@vger.kernel.org
386 Description: 392 Description:
387 Enabling QP0 on VFs for select 393 Enabling QP0 on VFs for selected VF/port. By default, no VFs are
388 enabled for QP0 operation. 394 enabled for QP0 operation.
389 395
390 ================= ==== ======= !! 396 smi_enabled: (RO) Indicates whether smi is currently enabled
391 smi_enabled: (RO) Indicat !! 397 for the indicated VF/port
392 for the !! 398
393 !! 399 enable_smi_admin:(RW) Used by the admin to request that smi
394 enable_smi_admin: (RW) Used by !! 400 capability be enabled or disabled for the
395 capabil !! 401 indicated VF/port. 0 = disable, 1 = enable.
396 indicat <<
397 ================= ==== ======= <<
398 402
399 The requested enablement will 403 The requested enablement will occur at the next reset of the VF
400 (e.g. driver restart on the VM 404 (e.g. driver restart on the VM which owns the VF).
401 405
402 406
403 sysfs interface for Chelsio T4/T5 RDMA driver 407 sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
404 ---------------------------------------------- 408 -----------------------------------------------------
405 409
406 What: /sys/class/infiniband/cxgb4_X/ 410 What: /sys/class/infiniband/cxgb4_X/hw_rev
407 What: /sys/class/infiniband/cxgb4_X/ 411 What: /sys/class/infiniband/cxgb4_X/hca_type
408 What: /sys/class/infiniband/cxgb4_X/ 412 What: /sys/class/infiniband/cxgb4_X/board_id
409 Date: Apr, 2010 413 Date: Apr, 2010
410 KernelVersion: v2.6.35 414 KernelVersion: v2.6.35
411 Contact: linux-rdma@vger.kernel.org 415 Contact: linux-rdma@vger.kernel.org
412 Description: 416 Description:
413 417
414 =============== ============== <<
415 hw_rev: (RO) Hardware 418 hw_rev: (RO) Hardware revision number
416 419
417 hca_type: (RO) Driver sh 420 hca_type: (RO) Driver short name. Should normally match
418 the name in it 421 the name in its bus driver structure (e.g.
419 pci_driver::na 422 pci_driver::name)
420 423
421 board_id: (RO) Manufactu 424 board_id: (RO) Manufacturing board id. (Vendor + device
422 information) 425 information)
423 =============== ============== <<
424 426
425 427
426 sysfs interface for Intel IB driver qib 428 sysfs interface for Intel IB driver qib
427 --------------------------------------- 429 ---------------------------------------
428 430
429 What: /sys/class/infiniband/qibX/ver 431 What: /sys/class/infiniband/qibX/version
430 What: /sys/class/infiniband/qibX/hw_ 432 What: /sys/class/infiniband/qibX/hw_rev
431 What: /sys/class/infiniband/qibX/hca 433 What: /sys/class/infiniband/qibX/hca_type
432 What: /sys/class/infiniband/qibX/boa 434 What: /sys/class/infiniband/qibX/board_id
433 What: /sys/class/infiniband/qibX/boa 435 What: /sys/class/infiniband/qibX/boardversion
434 What: /sys/class/infiniband/qibX/nct 436 What: /sys/class/infiniband/qibX/nctxts
435 What: /sys/class/infiniband/qibX/loc 437 What: /sys/class/infiniband/qibX/localbus_info
436 What: /sys/class/infiniband/qibX/tem 438 What: /sys/class/infiniband/qibX/tempsense
437 What: /sys/class/infiniband/qibX/ser 439 What: /sys/class/infiniband/qibX/serial
438 What: /sys/class/infiniband/qibX/nfr 440 What: /sys/class/infiniband/qibX/nfreectxts
439 What: /sys/class/infiniband/qibX/chi 441 What: /sys/class/infiniband/qibX/chip_reset
440 Date: May, 2010 442 Date: May, 2010
441 KernelVersion: v2.6.35 443 KernelVersion: v2.6.35
442 Contact: linux-rdma@vger.kernel.org 444 Contact: linux-rdma@vger.kernel.org
443 Description: 445 Description:
444 =============== ============== <<
445 version: (RO) Display v 446 version: (RO) Display version information of installed software
446 and drivers. 447 and drivers.
447 448
448 hw_rev: (RO) Hardware 449 hw_rev: (RO) Hardware revision number
449 450
450 hca_type: (RO) Host chan 451 hca_type: (RO) Host channel adapter type
451 452
452 board_id: (RO) Manufactu 453 board_id: (RO) Manufacturing board id
453 454
454 boardversion: (RO) Current v 455 boardversion: (RO) Current version of the chip architecture
455 456
456 nctxts: (RO) Return th 457 nctxts: (RO) Return the number of user ports (contexts)
457 available 458 available
458 459
459 localbus_info: (RO) Human rea 460 localbus_info: (RO) Human readable localbus info
460 461
461 tempsense: (RO) Display t 462 tempsense: (RO) Display temp sense registers in decimal
462 463
463 serial: (RO) Serial nu 464 serial: (RO) Serial number of the HCA
464 465
465 nfreectxts: (RO) The numbe 466 nfreectxts: (RO) The number of free user ports (contexts)
466 available. 467 available.
467 468
468 chip_reset: (WO) Reset the 469 chip_reset: (WO) Reset the chip if possible by writing
469 "reset" to thi 470 "reset" to this file. Only allowed if no user
470 contexts are o 471 contexts are open that use chip resources.
471 =============== ============== <<
472 472
473 473
474 What: /sys/class/infiniband/qibX/por !! 474 What: /sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
475 Date: May, 2010 475 Date: May, 2010
476 KernelVersion: v2.6.35 476 KernelVersion: v2.6.35
477 Contact: linux-rdma@vger.kernel.org 477 Contact: linux-rdma@vger.kernel.org
478 Description: 478 Description:
479 (RO) The directory contains 16 479 (RO) The directory contains 16 files numbered 0-15 that specify
480 the Service Level (SL). Listin 480 the Service Level (SL). Listing the SL files returns the Virtual
481 Lane (VL) as programmed by the 481 Lane (VL) as programmed by the SL.
482 482
483 What: /sys/class/infiniband/qibX/por !! 483 What: /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_settings_bin
484 What: /sys/class/infiniband/qibX/por !! 484 What: /sys/class/infiniband/qibX/ports/N/CCMgtA/cc_table_bin
485 Date: May, 2010 485 Date: May, 2010
486 KernelVersion: v2.6.35 486 KernelVersion: v2.6.35
487 Contact: linux-rdma@vger.kernel.org 487 Contact: linux-rdma@vger.kernel.org
488 Description: 488 Description:
489 Per-port congestion control. B 489 Per-port congestion control. Both are binary attributes.
490 490
491 =============== ============== !! 491 cc_table_bin: (RO) Congestion control table size followed by
492 cc_table_bin (RO) Congestio <<
493 table entries. 492 table entries.
494 493
495 cc_settings_bin (RO) Congestio !! 494 cc_settings_bin:(RO) Congestion settings: port control, control
496 map and an arr 495 map and an array of 16 entries for the
497 congestion ent 496 congestion entries - increase, timer, event log
498 trigger thresh 497 trigger threshold and the minimum injection rate
499 delay. 498 delay.
500 =============== ============== <<
501 499
502 What: /sys/class/infiniband/qibX/por !! 500 What: /sys/class/infiniband/qibX/ports/N/linkstate/loopback
503 What: /sys/class/infiniband/qibX/por !! 501 What: /sys/class/infiniband/qibX/ports/N/linkstate/led_override
504 What: /sys/class/infiniband/qibX/por !! 502 What: /sys/class/infiniband/qibX/ports/N/linkstate/hrtbt_enable
505 What: /sys/class/infiniband/qibX/por !! 503 What: /sys/class/infiniband/qibX/ports/N/linkstate/status
506 What: /sys/class/infiniband/qibX/por !! 504 What: /sys/class/infiniband/qibX/ports/N/linkstate/status_str
507 Date: May, 2010 505 Date: May, 2010
508 KernelVersion: v2.6.35 506 KernelVersion: v2.6.35
509 Contact: linux-rdma@vger.kernel.org 507 Contact: linux-rdma@vger.kernel.org
510 Description: 508 Description:
511 [to be documented] 509 [to be documented]
512 510
513 =============== ============== <<
514 loopback: (WO) 511 loopback: (WO)
515 led_override: (WO) 512 led_override: (WO)
516 hrtbt_enable: (RW) 513 hrtbt_enable: (RW)
517 status: (RO) 514 status: (RO)
518 515
519 status_str: (RO) Displays 516 status_str: (RO) Displays information about the link state,
520 possible cable 517 possible cable/switch problems, and hardware
521 errors. Possib 518 errors. Possible states are- "Initted",
522 "Present", "IB 519 "Present", "IB_link_up", "IB_configured" or
523 "Fatal_Hardwar 520 "Fatal_Hardware_Error".
524 =============== ============== <<
525 521
526 What: /sys/class/infiniband/qibX/por !! 522 What: /sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
527 What: /sys/class/infiniband/qibX/por !! 523 What: /sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
528 What: /sys/class/infiniband/qibX/por !! 524 What: /sys/class/infiniband/qibX/ports/N/diag_counters/rdma_seq
529 What: /sys/class/infiniband/qibX/por !! 525 What: /sys/class/infiniband/qibX/ports/N/diag_counters/rnr_naks
530 What: /sys/class/infiniband/qibX/por !! 526 What: /sys/class/infiniband/qibX/ports/N/diag_counters/other_naks
531 What: /sys/class/infiniband/qibX/por !! 527 What: /sys/class/infiniband/qibX/ports/N/diag_counters/rc_timeouts
532 What: /sys/class/infiniband/qibX/por !! 528 What: /sys/class/infiniband/qibX/ports/N/diag_counters/look_pkts
533 What: /sys/class/infiniband/qibX/por !! 529 What: /sys/class/infiniband/qibX/ports/N/diag_counters/pkt_drops
534 What: /sys/class/infiniband/qibX/por !! 530 What: /sys/class/infiniband/qibX/ports/N/diag_counters/dma_wait
535 What: /sys/class/infiniband/qibX/por !! 531 What: /sys/class/infiniband/qibX/ports/N/diag_counters/unaligned
536 Date: May, 2010 532 Date: May, 2010
537 KernelVersion: v2.6.35 533 KernelVersion: v2.6.35
538 Contact: linux-rdma@vger.kernel.org 534 Contact: linux-rdma@vger.kernel.org
539 Description: 535 Description:
540 [to be documented] 536 [to be documented]
541 537
542 538
543 sysfs interface for Mellanox Connect-IB HCA dr 539 sysfs interface for Mellanox Connect-IB HCA driver mlx5
544 ---------------------------------------------- 540 -------------------------------------------------------
545 541
546 What: /sys/class/infiniband/mlx5_X/h 542 What: /sys/class/infiniband/mlx5_X/hw_rev
547 What: /sys/class/infiniband/mlx5_X/h 543 What: /sys/class/infiniband/mlx5_X/hca_type
548 What: /sys/class/infiniband/mlx5_X/r 544 What: /sys/class/infiniband/mlx5_X/reg_pages
549 What: /sys/class/infiniband/mlx5_X/f 545 What: /sys/class/infiniband/mlx5_X/fw_pages
550 Date: Jul, 2013 546 Date: Jul, 2013
551 KernelVersion: v3.11 547 KernelVersion: v3.11
552 Contact: linux-rdma@vger.kernel.org 548 Contact: linux-rdma@vger.kernel.org
553 Description: 549 Description:
554 [to be documented] 550 [to be documented]
555 551
556 552
557 sysfs interface for Cisco VIC (usNIC) Verbs Dr 553 sysfs interface for Cisco VIC (usNIC) Verbs Driver
558 ---------------------------------------------- 554 --------------------------------------------------
559 555
560 What: /sys/class/infiniband/usnic_X/ 556 What: /sys/class/infiniband/usnic_X/board_id
561 What: /sys/class/infiniband/usnic_X/ 557 What: /sys/class/infiniband/usnic_X/config
562 What: /sys/class/infiniband/usnic_X/ 558 What: /sys/class/infiniband/usnic_X/qp_per_vf
563 What: /sys/class/infiniband/usnic_X/ 559 What: /sys/class/infiniband/usnic_X/max_vf
564 What: /sys/class/infiniband/usnic_X/ 560 What: /sys/class/infiniband/usnic_X/cq_per_vf
565 What: /sys/class/infiniband/usnic_X/ 561 What: /sys/class/infiniband/usnic_X/iface
566 Date: Sep, 2013 562 Date: Sep, 2013
567 KernelVersion: v3.14 563 KernelVersion: v3.14
568 Contact: Christian Benvenuti <benve@cisc 564 Contact: Christian Benvenuti <benve@cisco.com>,
569 Dave Goodell <dgoodell@cisco.co 565 Dave Goodell <dgoodell@cisco.com>,
570 linux-rdma@vger.kernel.org 566 linux-rdma@vger.kernel.org
571 Description: 567 Description:
572 568
573 =============== ============== <<
574 board_id: (RO) Manufactu 569 board_id: (RO) Manufacturing board id
575 570
576 config: (RO) Report th 571 config: (RO) Report the configuration for this PF
577 572
578 qp_per_vf: (RO) Queue pai 573 qp_per_vf: (RO) Queue pairs per virtual function.
579 574
580 max_vf: (RO) Max virtu 575 max_vf: (RO) Max virtual functions
581 576
582 cq_per_vf: (RO) Completio 577 cq_per_vf: (RO) Completion queue per virtual function
583 578
584 iface: (RO) Shows whi 579 iface: (RO) Shows which network interface this usNIC
585 entry is assoc 580 entry is associated to (visible with ifconfig).
586 =============== ============== <<
587 581
588 What: /sys/class/infiniband/usnic_X/ 582 What: /sys/class/infiniband/usnic_X/qpn/summary
589 What: /sys/class/infiniband/usnic_X/ 583 What: /sys/class/infiniband/usnic_X/qpn/context
590 Date: Sep, 2013 584 Date: Sep, 2013
591 KernelVersion: v3.14 585 KernelVersion: v3.14
592 Contact: Christian Benvenuti <benve@cisc 586 Contact: Christian Benvenuti <benve@cisco.com>,
593 Dave Goodell <dgoodell@cisco.co 587 Dave Goodell <dgoodell@cisco.com>,
594 linux-rdma@vger.kernel.org 588 linux-rdma@vger.kernel.org
595 Description: 589 Description:
596 [to be documented] 590 [to be documented]
597 591
598 592
599 sysfs interface for Emulex RoCE HCA Driver 593 sysfs interface for Emulex RoCE HCA Driver
600 ------------------------------------------ 594 ------------------------------------------
601 595
602 What: /sys/class/infiniband/ocrdmaX/ 596 What: /sys/class/infiniband/ocrdmaX/hw_rev
603 Date: Feb, 2014 597 Date: Feb, 2014
604 KernelVersion: v3.14 598 KernelVersion: v3.14
605 Description: 599 Description:
606 hw_rev: (RO) Hardware 600 hw_rev: (RO) Hardware revision number
607 601
608 What: /sys/class/infiniband/ocrdmaX/ 602 What: /sys/class/infiniband/ocrdmaX/hca_type
609 Date: Jun, 2014 603 Date: Jun, 2014
610 KernelVersion: v3.16 604 KernelVersion: v3.16
611 Contact: linux-rdma@vger.kernel.org 605 Contact: linux-rdma@vger.kernel.org
612 Description: 606 Description:
613 hca_type: (RO) Display F 607 hca_type: (RO) Display FW version
614 608
615 609
616 sysfs interface for Intel Omni-Path driver (HF 610 sysfs interface for Intel Omni-Path driver (HFI1)
617 ---------------------------------------------- 611 -------------------------------------------------
618 612
619 What: /sys/class/infiniband/hfi1_X/h 613 What: /sys/class/infiniband/hfi1_X/hw_rev
620 What: /sys/class/infiniband/hfi1_X/b 614 What: /sys/class/infiniband/hfi1_X/board_id
621 What: /sys/class/infiniband/hfi1_X/n 615 What: /sys/class/infiniband/hfi1_X/nctxts
622 What: /sys/class/infiniband/hfi1_X/s 616 What: /sys/class/infiniband/hfi1_X/serial
623 What: /sys/class/infiniband/hfi1_X/c 617 What: /sys/class/infiniband/hfi1_X/chip_reset
624 What: /sys/class/infiniband/hfi1_X/b 618 What: /sys/class/infiniband/hfi1_X/boardversion
625 What: /sys/class/infiniband/hfi1_X/n 619 What: /sys/class/infiniband/hfi1_X/nfreectxts
626 What: /sys/class/infiniband/hfi1_X/t 620 What: /sys/class/infiniband/hfi1_X/tempsense
627 Date: May, 2016 621 Date: May, 2016
628 KernelVersion: v4.6 622 KernelVersion: v4.6
629 Contact: linux-rdma@vger.kernel.org 623 Contact: linux-rdma@vger.kernel.org
630 Description: 624 Description:
631 =============== ============== <<
632 hw_rev: (RO) Hardware 625 hw_rev: (RO) Hardware revision number
633 626
634 board_id: (RO) Manufactu 627 board_id: (RO) Manufacturing board id
635 628
636 nctxts: (RO) Total con 629 nctxts: (RO) Total contexts available.
637 630
638 serial: (RO) Board ser 631 serial: (RO) Board serial number
639 632
640 chip_reset: (WO) Write "re 633 chip_reset: (WO) Write "reset" to this file to reset the
641 chip if possib 634 chip if possible. Only allowed if no user
642 contexts are o 635 contexts are open that use chip resources.
643 636
644 boardversion: (RO) Human rea 637 boardversion: (RO) Human readable board info
645 638
646 nfreectxts: (RO) The numbe 639 nfreectxts: (RO) The number of free user ports (contexts)
647 available. 640 available.
648 641
649 tempsense: (RO) Thermal s 642 tempsense: (RO) Thermal sense information
650 =============== ============== <<
651 643
652 644
653 What: /sys/class/infiniband/hfi1_X/p !! 645 What: /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
654 What: /sys/class/infiniband/hfi1_X/p !! 646 What: /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_table_bin
655 What: /sys/class/infiniband/hfi1_X/p !! 647 What: /sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_prescan
656 Date: May, 2016 648 Date: May, 2016
657 KernelVersion: v4.6 649 KernelVersion: v4.6
658 Contact: linux-rdma@vger.kernel.org 650 Contact: linux-rdma@vger.kernel.org
659 Description: 651 Description:
660 Per-port congestion control. 652 Per-port congestion control.
661 653
662 =============== ============== !! 654 cc_table_bin: (RO) CCA tables used by PSM2 Congestion control
663 cc_table_bin (RO) CCA table <<
664 table size fol 655 table size followed by table entries. Binary
665 attribute. 656 attribute.
666 657
667 cc_settings_bin (RO) Congestio !! 658 cc_settings_bin:(RO) Congestion settings: port control, control
668 map and an arr 659 map and an array of 16 entries for the
669 congestion ent 660 congestion entries - increase, timer, event log
670 trigger thresh 661 trigger threshold and the minimum injection rate
671 delay. Binary 662 delay. Binary attribute.
672 663
673 cc_prescan (RW) enable pr !! 664 cc_prescan: (RW) enable prescanning for faster BECN
674 response. Writ 665 response. Write "on" to enable and "off" to
675 disable. 666 disable.
676 =============== ============== <<
677 667
678 What: /sys/class/infiniband/hfi1_X/p !! 668 What: /sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
679 What: /sys/class/infiniband/hfi1_X/p !! 669 What: /sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
680 What: /sys/class/infiniband/hfi1_X/p !! 670 What: /sys/class/infiniband/hfi1_X/ports/N/vl2mtu/[0-15]
681 Date: May, 2016 671 Date: May, 2016
682 KernelVersion: v4.6 672 KernelVersion: v4.6
683 Contact: linux-rdma@vger.kernel.org 673 Contact: linux-rdma@vger.kernel.org
684 Description: 674 Description:
685 =============== ============== <<
686 sc2vl/: (RO) 32 files 675 sc2vl/: (RO) 32 files (0 - 31) used to translate sl->vl
687 676
688 sl2sc/: (RO) 32 files 677 sl2sc/: (RO) 32 files (0 - 31) used to translate sl->sc
689 678
690 vl2mtu/: (RO) 16 files 679 vl2mtu/: (RO) 16 files (0 - 15) used to determine MTU for vl
691 =============== ============== <<
692 680
693 681
694 What: /sys/class/infiniband/hfi1_X/s !! 682 What: /sys/class/infiniband/hfi1_X/sdma_N/cpu_list
695 What: /sys/class/infiniband/hfi1_X/s !! 683 What: /sys/class/infiniband/hfi1_X/sdma_N/vl
696 Date: Sept, 2016 684 Date: Sept, 2016
697 KernelVersion: v4.8 685 KernelVersion: v4.8
698 Contact: linux-rdma@vger.kernel.org 686 Contact: linux-rdma@vger.kernel.org
699 Description: 687 Description:
700 sdma<N>/ contains one director 688 sdma<N>/ contains one directory per sdma engine (0 - 15)
701 689
702 =============== ============== <<
703 cpu_list: (RW) List of c 690 cpu_list: (RW) List of cpus for user-process to sdma
704 engine assignm 691 engine assignment.
705 692
706 vl: (RO) Displays 693 vl: (RO) Displays the virtual lane (vl) the sdma
707 engine maps to 694 engine maps to.
708 =============== ============== <<
709 695
710 This interface gives the user 696 This interface gives the user control on the affinity settings
711 for the device. As an example, 697 for the device. As an example, to set an sdma engine irq
712 affinity and thread affinity o 698 affinity and thread affinity of a user processes to use the
713 sdma engine, which is "near" i 699 sdma engine, which is "near" in terms of NUMA configuration, or
714 physical cpu location, the use !! 700 physical cpu location, the user will do:
715 701
716 echo "3" > /proc/irq/<N>/smp !! 702 echo "3" > /proc/irq/<N>/smp_affinity_list
717 echo "4-7" > /sys/devices/.. !! 703 echo "4-7" > /sys/devices/.../sdma3/cpu_list
718 cat /sys/devices/.../sdma3/v !! 704 cat /sys/devices/.../sdma3/vl
719 0 !! 705 0
720 echo "8" > /proc/irq/<M>/smp !! 706 echo "8" > /proc/irq/<M>/smp_affinity_list
721 echo "9-12" > /sys/devices/. !! 707 echo "9-12" > /sys/devices/.../sdma4/cpu_list
722 cat /sys/devices/.../sdma4/v !! 708 cat /sys/devices/.../sdma4/vl
723 1 !! 709 1
724 710
725 to make sure that when a proce 711 to make sure that when a process runs on cpus 4,5,6, or 7, and
726 uses vl=0, then sdma engine 3 712 uses vl=0, then sdma engine 3 is selected by the driver, and
727 also the interrupt of the sdma 713 also the interrupt of the sdma engine 3 is steered to cpu 3.
728 Similarly, when a process runs 714 Similarly, when a process runs on cpus 9,10,11, or 12 and sets
729 vl=1, then engine 4 will be se 715 vl=1, then engine 4 will be selected and the irq of the sdma
730 engine 4 is steered to cpu 8. 716 engine 4 is steered to cpu 8. This assumes that in the above N
731 is the irq number of "sdma3", 717 is the irq number of "sdma3", and M is irq number of "sdma4" in
732 the /proc/interrupts file. 718 the /proc/interrupts file.
733 719
>> 720
>> 721 sysfs interface for Intel(R) X722 iWARP i40iw driver
>> 722 ----------------------------------------------------
>> 723
>> 724 What: /sys/class/infiniband/i40iwX/hw_rev
>> 725 What: /sys/class/infiniband/i40iwX/hca_type
>> 726 What: /sys/class/infiniband/i40iwX/board_id
>> 727 Date: Jan, 2016
>> 728 KernelVersion: v4.10
>> 729 Contact: linux-rdma@vger.kernel.org
>> 730 Description:
>> 731 hw_rev: (RO) Hardware revision number
>> 732
>> 733 hca_type: (RO) Show HCA type (I40IW)
>> 734
>> 735 board_id: (RO) I40IW board ID
>> 736
>> 737
734 sysfs interface for QLogic qedr NIC Driver 738 sysfs interface for QLogic qedr NIC Driver
735 ------------------------------------------ 739 ------------------------------------------
736 740
737 What: /sys/class/infiniband/qedrX/hw 741 What: /sys/class/infiniband/qedrX/hw_rev
738 What: /sys/class/infiniband/qedrX/hc 742 What: /sys/class/infiniband/qedrX/hca_type
739 Date: Oct, 2016 743 Date: Oct, 2016
740 KernelVersion: v4.10 744 KernelVersion: v4.10
741 Contact: linux-rdma@vger.kernel.org 745 Contact: linux-rdma@vger.kernel.org
742 Description: 746 Description:
743 747
744 =============== ==== ========= <<
745 hw_rev: (RO) Hardware 748 hw_rev: (RO) Hardware revision number
746 749
747 hca_type: (RO) Display H 750 hca_type: (RO) Display HCA type
748 =============== ==== ========= <<
749 751
750 752
751 sysfs interface for VMware Paravirtual RDMA dr 753 sysfs interface for VMware Paravirtual RDMA driver
752 ---------------------------------------------- 754 --------------------------------------------------
753 755
754 What: /sys/class/infiniband/vmw_pvrd 756 What: /sys/class/infiniband/vmw_pvrdmaX/hw_rev
755 What: /sys/class/infiniband/vmw_pvrd 757 What: /sys/class/infiniband/vmw_pvrdmaX/hca_type
756 What: /sys/class/infiniband/vmw_pvrd 758 What: /sys/class/infiniband/vmw_pvrdmaX/board_id
757 Date: Oct, 2016 759 Date: Oct, 2016
758 KernelVersion: v4.10 760 KernelVersion: v4.10
759 Contact: linux-rdma@vger.kernel.org 761 Contact: linux-rdma@vger.kernel.org
760 Description: 762 Description:
761 763
762 =============== ==== ========= <<
763 hw_rev: (RO) Hardware 764 hw_rev: (RO) Hardware revision number
764 765
765 hca_type: (RO) Host chan 766 hca_type: (RO) Host channel adapter type
766 767
767 board_id: (RO) Display P 768 board_id: (RO) Display PVRDMA manufacturing board ID
768 =============== ==== ========= <<
769 769
770 770
771 sysfs interface for Broadcom NetXtreme-E RoCE 771 sysfs interface for Broadcom NetXtreme-E RoCE driver
772 ---------------------------------------------- 772 ----------------------------------------------------
773 773
774 What: /sys/class/infiniband/bnxt_reX 774 What: /sys/class/infiniband/bnxt_reX/hw_rev
775 What: /sys/class/infiniband/bnxt_reX 775 What: /sys/class/infiniband/bnxt_reX/hca_type
776 Date: Feb, 2017 776 Date: Feb, 2017
777 KernelVersion: v4.11 777 KernelVersion: v4.11
778 Contact: linux-rdma@vger.kernel.org 778 Contact: linux-rdma@vger.kernel.org
779 Description: 779 Description:
780 =============== ==== ========= <<
781 hw_rev: (RO) Hardware 780 hw_rev: (RO) Hardware revision number
782 781
783 hca_type: (RO) Host chan 782 hca_type: (RO) Host channel adapter type
784 =============== ==== ========= <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.