xref: /kernel/linux/linux-5.10/Documentation/ABI/testing/debugfs-hisi-sec

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>/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
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the number of interrupts for QM abnormal event.
		Available for both PF and VF, and take no other effect on SEC.

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

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

What:           /sys/kernel/debug/hisi_sec2/<bdf>/qm/status
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the status of the QM.
		Four states: initiated, started, stopped and closed.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of sent requests.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/recv_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of received requests.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_busy_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of requests sent with returning busy.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/err_bd_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of BD type error requests
		to be received.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/invalid_req_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of invalid requests being received.
		Available for both PF and VF, and take no other effect on SEC.

What:           /sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/done_flag_cnt
Date:           Apr 2020
Contact:        linux-crypto@vger.kernel.org
Description:    Dump the total number of completed but marked error requests
		to be received.
		Available for both PF and VF, and take no other effect on SEC.