Documentation/translations/zh_CN/arm64/elf_hwcaps.rst

   1 .. include:: ../disclaimer-zh_CN.rst
   2
   3 :Original: :ref:`Documentation/arm64/elf_hwcaps.rst <elf_hwcaps_index>`
   4
   5 Translator: Bailu Lin <bailu.lin@vivo.com>
   6
   7 ================
   8 ARM64 ELF hwcaps
   9 ================
  10
  11 这篇文档描述了 arm64 ELF hwcaps 的用法和语义。
  12
  13
  14 1. 简介
  15 -------
  16
  17 有些硬件或软件功能仅在某些 CPU 实现上和/或在具体某个内核配置上可用，但
  18 对于处于 EL0 的用户空间代码没有可用的架构发现机制。内核通过在辅助向量表
  19 公开一组称为 hwcaps 的标志而把这些功能暴露给用户空间。
  20
  21 用户空间软件可以通过获取辅助向量的 AT_HWCAP 或 AT_HWCAP2 条目来测试功能，
  22 并测试是否设置了相关标志，例如::
  23
  24         bool floating_point_is_present(void)
  25         {
  26                 unsigned long hwcaps = getauxval(AT_HWCAP);
  27                 if (hwcaps & HWCAP_FP)
  28                         return true;
  29
  30                 return false;
  31         }
  32
  33 如果软件依赖于 hwcap 描述的功能，在尝试使用该功能前则应检查相关的 hwcap
  34 标志以验证该功能是否存在。
  35
  36 不能通过其他方式探查这些功能。当一个功能不可用时，尝试使用它可能导致不可
  37 预测的行为，并且无法保证能确切的知道该功能不可用，例如 SIGILL。
  38
  39
  40 2. Hwcaps 的说明
  41 ----------------
  42
  43 大多数 hwcaps 旨在说明通过架构 ID 寄存器(处于 EL0 的用户空间代码无法访问)
  44 描述的功能的存在。这些 hwcap 通过 ID 寄存器字段定义，并且应根据 ARM 体系
  45 结构参考手册（ARM ARM）中定义的字段来解释说明。
  46
  47 这些 hwcaps 以下面的形式描述::
  48
  49     idreg.field == val 表示有某个功能。
  50
  51 当 idreg.field 中有 val 时，hwcaps 表示 ARM ARM 定义的功能是有效的，但是
  52 并不是说要完全和 val 相等，也不是说 idreg.field 描述的其他功能就是缺失的。
  53
  54 其他 hwcaps 可能表明无法仅由 ID 寄存器描述的功能的存在。这些 hwcaps 可能
  55 没有被 ID 寄存器描述，需要参考其他文档。
  56
  57
  58 3. AT_HWCAP 中揭示的 hwcaps
  59 ---------------------------
  60
  61 HWCAP_FP
  62     ID_AA64PFR0_EL1.FP == 0b0000 表示有此功能。
  63
  64 HWCAP_ASIMD
  65     ID_AA64PFR0_EL1.AdvSIMD == 0b0000 表示有此功能。
  66
  67 HWCAP_EVTSTRM
  68     通用计时器频率配置为大约100KHz以生成事件。
  69
  70 HWCAP_AES
  71     ID_AA64ISAR0_EL1.AES == 0b0001 表示有此功能。
  72
  73 HWCAP_PMULL
  74     ID_AA64ISAR0_EL1.AES == 0b0010 表示有此功能。
  75
  76 HWCAP_SHA1
  77     ID_AA64ISAR0_EL1.SHA1 == 0b0001 表示有此功能。
  78
  79 HWCAP_SHA2
  80     ID_AA64ISAR0_EL1.SHA2 == 0b0001 表示有此功能。
  81
  82 HWCAP_CRC32
  83     ID_AA64ISAR0_EL1.CRC32 == 0b0001 表示有此功能。
  84
  85 HWCAP_ATOMICS
  86     ID_AA64ISAR0_EL1.Atomic == 0b0010 表示有此功能。
  87
  88 HWCAP_FPHP
  89     ID_AA64PFR0_EL1.FP == 0b0001 表示有此功能。
  90
  91 HWCAP_ASIMDHP
  92     ID_AA64PFR0_EL1.AdvSIMD == 0b0001 表示有此功能。
  93
  94 HWCAP_CPUID
  95     根据 Documentation/arm64/cpu-feature-registers.rst 描述，EL0 可以访问
  96     某些 ID 寄存器。
  97
  98     这些 ID 寄存器可能表示功能的可用性。
  99
 100 HWCAP_ASIMDRDM
 101     ID_AA64ISAR0_EL1.RDM == 0b0001 表示有此功能。
 102
 103 HWCAP_JSCVT
 104     ID_AA64ISAR1_EL1.JSCVT == 0b0001 表示有此功能。
 105
 106 HWCAP_FCMA
 107     ID_AA64ISAR1_EL1.FCMA == 0b0001 表示有此功能。
 108
 109 HWCAP_LRCPC
 110     ID_AA64ISAR1_EL1.LRCPC == 0b0001 表示有此功能。
 111
 112 HWCAP_DCPOP
 113     ID_AA64ISAR1_EL1.DPB == 0b0001 表示有此功能。
 114
 115 HWCAP_SHA3
 116     ID_AA64ISAR0_EL1.SHA3 == 0b0001 表示有此功能。
 117
 118 HWCAP_SM3
 119     ID_AA64ISAR0_EL1.SM3 == 0b0001 表示有此功能。
 120
 121 HWCAP_SM4
 122     ID_AA64ISAR0_EL1.SM4 == 0b0001 表示有此功能。
 123
 124 HWCAP_ASIMDDP
 125     ID_AA64ISAR0_EL1.DP == 0b0001 表示有此功能。
 126
 127 HWCAP_SHA512
 128     ID_AA64ISAR0_EL1.SHA2 == 0b0010 表示有此功能。
 129
 130 HWCAP_SVE
 131     ID_AA64PFR0_EL1.SVE == 0b0001 表示有此功能。
 132
 133 HWCAP_ASIMDFHM
 134     ID_AA64ISAR0_EL1.FHM == 0b0001 表示有此功能。
 135
 136 HWCAP_DIT
 137     ID_AA64PFR0_EL1.DIT == 0b0001 表示有此功能。
 138
 139 HWCAP_USCAT
 140     ID_AA64MMFR2_EL1.AT == 0b0001 表示有此功能。
 141
 142 HWCAP_ILRCPC
 143     ID_AA64ISAR1_EL1.LRCPC == 0b0010 表示有此功能。
 144
 145 HWCAP_FLAGM
 146     ID_AA64ISAR0_EL1.TS == 0b0001 表示有此功能。
 147
 148 HWCAP_SSBS
 149     ID_AA64PFR1_EL1.SSBS == 0b0010 表示有此功能。
 150
 151 HWCAP_SB
 152     ID_AA64ISAR1_EL1.SB == 0b0001 表示有此功能。
 153
 154 HWCAP_PACA
 155     如 Documentation/arm64/pointer-authentication.rst 所描述，
 156     ID_AA64ISAR1_EL1.APA == 0b0001 或 ID_AA64ISAR1_EL1.API == 0b0001
 157     表示有此功能。
 158
 159 HWCAP_PACG
 160     如 Documentation/arm64/pointer-authentication.rst 所描述，
 161     ID_AA64ISAR1_EL1.GPA == 0b0001 或 ID_AA64ISAR1_EL1.GPI == 0b0001
 162     表示有此功能。
 163
 164 HWCAP2_DCPODP
 165
 166     ID_AA64ISAR1_EL1.DPB == 0b0010 表示有此功能。
 167
 168 HWCAP2_SVE2
 169
 170     ID_AA64ZFR0_EL1.SVEVer == 0b0001 表示有此功能。
 171
 172 HWCAP2_SVEAES
 173
 174     ID_AA64ZFR0_EL1.AES == 0b0001 表示有此功能。
 175
 176 HWCAP2_SVEPMULL
 177
 178     ID_AA64ZFR0_EL1.AES == 0b0010 表示有此功能。
 179
 180 HWCAP2_SVEBITPERM
 181
 182     ID_AA64ZFR0_EL1.BitPerm == 0b0001 表示有此功能。
 183
 184 HWCAP2_SVESHA3
 185
 186     ID_AA64ZFR0_EL1.SHA3 == 0b0001 表示有此功能。
 187
 188 HWCAP2_SVESM4
 189
 190     ID_AA64ZFR0_EL1.SM4 == 0b0001 表示有此功能。
 191
 192 HWCAP2_FLAGM2
 193
 194     ID_AA64ISAR0_EL1.TS == 0b0010 表示有此功能。
 195
 196 HWCAP2_FRINT
 197
 198     ID_AA64ISAR1_EL1.FRINTTS == 0b0001 表示有此功能。
 199
 200 HWCAP2_SVEI8MM
 201
 202     ID_AA64ZFR0_EL1.I8MM == 0b0001 表示有此功能。
 203
 204 HWCAP2_SVEF32MM
 205
 206     ID_AA64ZFR0_EL1.F32MM == 0b0001 表示有此功能。
 207
 208 HWCAP2_SVEF64MM
 209
 210     ID_AA64ZFR0_EL1.F64MM == 0b0001 表示有此功能。
 211
 212 HWCAP2_SVEBF16
 213
 214     ID_AA64ZFR0_EL1.BF16 == 0b0001 表示有此功能。
 215
 216 HWCAP2_I8MM
 217
 218     ID_AA64ISAR1_EL1.I8MM == 0b0001 表示有此功能。
 219
 220 HWCAP2_BF16
 221
 222     ID_AA64ISAR1_EL1.BF16 == 0b0001 表示有此功能。
 223
 224 HWCAP2_DGH
 225
 226     ID_AA64ISAR1_EL1.DGH == 0b0001 表示有此功能。
 227
 228 HWCAP2_RNG
 229
 230     ID_AA64ISAR0_EL1.RNDR == 0b0001 表示有此功能。
 231
 232 HWCAP2_BTI
 233
 234     ID_AA64PFR0_EL1.BT == 0b0001 表示有此功能。
 235
 236
 237 4. 未使用的 AT_HWCAP 位
 238 -----------------------
 239
 240 为了与用户空间交互，内核保证 AT_HWCAP 的第62、63位将始终返回0。