xref: /linux/Documentation/ABI/testing/debugfs-hisi-hpre (revision cbac924200b838cfb8d8b1415113d788089dc50b)
1What:		/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/regs
2Date:		Sep 2019
3Contact:	linux-crypto@vger.kernel.org
4Description:	Dump debug registers from the HPRE cluster.
5		Only available for PF.
6
7What:		/sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/cluster_ctrl
8Date:		Sep 2019
9Contact:	linux-crypto@vger.kernel.org
10Description:	Write the HPRE core selection in the cluster into this file,
11		and then we can read the debug information of the core.
12		Only available for PF.
13
14What:		/sys/kernel/debug/hisi_hpre/<bdf>/rdclr_en
15Date:		Sep 2019
16Contact:	linux-crypto@vger.kernel.org
17Description:	HPRE cores debug registers read clear control. 1 means enable
18		register read clear, otherwise 0. Writing to this file has no
19		functional effect, only enable or disable counters clear after
20		reading of these registers.
21		Only available for PF.
22
23What:		/sys/kernel/debug/hisi_hpre/<bdf>/current_qm
24Date:		Sep 2019
25Contact:	linux-crypto@vger.kernel.org
26Description:	One HPRE controller has one PF and multiple VFs, each function
27		has a QM. Select the QM which below qm refers to.
28		Only available for PF.
29
30What:		/sys/kernel/debug/hisi_hpre/<bdf>/alg_qos
31Date:		Jun 2021
32Contact:	linux-crypto@vger.kernel.org
33Description:	The <bdf> is related the function for PF and VF.
34		HPRE driver supports to configure each function's QoS, the driver
35		supports to write <bdf> value to alg_qos in the host. Such as
36		"echo <bdf> value > alg_qos". The qos value is 1~1000, means
37		1/1000~1000/1000 of total QoS. The driver reading alg_qos to
38		get related QoS in the host and VM, Such as "cat alg_qos".
39
40What:		/sys/kernel/debug/hisi_hpre/<bdf>/regs
41Date:		Sep 2019
42Contact:	linux-crypto@vger.kernel.org
43Description:	Dump debug registers from the HPRE.
44		Only available for PF.
45
46What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/regs
47Date:		Sep 2019
48Contact:	linux-crypto@vger.kernel.org
49Description:	Dump debug registers from the QM.
50		Available for PF and VF in host. VF in guest currently only
51		has one debug register.
52
53What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/current_q
54Date:		Sep 2019
55Contact:	linux-crypto@vger.kernel.org
56Description:	One QM may contain multiple queues. Select specific queue to
57		show its debug registers in above regs.
58		Only available for PF.
59
60What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/clear_enable
61Date:		Sep 2019
62Contact:	linux-crypto@vger.kernel.org
63Description:	QM debug registers(regs) read clear control. 1 means enable
64		register read clear, otherwise 0.
65		Writing to this file has no functional effect, only enable or
66		disable counters clear after reading of these registers.
67		Only available for PF.
68
69What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/err_irq
70Date:		Apr 2020
71Contact:	linux-crypto@vger.kernel.org
72Description:	Dump the number of invalid interrupts for
73		QM task completion.
74		Available for both PF and VF, and take no other effect on HPRE.
75
76What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/aeq_irq
77Date:		Apr 2020
78Contact:	linux-crypto@vger.kernel.org
79Description:	Dump the number of QM async event queue interrupts.
80		Available for both PF and VF, and take no other effect on HPRE.
81
82What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/abnormal_irq
83Date:		Apr 2020
84Contact:	linux-crypto@vger.kernel.org
85Description:	Dump the number of interrupts for QM abnormal event.
86		Available for both PF and VF, and take no other effect on HPRE.
87
88What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/create_qp_err
89Date:		Apr 2020
90Contact:	linux-crypto@vger.kernel.org
91Description:	Dump the number of queue allocation errors.
92		Available for both PF and VF, and take no other effect on HPRE.
93
94What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/mb_err
95Date:		Apr 2020
96Contact:	linux-crypto@vger.kernel.org
97Description:	Dump the number of failed QM mailbox commands.
98		Available for both PF and VF, and take no other effect on HPRE.
99
100What:		/sys/kernel/debug/hisi_hpre/<bdf>/qm/status
101Date:		Apr 2020
102Contact:	linux-crypto@vger.kernel.org
103Description:	Dump the status of the QM.
104		Four states: initiated, started, stopped and closed.
105		Available for both PF and VF, and take no other effect on HPRE.
106
107What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_cnt
108Date:		Apr 2020
109Contact:	linux-crypto@vger.kernel.org
110Description:	Dump the total number of sent requests.
111		Available for both PF and VF, and take no other effect on HPRE.
112
113What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/recv_cnt
114Date:		Apr 2020
115Contact:	linux-crypto@vger.kernel.org
116Description:	Dump the total number of received requests.
117		Available for both PF and VF, and take no other effect on HPRE.
118
119What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_busy_cnt
120Date:		Apr 2020
121Contact:	linux-crypto@vger.kernel.org
122Description:	Dump the total number of requests sent
123		with returning busy.
124		Available for both PF and VF, and take no other effect on HPRE.
125
126What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_fail_cnt
127Date:		Apr 2020
128Contact:	linux-crypto@vger.kernel.org
129Description:	Dump the total number of completed but error requests.
130		Available for both PF and VF, and take no other effect on HPRE.
131
132What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/invalid_req_cnt
133Date:		Apr 2020
134Contact:	linux-crypto@vger.kernel.org
135Description:	Dump the total number of invalid requests being received.
136		Available for both PF and VF, and take no other effect on HPRE.
137
138What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/overtime_thrhld
139Date:		Apr 2020
140Contact:	linux-crypto@vger.kernel.org
141Description:	Set the threshold time for counting the request which is
142		processed longer than the threshold.
143		0: disable(default), 1: 1 microsecond.
144		Available for both PF and VF, and take no other effect on HPRE.
145
146What:		/sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/over_thrhld_cnt
147Date:		Apr 2020
148Contact:	linux-crypto@vger.kernel.org
149Description:	Dump the total number of time out requests.
150		Available for both PF and VF, and take no other effect on HPRE.
151