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