xref: /linux/Documentation/ABI/stable/sysfs-class-infiniband (revision 34dc1baba215b826e454b8d19e4f24adbeb7d00d)
1sysfs interface common for all infiniband devices
2-------------------------------------------------
3
4What:		/sys/class/infiniband/<device>/node_type
5What:		/sys/class/infiniband/<device>/node_guid
6What:		/sys/class/infiniband/<device>/sys_image_guid
7Date:		Apr, 2005
8KernelVersion:	v2.6.12
9Contact:	linux-rdma@vger.kernel.org
10Description:
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
21What:		/sys/class/infiniband/<device>/node_desc
22Date:		Feb, 2006
23KernelVersion:	v2.6.17
24Contact:	linux-rdma@vger.kernel.org
25Description:
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
31What:		/sys/class/infiniband/<device>/fw_ver
32Date:		Jun, 2016
33KernelVersion:	v4.10
34Contact:	linux-rdma@vger.kernel.org
35Description:
36		(RO) Display firmware version
37
38
39What:		/sys/class/infiniband/<device>/ports/<port-num>/lid
40What:		/sys/class/infiniband/<device>/ports/<port-num>/rate
41What:		/sys/class/infiniband/<device>/ports/<port-num>/lid_mask_count
42What:		/sys/class/infiniband/<device>/ports/<port-num>/sm_sl
43What:		/sys/class/infiniband/<device>/ports/<port-num>/sm_lid
44What:		/sys/class/infiniband/<device>/ports/<port-num>/state
45What:		/sys/class/infiniband/<device>/ports/<port-num>/phys_state
46What:		/sys/class/infiniband/<device>/ports/<port-num>/cap_mask
47Date:		Apr, 2005
48KernelVersion:	v2.6.12
49Contact:	linux-rdma@vger.kernel.org
50Description:
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
77What:		/sys/class/infiniband/<device>/ports/<port-num>/link_layer
78Date:		Oct, 2010
79KernelVersion:	v2.6.37
80Contact:	linux-rdma@vger.kernel.org
81Description:
82		(RO) Link layer type information (Infiniband or Ethernet type)
83
84
85What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/symbol_error
86What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_errors
87What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_remote_physical_errors
88What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_switch_relay_errors
89What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/link_error_recovery
90What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_constraint_errors
91What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_contraint_errors
92What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/local_link_integrity_errors
93What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/excessive_buffer_overrun_errors
94What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_data
95What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_data
96What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_packets
97What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_rcv_packets
98What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_rcv_packets
99What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/unicast_xmit_packets
100What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_rcv_packets
101What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/multicast_xmit_packets
102What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/link_downed
103What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_discards
104What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/VL15_dropped
105What:		/sys/class/infiniband/<device>/ports/<port-num>/counters/port_xmit_wait
106Date:		Apr, 2005
107KernelVersion:	v2.6.12
108Contact:	linux-rdma@vger.kernel.org
109Description:
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
199What:		/sys/class/infiniband/<device-name>/hw_counters/lifespan
200What:		/sys/class/infiniband/<device-name>/ports/<port-num>/hw_counters/lifespan
201Date:		May, 2016
202KernelVersion:	4.6
203Contact:	linux-rdma@vger.kernel.org
204Description:
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
219What:		/sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/ndevs/<gid-index>
220Date:		November 29, 2015
221KernelVersion:	4.4.0
222Contact:	linux-rdma@vger.kernel.org
223Description: 	The net-device's name associated with the GID resides
224		at index <gid-index>.
225
226What:		/sys/class/infiniband/<hca>/ports/<port-number>/gid_attrs/types/<gid-index>
227Date:		November 29, 2015
228KernelVersion:	4.4.0
229Contact:	linux-rdma@vger.kernel.org
230Description: 	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
235What:		/sys/class/infiniband_mad/umad<N>/ibdev
236What:		/sys/class/infiniband_mad/umad<N>/port
237What:		/sys/class/infiniband_mad/issm<N>/ibdev
238What:		/sys/class/infiniband_mad/issm<N>/port
239Date:		Apr, 2005
240KernelVersion:	v2.6.12
241Contact:	linux-rdma@vger.kernel.org
242Description:
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
255What:		/sys/class/infiniband_mad/abi_version
256Date:		Apr, 2005
257KernelVersion:	v2.6.12
258Contact:	linux-rdma@vger.kernel.org
259Description:
260		(RO) Value is incremented if any changes are made that break
261		userspace ABI compatibility of umad & issm devices.
262
263
264What:		/sys/class/infiniband_verbs/uverbs<N>/ibdev
265What:		/sys/class/infiniband_verbs/uverbs<N>/abi_version
266Date:		Sept, 2005
267KernelVersion:	v2.6.14
268Contact:	linux-rdma@vger.kernel.org
269Description:
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
278What:		/sys/class/infiniband_verbs/abi_version
279Date:		Sep, 2005
280KernelVersion:	v2.6.14
281Contact:	linux-rdma@vger.kernel.org
282Description:
283		(RO) Value is incremented if any changes are made that break
284		userspace ABI compatibility of uverbs devices.
285
286
287sysfs interface for Mellanox IB HCA low-level driver (mthca)
288------------------------------------------------------------
289
290What:		/sys/class/infiniband/mthcaX/hw_rev
291What:		/sys/class/infiniband/mthcaX/hca_type
292What:		/sys/class/infiniband/mthcaX/board_id
293Date:		Apr, 2005
294KernelVersion:	v2.6.12
295Contact:	linux-rdma@vger.kernel.org
296Description:
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
307sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
308----------------------------------------------------------
309
310What:		/sys/class/infiniband/mlx4_X/hw_rev
311What:		/sys/class/infiniband/mlx4_X/hca_type
312What:		/sys/class/infiniband/mlx4_X/board_id
313Date:		Sep, 2007
314KernelVersion:	v2.6.24
315Contact:	linux-rdma@vger.kernel.org
316Description:
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
326What:		/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
327What:		/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/admin_guids/<n>
328What:		/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/pkeys/<n>
329What:		/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/mcgs/
330What:		/sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/gid_idx/0
331What:		/sys/class/infiniband/mlx4_X/iov/ports/<pci-slot-num>/ports/<m>/pkey_idx/<n>
332Date:		Aug, 2012
333KernelVersion:	v3.6.15
334Contact:	linux-rdma@vger.kernel.org
335Description:
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
381What:		/sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
382What:           /sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/enable_smi_admin
383Date:		May, 2014
384KernelVersion:	v3.15.7
385Contact:	linux-rdma@vger.kernel.org
386Description:
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
403sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
404-----------------------------------------------------
405
406What:		/sys/class/infiniband/cxgb4_X/hw_rev
407What:		/sys/class/infiniband/cxgb4_X/hca_type
408What:		/sys/class/infiniband/cxgb4_X/board_id
409Date:		Apr, 2010
410KernelVersion:	v2.6.35
411Contact:	linux-rdma@vger.kernel.org
412Description:
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
426sysfs interface for Intel IB driver qib
427---------------------------------------
428
429What:		/sys/class/infiniband/qibX/version
430What:		/sys/class/infiniband/qibX/hw_rev
431What:		/sys/class/infiniband/qibX/hca_type
432What:		/sys/class/infiniband/qibX/board_id
433What:		/sys/class/infiniband/qibX/boardversion
434What:		/sys/class/infiniband/qibX/nctxts
435What:		/sys/class/infiniband/qibX/localbus_info
436What:		/sys/class/infiniband/qibX/tempsense
437What:		/sys/class/infiniband/qibX/serial
438What:		/sys/class/infiniband/qibX/nfreectxts
439What:		/sys/class/infiniband/qibX/chip_reset
440Date:		May, 2010
441KernelVersion:	v2.6.35
442Contact:	linux-rdma@vger.kernel.org
443Description:
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
474What:		/sys/class/infiniband/qibX/ports/<N>/sl2vl/[0-15]
475Date:		May, 2010
476KernelVersion:	v2.6.35
477Contact:	linux-rdma@vger.kernel.org
478Description:
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
483What:		/sys/class/infiniband/qibX/ports/<N>/CCMgtA/cc_settings_bin
484What:		/sys/class/infiniband/qibX/ports/<N>/CCMgtA/cc_table_bin
485Date:		May, 2010
486KernelVersion:	v2.6.35
487Contact:	linux-rdma@vger.kernel.org
488Description:
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
502What:		/sys/class/infiniband/qibX/ports/<N>/linkstate/loopback
503What:		/sys/class/infiniband/qibX/ports/<N>/linkstate/led_override
504What:		/sys/class/infiniband/qibX/ports/<N>/linkstate/hrtbt_enable
505What:		/sys/class/infiniband/qibX/ports/<N>/linkstate/status
506What:		/sys/class/infiniband/qibX/ports/<N>/linkstate/status_str
507Date:		May, 2010
508KernelVersion:	v2.6.35
509Contact:	linux-rdma@vger.kernel.org
510Description:
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
526What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/rc_resends
527What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/seq_naks
528What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/rdma_seq
529What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/rnr_naks
530What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/other_naks
531What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/rc_timeouts
532What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/look_pkts
533What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/pkt_drops
534What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/dma_wait
535What:		/sys/class/infiniband/qibX/ports/<N>/diag_counters/unaligned
536Date:		May, 2010
537KernelVersion:	v2.6.35
538Contact:	linux-rdma@vger.kernel.org
539Description:
540		[to be documented]
541
542
543sysfs interface for Mellanox Connect-IB HCA driver mlx5
544-------------------------------------------------------
545
546What:		/sys/class/infiniband/mlx5_X/hw_rev
547What:		/sys/class/infiniband/mlx5_X/hca_type
548What:		/sys/class/infiniband/mlx5_X/reg_pages
549What:		/sys/class/infiniband/mlx5_X/fw_pages
550Date:		Jul, 2013
551KernelVersion:	v3.11
552Contact:	linux-rdma@vger.kernel.org
553Description:
554		[to be documented]
555
556
557sysfs interface for Cisco VIC (usNIC) Verbs Driver
558--------------------------------------------------
559
560What:		/sys/class/infiniband/usnic_X/board_id
561What:		/sys/class/infiniband/usnic_X/config
562What:		/sys/class/infiniband/usnic_X/qp_per_vf
563What:		/sys/class/infiniband/usnic_X/max_vf
564What:		/sys/class/infiniband/usnic_X/cq_per_vf
565What:		/sys/class/infiniband/usnic_X/iface
566Date:		Sep, 2013
567KernelVersion:	v3.14
568Contact:	Christian Benvenuti <benve@cisco.com>,
569		Dave Goodell <dgoodell@cisco.com>,
570		linux-rdma@vger.kernel.org
571Description:
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
588What:		/sys/class/infiniband/usnic_X/qpn/summary
589What:		/sys/class/infiniband/usnic_X/qpn/context
590Date:		Sep, 2013
591KernelVersion:	v3.14
592Contact:	Christian Benvenuti <benve@cisco.com>,
593		Dave Goodell <dgoodell@cisco.com>,
594		linux-rdma@vger.kernel.org
595Description:
596		[to be documented]
597
598
599sysfs interface for Emulex RoCE HCA Driver
600------------------------------------------
601
602What:		/sys/class/infiniband/ocrdmaX/hw_rev
603Date:		Feb, 2014
604KernelVersion:	v3.14
605Description:
606		hw_rev:		(RO) Hardware revision number
607
608What:		/sys/class/infiniband/ocrdmaX/hca_type
609Date:		Jun, 2014
610KernelVersion:	v3.16
611Contact:	linux-rdma@vger.kernel.org
612Description:
613		hca_type:	(RO) Display FW version
614
615
616sysfs interface for Intel Omni-Path driver (HFI1)
617-------------------------------------------------
618
619What:		/sys/class/infiniband/hfi1_X/hw_rev
620What:		/sys/class/infiniband/hfi1_X/board_id
621What:		/sys/class/infiniband/hfi1_X/nctxts
622What:		/sys/class/infiniband/hfi1_X/serial
623What:		/sys/class/infiniband/hfi1_X/chip_reset
624What:		/sys/class/infiniband/hfi1_X/boardversion
625What:		/sys/class/infiniband/hfi1_X/nfreectxts
626What:		/sys/class/infiniband/hfi1_X/tempsense
627Date:		May, 2016
628KernelVersion:	v4.6
629Contact:	linux-rdma@vger.kernel.org
630Description:
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
653What:		/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_settings_bin
654What:		/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_table_bin
655What:		/sys/class/infiniband/hfi1_X/ports/<N>/CCMgtA/cc_prescan
656Date:		May, 2016
657KernelVersion:	v4.6
658Contact:	linux-rdma@vger.kernel.org
659Description:
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
678What:		/sys/class/infiniband/hfi1_X/ports/<N>/sc2vl/[0-31]
679What:		/sys/class/infiniband/hfi1_X/ports/<N>/sl2sc/[0-31]
680What:		/sys/class/infiniband/hfi1_X/ports/<N>/vl2mtu/[0-15]
681Date:		May, 2016
682KernelVersion:	v4.6
683Contact:	linux-rdma@vger.kernel.org
684Description:
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
694What:		/sys/class/infiniband/hfi1_X/sdma_<N>/cpu_list
695What:		/sys/class/infiniband/hfi1_X/sdma_<N>/vl
696Date:		Sept, 2016
697KernelVersion:	v4.8
698Contact:	linux-rdma@vger.kernel.org
699Description:
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
734sysfs interface for QLogic qedr NIC Driver
735------------------------------------------
736
737What:		/sys/class/infiniband/qedrX/hw_rev
738What:		/sys/class/infiniband/qedrX/hca_type
739Date:		Oct, 2016
740KernelVersion:	v4.10
741Contact:	linux-rdma@vger.kernel.org
742Description:
743
744		=============== ==== ========================
745		hw_rev:		(RO) Hardware revision number
746
747		hca_type:	(RO) Display HCA type
748		=============== ==== ========================
749
750
751sysfs interface for VMware Paravirtual RDMA driver
752--------------------------------------------------
753
754What:		/sys/class/infiniband/vmw_pvrdmaX/hw_rev
755What:		/sys/class/infiniband/vmw_pvrdmaX/hca_type
756What:		/sys/class/infiniband/vmw_pvrdmaX/board_id
757Date:		Oct, 2016
758KernelVersion:	v4.10
759Contact:	linux-rdma@vger.kernel.org
760Description:
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
771sysfs interface for Broadcom NetXtreme-E RoCE driver
772----------------------------------------------------
773
774What:		/sys/class/infiniband/bnxt_reX/hw_rev
775What:		/sys/class/infiniband/bnxt_reX/hca_type
776Date:		Feb, 2017
777KernelVersion:	v4.11
778Contact:	linux-rdma@vger.kernel.org
779Description:
780		=============== ==== =========================
781		hw_rev:		(RO) Hardware revision number
782
783		hca_type:	(RO) Host channel adapter type
784		=============== ==== =========================
785