Merge branches 'pm-cpufreq', 'pm-sleep' and 'pm-em'
[linux-2.6-microblaze.git] / Documentation / ABI / testing / debugfs-hisi-zip
1 What:           /sys/kernel/debug/hisi_zip/<bdf>/comp_core[01]/regs
2 Date:           Nov 2018
3 Contact:        linux-crypto@vger.kernel.org
4 Description:    Dump of compression cores related debug registers.
5                 Only available for PF.
6
7 What:           /sys/kernel/debug/hisi_zip/<bdf>/decomp_core[0-5]/regs
8 Date:           Nov 2018
9 Contact:        linux-crypto@vger.kernel.org
10 Description:    Dump of decompression cores related debug registers.
11                 Only available for PF.
12
13 What:           /sys/kernel/debug/hisi_zip/<bdf>/clear_enable
14 Date:           Nov 2018
15 Contact:        linux-crypto@vger.kernel.org
16 Description:    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
22 What:           /sys/kernel/debug/hisi_zip/<bdf>/current_qm
23 Date:           Nov 2018
24 Contact:        linux-crypto@vger.kernel.org
25 Description:    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
29 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/regs
30 Date:           Nov 2018
31 Contact:        linux-crypto@vger.kernel.org
32 Description:    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
36 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/current_q
37 Date:           Nov 2018
38 Contact:        linux-crypto@vger.kernel.org
39 Description:    One QM may contain multiple queues. Select specific queue to
40                 show its debug registers in above regs.
41                 Only available for PF.
42
43 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/clear_enable
44 Date:           Nov 2018
45 Contact:        linux-crypto@vger.kernel.org
46 Description:    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
52 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/err_irq
53 Date:           Apr 2020
54 Contact:        linux-crypto@vger.kernel.org
55 Description:    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
59 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/aeq_irq
60 Date:           Apr 2020
61 Contact:        linux-crypto@vger.kernel.org
62 Description:    Dump the number of QM async event queue interrupts.
63                 Available for both PF and VF, and take no other effect on ZIP.
64
65 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/abnormal_irq
66 Date:           Apr 2020
67 Contact:        linux-crypto@vger.kernel.org
68 Description:    Dump the number of interrupts for QM abnormal event.
69                 Available for both PF and VF, and take no other effect on ZIP.
70
71 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/create_qp_err
72 Date:           Apr 2020
73 Contact:        linux-crypto@vger.kernel.org
74 Description:    Dump the number of queue allocation errors.
75                 Available for both PF and VF, and take no other effect on ZIP.
76
77 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/mb_err
78 Date:           Apr 2020
79 Contact:        linux-crypto@vger.kernel.org
80 Description:    Dump the number of failed QM mailbox commands.
81                 Available for both PF and VF, and take no other effect on ZIP.
82
83 What:           /sys/kernel/debug/hisi_zip/<bdf>/qm/status
84 Date:           Apr 2020
85 Contact:        linux-crypto@vger.kernel.org
86 Description:    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
90 What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_cnt
91 Date:           Apr 2020
92 Contact:        linux-crypto@vger.kernel.org
93 Description:    Dump the total number of sent requests.
94                 Available for both PF and VF, and take no other effect on ZIP.
95
96 What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/recv_cnt
97 Date:           Apr 2020
98 Contact:        linux-crypto@vger.kernel.org
99 Description:    Dump the total number of received requests.
100                 Available for both PF and VF, and take no other effect on ZIP.
101
102 What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/send_busy_cnt
103 Date:           Apr 2020
104 Contact:        linux-crypto@vger.kernel.org
105 Description:    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
109 What:           /sys/kernel/debug/hisi_zip/<bdf>/zip_dfx/err_bd_cnt
110 Date:           Apr 2020
111 Contact:        linux-crypto@vger.kernel.org
112 Description:    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.