Documentation/ABI/testing/debugfs-hisi-hpre

   1 What:           /sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/regs
   2 Date:           Sep 2019
   3 Contact:        linux-crypto@vger.kernel.org
   4 Description:    Dump debug registers from the HPRE cluster.
   5                 Only available for PF.
   6
   7 What:           /sys/kernel/debug/hisi_hpre/<bdf>/cluster[0-3]/cluster_ctrl
   8 Date:           Sep 2019
   9 Contact:        linux-crypto@vger.kernel.org
  10 Description:    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
  14 What:           /sys/kernel/debug/hisi_hpre/<bdf>/rdclr_en
  15 Date:           Sep 2019
  16 Contact:        linux-crypto@vger.kernel.org
  17 Description:    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
  23 What:           /sys/kernel/debug/hisi_hpre/<bdf>/current_qm
  24 Date:           Sep 2019
  25 Contact:        linux-crypto@vger.kernel.org
  26 Description:    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
  30 What:           /sys/kernel/debug/hisi_hpre/<bdf>/regs
  31 Date:           Sep 2019
  32 Contact:        linux-crypto@vger.kernel.org
  33 Description:    Dump debug registers from the HPRE.
  34                 Only available for PF.
  35
  36 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/regs
  37 Date:           Sep 2019
  38 Contact:        linux-crypto@vger.kernel.org
  39 Description:    Dump debug registers from the QM.
  40                 Available for PF and VF in host. VF in guest currently only
  41                 has one debug register.
  42
  43 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/current_q
  44 Date:           Sep 2019
  45 Contact:        linux-crypto@vger.kernel.org
  46 Description:    One QM may contain multiple queues. Select specific queue to
  47                 show its debug registers in above regs.
  48                 Only available for PF.
  49
  50 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/clear_enable
  51 Date:           Sep 2019
  52 Contact:        linux-crypto@vger.kernel.org
  53 Description:    QM debug registers(regs) read clear control. 1 means enable
  54                 register read clear, otherwise 0.
  55                 Writing to this file has no functional effect, only enable or
  56                 disable counters clear after reading of these registers.
  57                 Only available for PF.
  58
  59 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/err_irq
  60 Date:           Apr 2020
  61 Contact:        linux-crypto@vger.kernel.org
  62 Description:    Dump the number of invalid interrupts for
  63                 QM task completion.
  64                 Available for both PF and VF, and take no other effect on HPRE.
  65
  66 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/aeq_irq
  67 Date:           Apr 2020
  68 Contact:        linux-crypto@vger.kernel.org
  69 Description:    Dump the number of QM async event queue interrupts.
  70                 Available for both PF and VF, and take no other effect on HPRE.
  71
  72 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/abnormal_irq
  73 Date:           Apr 2020
  74 Contact:        linux-crypto@vger.kernel.org
  75 Description:    Dump the number of interrupts for QM abnormal event.
  76                 Available for both PF and VF, and take no other effect on HPRE.
  77
  78 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/create_qp_err
  79 Date:           Apr 2020
  80 Contact:        linux-crypto@vger.kernel.org
  81 Description:    Dump the number of queue allocation errors.
  82                 Available for both PF and VF, and take no other effect on HPRE.
  83
  84 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/mb_err
  85 Date:           Apr 2020
  86 Contact:        linux-crypto@vger.kernel.org
  87 Description:    Dump the number of failed QM mailbox commands.
  88                 Available for both PF and VF, and take no other effect on HPRE.
  89
  90 What:           /sys/kernel/debug/hisi_hpre/<bdf>/qm/status
  91 Date:           Apr 2020
  92 Contact:        linux-crypto@vger.kernel.org
  93 Description:    Dump the status of the QM.
  94                 Four states: initiated, started, stopped and closed.
  95                 Available for both PF and VF, and take no other effect on HPRE.
  96
  97 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_cnt
  98 Date:           Apr 2020
  99 Contact:        linux-crypto@vger.kernel.org
 100 Description:    Dump the total number of sent requests.
 101                 Available for both PF and VF, and take no other effect on HPRE.
 102
 103 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/recv_cnt
 104 Date:           Apr 2020
 105 Contact:        linux-crypto@vger.kernel.org
 106 Description:    Dump the total number of received requests.
 107                 Available for both PF and VF, and take no other effect on HPRE.
 108
 109 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_busy_cnt
 110 Date:           Apr 2020
 111 Contact:        linux-crypto@vger.kernel.org
 112 Description:    Dump the total number of requests sent
 113                 with returning busy.
 114                 Available for both PF and VF, and take no other effect on HPRE.
 115
 116 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/send_fail_cnt
 117 Date:           Apr 2020
 118 Contact:        linux-crypto@vger.kernel.org
 119 Description:    Dump the total number of completed but error requests.
 120                 Available for both PF and VF, and take no other effect on HPRE.
 121
 122 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/invalid_req_cnt
 123 Date:           Apr 2020
 124 Contact:        linux-crypto@vger.kernel.org
 125 Description:    Dump the total number of invalid requests being received.
 126                 Available for both PF and VF, and take no other effect on HPRE.
 127
 128 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/overtime_thrhld
 129 Date:           Apr 2020
 130 Contact:        linux-crypto@vger.kernel.org
 131 Description:    Set the threshold time for counting the request which is
 132                 processed longer than the threshold.
 133                 0: disable(default), 1: 1 microsecond.
 134                 Available for both PF and VF, and take no other effect on HPRE.
 135
 136 What:           /sys/kernel/debug/hisi_hpre/<bdf>/hpre_dfx/over_thrhld_cnt
 137 Date:           Apr 2020
 138 Contact:        linux-crypto@vger.kernel.org
 139 Description:    Dump the total number of time out requests.
 140                 Available for both PF and VF, and take no other effect on HPRE.