xref: /linux/Documentation/ABI/testing/debugfs-hisi-sec (revision e7d759f31ca295d589f7420719c311870bb3166f)
1What:		/sys/kernel/debug/hisi_sec2/<bdf>/clear_enable
2Date:		Oct 2019
3Contact:	linux-crypto@vger.kernel.org
4Description:	Enabling/disabling of clear action after reading
5		the SEC debug registers.
6		0: disable, 1: enable.
7		Only available for PF, and take no other effect on SEC.
8
9What:		/sys/kernel/debug/hisi_sec2/<bdf>/current_qm
10Date:		Oct 2019
11Contact:	linux-crypto@vger.kernel.org
12Description:	One SEC controller has one PF and multiple VFs, each function
13		has a QM. This file can be used to select the QM which below
14		qm refers to.
15		Only available for PF.
16
17What:		/sys/kernel/debug/hisi_sec2/<bdf>/alg_qos
18Date:		Jun 2021
19Contact:	linux-crypto@vger.kernel.org
20Description:	The <bdf> is related the function for PF and VF.
21		SEC driver supports to configure each function's QoS, the driver
22		supports to write <bdf> value to alg_qos in the host. Such as
23		"echo <bdf> value > alg_qos". The qos value is 1~1000, means
24		1/1000~1000/1000 of total QoS. The driver reading alg_qos to
25		get related QoS in the host and VM, Such as "cat alg_qos".
26
27What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/qm_regs
28Date:		Oct 2019
29Contact:	linux-crypto@vger.kernel.org
30Description:	Dump of QM related debug registers.
31		Available for PF and VF in host. VF in guest currently only
32		has one debug register.
33
34What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/current_q
35Date:		Oct 2019
36Contact:	linux-crypto@vger.kernel.org
37Description:	One QM of SEC may contain multiple queues. Select specific
38		queue to show its debug registers in above 'regs'.
39		Only available for PF.
40
41What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/clear_enable
42Date:		Oct 2019
43Contact:	linux-crypto@vger.kernel.org
44Description:	Enabling/disabling of clear action after reading
45		the SEC's QM debug registers.
46		0: disable, 1: enable.
47		Only available for PF, and take no other effect on SEC.
48
49What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/err_irq
50Date:		Apr 2020
51Contact:	linux-crypto@vger.kernel.org
52Description:	Dump the number of invalid interrupts for
53		QM task completion.
54		Available for both PF and VF, and take no other effect on SEC.
55
56What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/aeq_irq
57Date:		Apr 2020
58Contact:	linux-crypto@vger.kernel.org
59Description:	Dump the number of QM async event queue interrupts.
60		Available for both PF and VF, and take no other effect on SEC.
61
62What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/abnormal_irq
63Date:		Apr 2020
64Contact:	linux-crypto@vger.kernel.org
65Description:	Dump the number of interrupts for QM abnormal event.
66		Available for both PF and VF, and take no other effect on SEC.
67
68What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/create_qp_err
69Date:		Apr 2020
70Contact:	linux-crypto@vger.kernel.org
71Description:	Dump the number of queue allocation errors.
72		Available for both PF and VF, and take no other effect on SEC.
73
74What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/mb_err
75Date:		Apr 2020
76Contact:	linux-crypto@vger.kernel.org
77Description:	Dump the number of failed QM mailbox commands.
78		Available for both PF and VF, and take no other effect on SEC.
79
80What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/status
81Date:		Apr 2020
82Contact:	linux-crypto@vger.kernel.org
83Description:	Dump the status of the QM.
84		Two states: work, stop.
85		Available for both PF and VF, and take no other effect on SEC.
86
87What:		/sys/kernel/debug/hisi_sec2/<bdf>/qm/diff_regs
88Date:		Mar 2022
89Contact:	linux-crypto@vger.kernel.org
90Description:	QM debug registers(regs) read hardware register value. This
91		node is used to show the change of the qm register values. This
92		node can be help users to check the change of register values.
93
94What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/diff_regs
95Date:		Mar 2022
96Contact:	linux-crypto@vger.kernel.org
97Description:	SEC debug registers(regs) read hardware register value. This
98		node is used to show the change of the register values. This
99		node can be help users to check the change of register values.
100
101What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_cnt
102Date:		Apr 2020
103Contact:	linux-crypto@vger.kernel.org
104Description:	Dump the total number of sent requests.
105		Available for both PF and VF, and take no other effect on SEC.
106
107What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/recv_cnt
108Date:		Apr 2020
109Contact:	linux-crypto@vger.kernel.org
110Description:	Dump the total number of received requests.
111		Available for both PF and VF, and take no other effect on SEC.
112
113What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/send_busy_cnt
114Date:		Apr 2020
115Contact:	linux-crypto@vger.kernel.org
116Description:	Dump the total number of requests sent with returning busy.
117		Available for both PF and VF, and take no other effect on SEC.
118
119What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/err_bd_cnt
120Date:		Apr 2020
121Contact:	linux-crypto@vger.kernel.org
122Description:	Dump the total number of BD type error requests
123		to be received.
124		Available for both PF and VF, and take no other effect on SEC.
125
126What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/invalid_req_cnt
127Date:		Apr 2020
128Contact:	linux-crypto@vger.kernel.org
129Description:	Dump the total number of invalid requests being received.
130		Available for both PF and VF, and take no other effect on SEC.
131
132What:		/sys/kernel/debug/hisi_sec2/<bdf>/sec_dfx/done_flag_cnt
133Date:		Apr 2020
134Contact:	linux-crypto@vger.kernel.org
135Description:	Dump the total number of completed but marked error requests
136		to be received.
137		Available for both PF and VF, and take no other effect on SEC.
138