xref: /linux/Documentation/ABI/stable/sysfs-class-infiniband (revision be709d48329a500621d2a05835283150ae137b45)
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 NetEffect RNIC Low-Level iWARP driver (nes)
427---------------------------------------------------------------
428
429What:		/sys/class/infiniband/nesX/hw_rev
430What:		/sys/class/infiniband/nesX/hca_type
431What:		/sys/class/infiniband/nesX/board_id
432Date:		Feb, 2008
433KernelVersion:	v2.6.25
434Contact:	linux-rdma@vger.kernel.org
435Description:
436		hw_rev:		(RO) Hardware revision number
437
438		hca_type:	(RO) Host Channel Adapter type (NEX020)
439
440		board_id:	(RO) Manufacturing board id
441
442
443sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
444-----------------------------------------------------
445
446What:		/sys/class/infiniband/cxgb4_X/hw_rev
447What:		/sys/class/infiniband/cxgb4_X/hca_type
448What:		/sys/class/infiniband/cxgb4_X/board_id
449Date:		Apr, 2010
450KernelVersion:	v2.6.35
451Contact:	linux-rdma@vger.kernel.org
452Description:
453
454		hw_rev:		(RO) Hardware revision number
455
456		hca_type:	(RO) Driver short name. Should normally match
457				the name in its bus driver structure (e.g.
458				pci_driver::name)
459
460		board_id:	(RO) Manufacturing board id. (Vendor + device
461				information)
462
463
464sysfs interface for Intel IB driver qib
465---------------------------------------
466
467What:		/sys/class/infiniband/qibX/version
468What:		/sys/class/infiniband/qibX/hw_rev
469What:		/sys/class/infiniband/qibX/hca_type
470What:		/sys/class/infiniband/qibX/board_id
471What:		/sys/class/infiniband/qibX/boardversion
472What:		/sys/class/infiniband/qibX/nctxts
473What:		/sys/class/infiniband/qibX/localbus_info
474What:		/sys/class/infiniband/qibX/tempsense
475What:		/sys/class/infiniband/qibX/serial
476What:		/sys/class/infiniband/qibX/nfreectxts
477What:		/sys/class/infiniband/qibX/chip_reset
478Date:		May, 2010
479KernelVersion:	v2.6.35
480Contact:	linux-rdma@vger.kernel.org
481Description:
482		version:	(RO) Display version information of installed software
483				and drivers.
484
485		hw_rev:		(RO) Hardware revision number
486
487		hca_type:	(RO) Host channel adapter type
488
489		board_id:	(RO) Manufacturing board id
490
491		boardversion:	(RO) Current version of the chip architecture
492
493		nctxts:		(RO) Return the number of user ports (contexts)
494				available
495
496		localbus_info:	(RO) Human readable localbus info
497
498		tempsense:	(RO) Display temp sense registers in decimal
499
500		serial:		(RO) Serial number of the HCA
501
502		nfreectxts:	(RO) The number of free user ports (contexts)
503				available.
504
505		chip_reset:	(WO) Reset the chip if possible by writing
506				"reset" to this file. Only allowed if no user
507				contexts are open that use chip resources.
508
509
510What:		/sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
511Date:		May, 2010
512KernelVersion:	v2.6.35
513Contact:	linux-rdma@vger.kernel.org
514Description:
515		(RO) The directory contains 16 files numbered 0-15 that specify
516		the Service Level (SL). Listing the SL files returns the Virtual
517		Lane (VL) as programmed by the SL.
518
519What:		/sys/class/infiniband/qibX/ports/N/CCMgtA/cc_settings_bin
520What:		/sys/class/infiniband/qibX/ports/N/CCMgtA/cc_table_bin
521Date:		May, 2010
522KernelVersion:	v2.6.35
523Contact:	linux-rdma@vger.kernel.org
524Description:
525		Per-port congestion control. Both are binary attributes.
526
527		cc_table_bin:	(RO) Congestion control table size followed by
528				table entries.
529
530		cc_settings_bin:(RO) Congestion settings: port control, control
531				map and an array of 16 entries for the
532				congestion entries - increase, timer, event log
533				trigger threshold and the minimum injection rate
534				delay.
535
536What:		/sys/class/infiniband/qibX/ports/N/linkstate/loopback
537What:		/sys/class/infiniband/qibX/ports/N/linkstate/led_override
538What:		/sys/class/infiniband/qibX/ports/N/linkstate/hrtbt_enable
539What:		/sys/class/infiniband/qibX/ports/N/linkstate/status
540What:		/sys/class/infiniband/qibX/ports/N/linkstate/status_str
541Date:		May, 2010
542KernelVersion:	v2.6.35
543Contact:	linux-rdma@vger.kernel.org
544Description:
545		[to be documented]
546
547		loopback:	(WO)
548		led_override:	(WO)
549		hrtbt_enable:	(RW)
550		status:		(RO)
551
552		status_str:	(RO) Displays information about the link state,
553				possible cable/switch problems, and hardware
554				errors. Possible states are- "Initted",
555				"Present", "IB_link_up", "IB_configured" or
556				"Fatal_Hardware_Error".
557
558What:		/sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
559What:		/sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
560What:		/sys/class/infiniband/qibX/ports/N/diag_counters/rdma_seq
561What:		/sys/class/infiniband/qibX/ports/N/diag_counters/rnr_naks
562What:		/sys/class/infiniband/qibX/ports/N/diag_counters/other_naks
563What:		/sys/class/infiniband/qibX/ports/N/diag_counters/rc_timeouts
564What:		/sys/class/infiniband/qibX/ports/N/diag_counters/look_pkts
565What:		/sys/class/infiniband/qibX/ports/N/diag_counters/pkt_drops
566What:		/sys/class/infiniband/qibX/ports/N/diag_counters/dma_wait
567What:		/sys/class/infiniband/qibX/ports/N/diag_counters/unaligned
568Date:		May, 2010
569KernelVersion:	v2.6.35
570Contact:	linux-rdma@vger.kernel.org
571Description:
572		[to be documented]
573
574
575sysfs interface for Mellanox Connect-IB HCA driver mlx5
576-------------------------------------------------------
577
578What:		/sys/class/infiniband/mlx5_X/hw_rev
579What:		/sys/class/infiniband/mlx5_X/hca_type
580What:		/sys/class/infiniband/mlx5_X/reg_pages
581What:		/sys/class/infiniband/mlx5_X/fw_pages
582Date:		Jul, 2013
583KernelVersion:	v3.11
584Contact:	linux-rdma@vger.kernel.org
585Description:
586		[to be documented]
587
588
589sysfs interface for Cisco VIC (usNIC) Verbs Driver
590--------------------------------------------------
591
592What:		/sys/class/infiniband/usnic_X/board_id
593What:		/sys/class/infiniband/usnic_X/config
594What:		/sys/class/infiniband/usnic_X/qp_per_vf
595What:		/sys/class/infiniband/usnic_X/max_vf
596What:		/sys/class/infiniband/usnic_X/cq_per_vf
597What:		/sys/class/infiniband/usnic_X/iface
598Date:		Sep, 2013
599KernelVersion:	v3.14
600Contact:	Christian Benvenuti <benve@cisco.com>,
601		Dave Goodell <dgoodell@cisco.com>,
602		linux-rdma@vger.kernel.org
603Description:
604
605		board_id:	(RO) Manufacturing board id
606
607		config:		(RO) Report the configuration for this PF
608
609		qp_per_vf:	(RO) Queue pairs per virtual function.
610
611		max_vf:		(RO) Max virtual functions
612
613		cq_per_vf:	(RO) Completion queue per virtual function
614
615		iface:		(RO) Shows which network interface this usNIC
616				entry is associated to (visible with ifconfig).
617
618What:		/sys/class/infiniband/usnic_X/qpn/summary
619What:		/sys/class/infiniband/usnic_X/qpn/context
620Date:		Sep, 2013
621KernelVersion:	v3.14
622Contact:	Christian Benvenuti <benve@cisco.com>,
623		Dave Goodell <dgoodell@cisco.com>,
624		linux-rdma@vger.kernel.org
625Description:
626		[to be documented]
627
628
629sysfs interface for Emulex RoCE HCA Driver
630------------------------------------------
631
632What:		/sys/class/infiniband/ocrdmaX/hw_rev
633Date:		Feb, 2014
634KernelVersion:	v3.14
635Description:
636		hw_rev:		(RO) Hardware revision number
637
638What:		/sys/class/infiniband/ocrdmaX/hca_type
639Date:		Jun, 2014
640KernelVersion:	v3.16
641Contact:	linux-rdma@vger.kernel.org
642Description:
643		hca_type:	(RO) Display FW version
644
645
646sysfs interface for Intel Omni-Path driver (HFI1)
647-------------------------------------------------
648
649What:		/sys/class/infiniband/hfi1_X/hw_rev
650What:		/sys/class/infiniband/hfi1_X/board_id
651What:		/sys/class/infiniband/hfi1_X/nctxts
652What:		/sys/class/infiniband/hfi1_X/serial
653What:		/sys/class/infiniband/hfi1_X/chip_reset
654What:		/sys/class/infiniband/hfi1_X/boardversion
655What:		/sys/class/infiniband/hfi1_X/nfreectxts
656What:		/sys/class/infiniband/hfi1_X/tempsense
657Date:		May, 2016
658KernelVersion:	v4.6
659Contact:	linux-rdma@vger.kernel.org
660Description:
661		hw_rev:		(RO) Hardware revision number
662
663		board_id:	(RO) Manufacturing board id
664
665		nctxts:		(RO) Total contexts available.
666
667		serial:		(RO) Board serial number
668
669		chip_reset:	(WO) Write "reset" to this file to reset the
670				chip if possible. Only allowed if no user
671				contexts are open that use chip resources.
672
673		boardversion:	(RO) Human readable board info
674
675		nfreectxts:	(RO) The number of free user ports (contexts)
676				available.
677
678		tempsense:	(RO) Thermal sense information
679
680
681What:		/sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
682What:		/sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_table_bin
683What:		/sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_prescan
684Date:		May, 2016
685KernelVersion:	v4.6
686Contact:	linux-rdma@vger.kernel.org
687Description:
688		Per-port congestion control.
689
690		cc_table_bin:	(RO) CCA tables used by PSM2 Congestion control
691				table size followed by table entries. Binary
692				attribute.
693
694		cc_settings_bin:(RO) Congestion settings: port control, control
695				map and an array of 16 entries for the
696				congestion entries - increase, timer, event log
697				trigger threshold and the minimum injection rate
698				delay. Binary attribute.
699
700		cc_prescan:	(RW) enable prescanning for faster BECN
701				response. Write "on" to enable and "off" to
702				disable.
703
704What:		/sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
705What:		/sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
706What:		/sys/class/infiniband/hfi1_X/ports/N/vl2mtu/[0-15]
707Date:		May, 2016
708KernelVersion:	v4.6
709Contact:	linux-rdma@vger.kernel.org
710Description:
711		sc2vl/:		(RO) 32 files (0 - 31) used to translate sl->vl
712
713		sl2sc/:		(RO) 32 files (0 - 31) used to translate sl->sc
714
715		vl2mtu/:	(RO) 16 files (0 - 15) used to determine MTU for vl
716
717
718What:		/sys/class/infiniband/hfi1_X/sdma_N/cpu_list
719What:		/sys/class/infiniband/hfi1_X/sdma_N/vl
720Date:		Sept, 2016
721KernelVersion:	v4.8
722Contact:	linux-rdma@vger.kernel.org
723Description:
724		sdma<N>/ contains one directory per sdma engine (0 - 15)
725
726		cpu_list:	(RW) List of cpus for user-process to sdma
727				engine assignment.
728
729		vl:		(RO) Displays the virtual lane (vl) the sdma
730				engine maps to.
731
732		This interface gives the user control on the affinity settings
733		for the device. As an example, to set an sdma engine irq
734		affinity and thread affinity of a user processes to use the
735		sdma engine, which is "near" in terms of NUMA configuration, or
736		physical cpu location, the user will do:
737
738		echo "3" > /proc/irq/<N>/smp_affinity_list
739		echo "4-7" > /sys/devices/.../sdma3/cpu_list
740		cat /sys/devices/.../sdma3/vl
741		0
742		echo "8" > /proc/irq/<M>/smp_affinity_list
743		echo "9-12" > /sys/devices/.../sdma4/cpu_list
744		cat /sys/devices/.../sdma4/vl
745		1
746
747		to make sure that when a process runs on cpus 4,5,6, or 7, and
748		uses vl=0, then sdma engine 3 is selected by the driver, and
749		also the interrupt of the sdma engine 3 is steered to cpu 3.
750		Similarly, when a process runs on cpus 9,10,11, or 12 and sets
751		vl=1, then engine 4 will be selected and the irq of the sdma
752		engine 4 is steered to cpu 8.  This assumes that in the above N
753		is the irq number of "sdma3", and M is irq number of "sdma4" in
754		the /proc/interrupts file.
755
756
757sysfs interface for Intel(R) X722 iWARP i40iw driver
758----------------------------------------------------
759
760What:		/sys/class/infiniband/i40iwX/hw_rev
761What:		/sys/class/infiniband/i40iwX/hca_type
762What:		/sys/class/infiniband/i40iwX/board_id
763Date:		Jan, 2016
764KernelVersion:	v4.10
765Contact:	linux-rdma@vger.kernel.org
766Description:
767		hw_rev:		(RO) Hardware revision number
768
769		hca_type:	(RO) Show HCA type (I40IW)
770
771		board_id:	(RO) I40IW board ID
772
773
774sysfs interface for QLogic qedr NIC Driver
775------------------------------------------
776
777What:		/sys/class/infiniband/qedrX/hw_rev
778What:		/sys/class/infiniband/qedrX/hca_type
779Date:		Oct, 2016
780KernelVersion:	v4.10
781Contact:	linux-rdma@vger.kernel.org
782Description:
783
784		hw_rev:		(RO) Hardware revision number
785
786		hca_type:	(RO) Display HCA type
787
788
789sysfs interface for VMware Paravirtual RDMA driver
790--------------------------------------------------
791
792What:		/sys/class/infiniband/vmw_pvrdmaX/hw_rev
793What:		/sys/class/infiniband/vmw_pvrdmaX/hca_type
794What:		/sys/class/infiniband/vmw_pvrdmaX/board_id
795Date:		Oct, 2016
796KernelVersion:	v4.10
797Contact:	linux-rdma@vger.kernel.org
798Description:
799
800		hw_rev:		(RO) Hardware revision number
801
802		hca_type:	(RO) Host channel adapter type
803
804		board_id:	(RO) Display PVRDMA manufacturing board ID
805
806
807sysfs interface for Broadcom NetXtreme-E RoCE driver
808----------------------------------------------------
809
810What:		/sys/class/infiniband/bnxt_reX/hw_rev
811What:		/sys/class/infiniband/bnxt_reX/hca_type
812Date:		Feb, 2017
813KernelVersion:	v4.11
814Contact:	linux-rdma@vger.kernel.org
815Description:
816		hw_rev:		(RO) Hardware revision number
817
818		hca_type:	(RO) Host channel adapter type
819