Documentation/ABI/testing/debugfs-hisi-sec

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/debugfs-hisi-sec

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/debugfs-hisi-sec
Extension
[no extension]
Size
6932 bytes
Lines
174
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:		/sys/kernel/debug/hisi_sec2/<bdf>/clear_enable
Date:		Oct 2019
Contact:	linux-crypto@vger.kernel.org
Description:	Enabling/disabling of clear action after reading
		the SEC debug registers.
		0: disable, 1: enable.
		Only available for PF, and take no other effect on SEC.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/current_qm
Date:		Oct 2019
Contact:	linux-crypto@vger.kernel.org
Description:	One SEC controller has one PF and multiple VFs, each function
		has a QM. This file can be used to select the QM which below
		qm refers to.
		Only available for PF.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/alg_qos
Date:		Jun 2021
Contact:	linux-crypto@vger.kernel.org
Description:	The <bdf> is related the function for PF and VF.
		SEC driver supports to configure each function's QoS, the driver
		supports to write <bdf> value to alg_qos in the host. Such as
		"echo <bdf> value > alg_qos". The qos value is 1~1000, means
		1/1000~1000/1000 of total QoS. The driver reading alg_qos to
		get related QoS in the host and VM, Such as "cat alg_qos".

What:		/sys/kernel/debug/hisi_sec2/<bdf>/dev_usage
Date:		Mar 2026
Contact:	linux-crypto@vger.kernel.org
Description:	Query the real-time bandwidth usage of device.
		Returns the bandwidth usage of each channel on the device.
		The returned number is in percentage.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/qm_regs
Date:		Oct 2019
Contact:	linux-crypto@vger.kernel.org
Description:	Dump of QM related debug registers.
		Available for PF and VF in host. VF in guest currently only
		has one debug register.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/current_q
Date:		Oct 2019
Contact:	linux-crypto@vger.kernel.org
Description:	One QM of SEC may contain multiple queues. Select specific
		queue to show its debug registers in above 'regs'.
		Only available for PF.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/clear_enable
Date:		Oct 2019
Contact:	linux-crypto@vger.kernel.org
Description:	Enabling/disabling of clear action after reading
		the SEC's QM debug registers.
		0: disable, 1: enable.
		Only available for PF, and take no other effect on SEC.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/err_irq
Date:		Apr 2020
Contact:	linux-crypto@vger.kernel.org
Description:	Dump the number of invalid interrupts for
		QM task completion.
		Available for both PF and VF, and take no other effect on SEC.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/aeq_irq
Date:		Apr 2020
Contact:	linux-crypto@vger.kernel.org
Description:	Dump the number of QM async event queue interrupts.
		Available for both PF and VF, and take no other effect on SEC.

What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/abnormal_irq
Date:		Apr 2020

Annotation

Implementation Notes