forked from ~ljy/RK356X_SDK_RELEASE
blame | history | patch | commit | commitdiff
hc
2024-02-20 ea08eeccae9297f7aabd2ef7f0c2517ac4549acc 
 kernel/Documentation/ABI/stable/sysfs-class-infiniband
....@@ -8,12 +8,14 @@
88 KernelVersion:	v2.6.12
99 Contact:	linux-rdma@vger.kernel.org
1010 Description:
11
+		=============== ===========================================
1112 		node_type:	(RO) Node type (CA, RNIC, usNIC, usNIC UDP,
1213 				switch or router)
1314 
1415 		node_guid:	(RO) Node GUID
1516 
1617 		sys_image_guid:	(RO) System image GUID
18
+		=============== ===========================================
1719 
1820 
1921 What:		/sys/class/infiniband/<device>/node_desc
....@@ -47,6 +49,7 @@
4749 Contact:	linux-rdma@vger.kernel.org
4850 Description:
4951 
52
+		=============== ===============================================
5053 		lid:		(RO) Port LID
5154 
5255 		rate:		(RO) Port data rate (active width * active
....@@ -66,8 +69,9 @@
6669 
6770 		cap_mask:	(RO) Port capability mask. 2 bits here are
6871 				settable- IsCommunicationManagementSupported
69
-				(set when CM module is loaded) and IsSM (set via
70
-				open of issmN file).
72
+				(set when CM module is loaded) and IsSM (set
73
+				via open of issmN file).
74
+		=============== ===============================================
7175 
7276 
7377 What:		/sys/class/infiniband/<device>/ports/<port-num>/link_layer
....@@ -103,8 +107,7 @@
103107 KernelVersion:	v2.6.12
104108 Contact:	linux-rdma@vger.kernel.org
105109 Description:
106
-		Errors info:
107
-		-----------
110
+		**Errors info**:
108111 
109112 		symbol_error: (RO) Total number of minor link errors detected on
110113 		one or more physical lanes.
....@@ -142,8 +145,7 @@
142145 		intervention. It can also indicate hardware issues or extremely
143146 		poor link signal integrity
144147 
145
-		Data info:
146
-		---------
148
+		**Data info**:
147149 
148150 		port_xmit_data: (RO) Total number of data octets, divided by 4
149151 		(lanes), transmitted on all VLs. This is 64 bit counter
....@@ -176,8 +178,7 @@
176178 		transmitted on all VLs from the port. This may include multicast
177179 		packets with errors.
178180 
179
-		Misc info:
180
-		---------
181
+		**Misc info**:
181182 
182183 		port_xmit_discards: (RO) Total number of outbound packets
183184 		discarded by the port because the port is down or congested.
....@@ -244,9 +245,11 @@
244245 		two umad devices and two issm devices, while a switch will have
245246 		one device of each type (for switch port 0).
246247 
248
+		======= =====================================
247249 		ibdev:	(RO) Show Infiniband (IB) device name
248250 
249251 		port:	(RO) Display port number
252
+		======= =====================================
250253 
251254 
252255 What:		/sys/class/infiniband_mad/abi_version
....@@ -258,33 +261,18 @@
258261 		userspace ABI compatibility of umad & issm devices.
259262 
260263 
261
-What:		/sys/class/infiniband_cm/ucmN/ibdev
262
-Date:		Oct, 2005
263
-KernelVersion:	v2.6.14
264
-Contact:	linux-rdma@vger.kernel.org
265
-Description:
266
-		(RO) Display Infiniband (IB) device name
267
-
268
-
269
-What:		/sys/class/infiniband_cm/abi_version
270
-Date:		Oct, 2005
271
-KernelVersion:	v2.6.14
272
-Contact:	linux-rdma@vger.kernel.org
273
-Description:
274
-		(RO) Value is incremented if any changes are made that break
275
-		userspace ABI compatibility of ucm devices.
276
-
277
-
278264 What:		/sys/class/infiniband_verbs/uverbsN/ibdev
279265 What:		/sys/class/infiniband_verbs/uverbsN/abi_version
280266 Date:		Sept, 2005
281267 KernelVersion:	v2.6.14
282268 Contact:	linux-rdma@vger.kernel.org
283269 Description:
270
+		=============== ===========================================
284271 		ibdev:		(RO) Display Infiniband (IB) device name
285272 
286273 		abi_version:	(RO) Show ABI version of IB device specific
287274 				interfaces.
275
+		=============== ===========================================
288276 
289277 
290278 What:		/sys/class/infiniband_verbs/abi_version
....@@ -306,31 +294,14 @@
306294 KernelVersion:	v2.6.12
307295 Contact:	linux-rdma@vger.kernel.org
308296 Description:
297
+		=============== ================================================
309298 		hw_rev:		(RO) Hardware revision number
310299 
311300 		hca_type:	(RO) Host Channel Adapter type: MT23108, MT25208
312301 				(MT23108 compat mode), MT25208 or MT25204
313302 
314303 		board_id:	(RO) Manufacturing board ID
315
-
316
-
317
-sysfs interface for Chelsio T3 RDMA Driver (cxgb3)
318
---------------------------------------------------
319
-
320
-What:		/sys/class/infiniband/cxgb3_X/hw_rev
321
-What:		/sys/class/infiniband/cxgb3_X/hca_type
322
-What:		/sys/class/infiniband/cxgb3_X/board_id
323
-Date:		Feb, 2007
324
-KernelVersion:	v2.6.21
325
-Contact:	linux-rdma@vger.kernel.org
326
-Description:
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
304
+		=============== ================================================
334305 
335306 
336307 sysfs interface for Mellanox ConnectX HCA IB driver (mlx4)
....@@ -343,11 +314,13 @@
343314 KernelVersion:	v2.6.24
344315 Contact:	linux-rdma@vger.kernel.org
345316 Description:
317
+		=============== ===============================
346318 		hw_rev:		(RO) Hardware revision number
347319 
348320 		hca_type:	(RO) Host channel adapter type
349321 
350322 		board_id:	(RO) Manufacturing board ID
323
+		=============== ===============================
351324 
352325 
353326 What:		/sys/class/infiniband/mlx4_X/iov/ports/<port-num>/gids/<n>
....@@ -373,6 +346,7 @@
373346 		example, ports/1/pkeys/10 contains the value at index 10 in port
374347 		1's P_Key table.
375348 
349
+		======================= ==========================================
376350 		gids/<n>:		(RO) The physical port gids n = 0..127
377351 
378352 		admin_guids/<n>:	(RW) Allows examining or changing the
....@@ -401,6 +375,7 @@
401375 					guest, whenever it uses its pkey index
402376 					1, will actually be using the real pkey
403377 					index 10.
378
+		======================= ==========================================
404379 
405380 
406381 What:		/sys/class/infiniband/mlx4_X/iov/<pci-slot-num>/ports/<m>/smi_enabled
....@@ -412,32 +387,17 @@
412387 		Enabling QP0 on VFs for selected VF/port. By default, no VFs are
413388 		enabled for QP0 operation.
414389 
415
-		smi_enabled:	(RO) Indicates whether smi is currently enabled
416
-				for the indicated VF/port
390
+		================= ==== ===========================================
391
+		smi_enabled:	  (RO) Indicates whether smi is currently enabled
392
+				       for the indicated VF/port
417393 
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.
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
+		================= ==== ===========================================
421398 
422399 		The requested enablement will occur at the next reset of the VF
423400 		(e.g. driver restart on the VM which owns the VF).
424
-
425
-
426
-sysfs interface for NetEffect RNIC Low-Level iWARP driver (nes)
427
----------------------------------------------------------------
428
-
429
-What:		/sys/class/infiniband/nesX/hw_rev
430
-What:		/sys/class/infiniband/nesX/hca_type
431
-What:		/sys/class/infiniband/nesX/board_id
432
-Date:		Feb, 2008
433
-KernelVersion:	v2.6.25
434
-Contact:	linux-rdma@vger.kernel.org
435
-Description:
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
441401 
442402 
443403 sysfs interface for Chelsio T4/T5 RDMA driver (cxgb4)
....@@ -451,6 +411,7 @@
451411 Contact:	linux-rdma@vger.kernel.org
452412 Description:
453413 
414
+		=============== =============================================
454415 		hw_rev:		(RO) Hardware revision number
455416 
456417 		hca_type:	(RO) Driver short name. Should normally match
....@@ -459,6 +420,7 @@
459420 
460421 		board_id:	(RO) Manufacturing board id. (Vendor + device
461422 				information)
423
+		=============== =============================================
462424 
463425 
464426 sysfs interface for Intel IB driver qib
....@@ -479,6 +441,7 @@
479441 KernelVersion:	v2.6.35
480442 Contact:	linux-rdma@vger.kernel.org
481443 Description:
444
+		=============== ======================================================
482445 		version:	(RO) Display version information of installed software
483446 				and drivers.
484447 
....@@ -505,6 +468,7 @@
505468 		chip_reset:	(WO) Reset the chip if possible by writing
506469 				"reset" to this file. Only allowed if no user
507470 				contexts are open that use chip resources.
471
+		=============== ======================================================
508472 
509473 
510474 What:		/sys/class/infiniband/qibX/ports/N/sl2vl/[0-15]
....@@ -524,14 +488,16 @@
524488 Description:
525489 		Per-port congestion control. Both are binary attributes.
526490 
527
-		cc_table_bin:	(RO) Congestion control table size followed by
491
+		=============== ================================================
492
+		cc_table_bin	(RO) Congestion control table size followed by
528493 				table entries.
529494 
530
-		cc_settings_bin:(RO) Congestion settings: port control, control
495
+		cc_settings_bin (RO) Congestion settings: port control, control
531496 				map and an array of 16 entries for the
532497 				congestion entries - increase, timer, event log
533498 				trigger threshold and the minimum injection rate
534499 				delay.
500
+		=============== ================================================
535501 
536502 What:		/sys/class/infiniband/qibX/ports/N/linkstate/loopback
537503 What:		/sys/class/infiniband/qibX/ports/N/linkstate/led_override
....@@ -544,6 +510,7 @@
544510 Description:
545511 		[to be documented]
546512 
513
+		=============== ===============================================
547514 		loopback:	(WO)
548515 		led_override:	(WO)
549516 		hrtbt_enable:	(RW)
....@@ -554,6 +521,7 @@
554521 				errors. Possible states are- "Initted",
555522 				"Present", "IB_link_up", "IB_configured" or
556523 				"Fatal_Hardware_Error".
524
+		=============== ===============================================
557525 
558526 What:		/sys/class/infiniband/qibX/ports/N/diag_counters/rc_resends
559527 What:		/sys/class/infiniband/qibX/ports/N/diag_counters/seq_naks
....@@ -602,6 +570,7 @@
602570 		linux-rdma@vger.kernel.org
603571 Description:
604572 
573
+		=============== ===============================================
605574 		board_id:	(RO) Manufacturing board id
606575 
607576 		config:		(RO) Report the configuration for this PF
....@@ -614,6 +583,7 @@
614583 
615584 		iface:		(RO) Shows which network interface this usNIC
616585 				entry is associated to (visible with ifconfig).
586
+		=============== ===============================================
617587 
618588 What:		/sys/class/infiniband/usnic_X/qpn/summary
619589 What:		/sys/class/infiniband/usnic_X/qpn/context
....@@ -658,6 +628,7 @@
658628 KernelVersion:	v4.6
659629 Contact:	linux-rdma@vger.kernel.org
660630 Description:
631
+		=============== =============================================
661632 		hw_rev:		(RO) Hardware revision number
662633 
663634 		board_id:	(RO) Manufacturing board id
....@@ -676,6 +647,7 @@
676647 				available.
677648 
678649 		tempsense:	(RO) Thermal sense information
650
+		=============== =============================================
679651 
680652 
681653 What:		/sys/class/infiniband/hfi1_X/ports/N/CCMgtA/cc_settings_bin
....@@ -687,19 +659,21 @@
687659 Description:
688660 		Per-port congestion control.
689661 
690
-		cc_table_bin:	(RO) CCA tables used by PSM2 Congestion control
662
+		=============== ================================================
663
+		cc_table_bin	(RO) CCA tables used by PSM2 Congestion control
691664 				table size followed by table entries. Binary
692665 				attribute.
693666 
694
-		cc_settings_bin:(RO) Congestion settings: port control, control
667
+		cc_settings_bin (RO) Congestion settings: port control, control
695668 				map and an array of 16 entries for the
696669 				congestion entries - increase, timer, event log
697670 				trigger threshold and the minimum injection rate
698671 				delay. Binary attribute.
699672 
700
-		cc_prescan:	(RW) enable prescanning for faster BECN
673
+		cc_prescan	(RW) enable prescanning for faster BECN
701674 				response. Write "on" to enable and "off" to
702675 				disable.
676
+		=============== ================================================
703677 
704678 What:		/sys/class/infiniband/hfi1_X/ports/N/sc2vl/[0-31]
705679 What:		/sys/class/infiniband/hfi1_X/ports/N/sl2sc/[0-31]
....@@ -708,11 +682,13 @@
708682 KernelVersion:	v4.6
709683 Contact:	linux-rdma@vger.kernel.org
710684 Description:
685
+		=============== ===================================================
711686 		sc2vl/:		(RO) 32 files (0 - 31) used to translate sl->vl
712687 
713688 		sl2sc/:		(RO) 32 files (0 - 31) used to translate sl->sc
714689 
715690 		vl2mtu/:	(RO) 16 files (0 - 15) used to determine MTU for vl
691
+		=============== ===================================================
716692 
717693 
718694 What:		/sys/class/infiniband/hfi1_X/sdma_N/cpu_list
....@@ -723,26 +699,28 @@
723699 Description:
724700 		sdma<N>/ contains one directory per sdma engine (0 - 15)
725701 
702
+		=============== ==============================================
726703 		cpu_list:	(RW) List of cpus for user-process to sdma
727704 				engine assignment.
728705 
729706 		vl:		(RO) Displays the virtual lane (vl) the sdma
730707 				engine maps to.
708
+		=============== ==============================================
731709 
732710 		This interface gives the user control on the affinity settings
733711 		for the device. As an example, to set an sdma engine irq
734712 		affinity and thread affinity of a user processes to use the
735713 		sdma engine, which is "near" in terms of NUMA configuration, or
736
-		physical cpu location, the user will do:
714
+		physical cpu location, the user will do::
737715 
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
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
746724 
747725 		to make sure that when a process runs on cpus 4,5,6, or 7, and
748726 		uses vl=0, then sdma engine 3 is selected by the driver, and
....@@ -764,11 +742,13 @@
764742 KernelVersion:	v4.10
765743 Contact:	linux-rdma@vger.kernel.org
766744 Description:
745
+		=============== ==== ========================
767746 		hw_rev:		(RO) Hardware revision number
768747 
769748 		hca_type:	(RO) Show HCA type (I40IW)
770749 
771750 		board_id:	(RO) I40IW board ID
751
+		=============== ==== ========================
772752 
773753 
774754 sysfs interface for QLogic qedr NIC Driver
....@@ -781,9 +761,11 @@
781761 Contact:	linux-rdma@vger.kernel.org
782762 Description:
783763 
764
+		=============== ==== ========================
784765 		hw_rev:		(RO) Hardware revision number
785766 
786767 		hca_type:	(RO) Display HCA type
768
+		=============== ==== ========================
787769 
788770 
789771 sysfs interface for VMware Paravirtual RDMA driver
....@@ -797,11 +779,13 @@
797779 Contact:	linux-rdma@vger.kernel.org
798780 Description:
799781 
782
+		=============== ==== =====================================
800783 		hw_rev:		(RO) Hardware revision number
801784 
802785 		hca_type:	(RO) Host channel adapter type
803786 
804787 		board_id:	(RO) Display PVRDMA manufacturing board ID
788
+		=============== ==== =====================================
805789 
806790 
807791 sysfs interface for Broadcom NetXtreme-E RoCE driver
....@@ -813,6 +797,8 @@
813797 KernelVersion:	v4.11
814798 Contact:	linux-rdma@vger.kernel.org
815799 Description:
800
+		=============== ==== =========================
816801 		hw_rev:		(RO) Hardware revision number
817802 
818803 		hca_type:	(RO) Host channel adapter type
804
+		=============== ==== =========================