xref: /linux/Documentation/ABI/testing/debugfs-hisi-zip (revision 26fbb4c8c7c3ee9a4c3b4de555a8587b5a19154e)
1What:           /sys/kernel/debug/hisi_zip/<bdf>/comp_core[01]/regs
2Date:           Nov 2018
3Contact:        linux-crypto@vger.kernel.org
4Description:    Dump of compression cores related debug registers.
5		Only available for PF.
6
7What:           /sys/kernel/debug/hisi_zip/<bdf>/decomp_core[0-5]/regs
8Date:           Nov 2018
9Contact:        linux-crypto@vger.kernel.org
10Description:    Dump of decompression cores related debug registers.
11		Only available for PF.
12
13What:           /sys/kernel/debug/hisi_zip/<bdf>/clear_enable
14Date:           Nov 2018
15Contact:        linux-crypto@vger.kernel.org
16Description:    Compression/decompression core debug registers read clear
17		control. 1 means enable register read clear, otherwise 0.
18		Writing to this file has no functional effect, only enable or
19		disable counters clear after reading of these registers.
20		Only available for PF.
21
22What:           /sys/kernel/debug/hisi_zip/<bdf>/current_qm
23Date:           Nov 2018
24Contact:        linux-crypto@vger.kernel.org
25Description:    One ZIP controller has one PF and multiple VFs, each function
26		has a QM. Select the QM which below qm refers to.
27		Only available for PF.
28
29What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/regs
30Date:           Nov 2018
31Contact:        linux-crypto@vger.kernel.org
32Description:    Dump of QM related debug registers.
33		Available for PF and VF in host. VF in guest currently only
34		has one debug register.
35
36What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/current_q
37Date:           Nov 2018
38Contact:        linux-crypto@vger.kernel.org
39Description:    One QM may contain multiple queues. Select specific queue to
40		show its debug registers in above regs.
41		Only available for PF.
42
43What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/clear_enable
44Date:           Nov 2018
45Contact:        linux-crypto@vger.kernel.org
46Description:    QM debug registers(regs) read clear control. 1 means enable
47		register read clear, otherwise 0.
48		Writing to this file has no functional effect, only enable or
49		disable counters clear after reading of these registers.
50		Only available for PF.
51
52What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/err_irq
53Date:           Apr 2020
54Contact:        linux-crypto@vger.kernel.org
55Description:    Dump the number of invalid interrupts for
56		QM task completion.
57		Available for both PF and VF, and take no other effect on ZIP.
58
59What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/aeq_irq
60Date:           Apr 2020
61Contact:        linux-crypto@vger.kernel.org
62Description:    Dump the number of QM async event queue interrupts.
63		Available for both PF and VF, and take no other effect on ZIP.
64
65What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/abnormal_irq
66Date:           Apr 2020
67Contact:        linux-crypto@vger.kernel.org
68Description:    Dump the number of interrupts for QM abnormal event.
69		Available for both PF and VF, and take no other effect on ZIP.
70
71What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/create_qp_err
72Date:           Apr 2020
73Contact:        linux-crypto@vger.kernel.org
74Description:    Dump the number of queue allocation errors.
75		Available for both PF and VF, and take no other effect on ZIP.
76
77What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/mb_err
78Date:           Apr 2020
79Contact:        linux-crypto@vger.kernel.org
80Description:    Dump the number of failed QM mailbox commands.
81		Available for both PF and VF, and take no other effect on ZIP.
82
83What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/status
84Date:           Apr 2020
85Contact:        linux-crypto@vger.kernel.org
86Description:    Dump the status of the QM.
87		Four states: initiated, started, stopped and closed.
88		Available for both PF and VF, and take no other effect on ZIP.
89
90What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_cnt
91Date:           Apr 2020
92Contact:        linux-crypto@vger.kernel.org
93Description:    Dump the total number of sent requests.
94		Available for both PF and VF, and take no other effect on ZIP.
95
96What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/recv_cnt
97Date:           Apr 2020
98Contact:        linux-crypto@vger.kernel.org
99Description:    Dump the total number of received requests.
100		Available for both PF and VF, and take no other effect on ZIP.
101
102What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_busy_cnt
103Date:           Apr 2020
104Contact:        linux-crypto@vger.kernel.org
105Description:    Dump the total number of requests received
106		with returning busy.
107		Available for both PF and VF, and take no other effect on ZIP.
108
109What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/err_bd_cnt
110Date:           Apr 2020
111Contact:        linux-crypto@vger.kernel.org
112Description:    Dump the total number of BD type error requests
113		to be received.
114		Available for both PF and VF, and take no other effect on ZIP.
115