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