1.. include:: ../../disclaimer-zh_CN.rst 2 3:Original: :ref:`Documentation/arch/arm64/elf_hwcaps.rst <elf_hwcaps_index>` 4 5Translator: Bailu Lin <bailu.lin@vivo.com> 6 7================ 8ARM64 ELF hwcaps 9================ 10 11这篇文档描述了 arm64 ELF hwcaps 的用法和语义。 12 13 141. 简介 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 402. 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 583. AT_HWCAP 中揭示的 hwcaps 59--------------------------- 60 61HWCAP_FP 62 ID_AA64PFR0_EL1.FP == 0b0000 表示有此功能。 63 64HWCAP_ASIMD 65 ID_AA64PFR0_EL1.AdvSIMD == 0b0000 表示有此功能。 66 67HWCAP_EVTSTRM 68 通用计时器频率配置为大约100KHz以生成事件。 69 70HWCAP_AES 71 ID_AA64ISAR0_EL1.AES == 0b0001 表示有此功能。 72 73HWCAP_PMULL 74 ID_AA64ISAR0_EL1.AES == 0b0010 表示有此功能。 75 76HWCAP_SHA1 77 ID_AA64ISAR0_EL1.SHA1 == 0b0001 表示有此功能。 78 79HWCAP_SHA2 80 ID_AA64ISAR0_EL1.SHA2 == 0b0001 表示有此功能。 81 82HWCAP_CRC32 83 ID_AA64ISAR0_EL1.CRC32 == 0b0001 表示有此功能。 84 85HWCAP_ATOMICS 86 ID_AA64ISAR0_EL1.Atomic == 0b0010 表示有此功能。 87 88HWCAP_FPHP 89 ID_AA64PFR0_EL1.FP == 0b0001 表示有此功能。 90 91HWCAP_ASIMDHP 92 ID_AA64PFR0_EL1.AdvSIMD == 0b0001 表示有此功能。 93 94HWCAP_CPUID 95 根据 Documentation/arch/arm64/cpu-feature-registers.rst 描述，EL0 可以访问 96 某些 ID 寄存器。 97 98 这些 ID 寄存器可能表示功能的可用性。 99 100HWCAP_ASIMDRDM 101 ID_AA64ISAR0_EL1.RDM == 0b0001 表示有此功能。 102 103HWCAP_JSCVT 104 ID_AA64ISAR1_EL1.JSCVT == 0b0001 表示有此功能。 105 106HWCAP_FCMA 107 ID_AA64ISAR1_EL1.FCMA == 0b0001 表示有此功能。 108 109HWCAP_LRCPC 110 ID_AA64ISAR1_EL1.LRCPC == 0b0001 表示有此功能。 111 112HWCAP_DCPOP 113 ID_AA64ISAR1_EL1.DPB == 0b0001 表示有此功能。 114 115HWCAP_SHA3 116 ID_AA64ISAR0_EL1.SHA3 == 0b0001 表示有此功能。 117 118HWCAP_SM3 119 ID_AA64ISAR0_EL1.SM3 == 0b0001 表示有此功能。 120 121HWCAP_SM4 122 ID_AA64ISAR0_EL1.SM4 == 0b0001 表示有此功能。 123 124HWCAP_ASIMDDP 125 ID_AA64ISAR0_EL1.DP == 0b0001 表示有此功能。 126 127HWCAP_SHA512 128 ID_AA64ISAR0_EL1.SHA2 == 0b0010 表示有此功能。 129 130HWCAP_SVE 131 ID_AA64PFR0_EL1.SVE == 0b0001 表示有此功能。 132 133HWCAP_ASIMDFHM 134 ID_AA64ISAR0_EL1.FHM == 0b0001 表示有此功能。 135 136HWCAP_DIT 137 ID_AA64PFR0_EL1.DIT == 0b0001 表示有此功能。 138 139HWCAP_USCAT 140 ID_AA64MMFR2_EL1.AT == 0b0001 表示有此功能。 141 142HWCAP_ILRCPC 143 ID_AA64ISAR1_EL1.LRCPC == 0b0010 表示有此功能。 144 145HWCAP_FLAGM 146 ID_AA64ISAR0_EL1.TS == 0b0001 表示有此功能。 147 148HWCAP_SSBS 149 ID_AA64PFR1_EL1.SSBS == 0b0010 表示有此功能。 150 151HWCAP_SB 152 ID_AA64ISAR1_EL1.SB == 0b0001 表示有此功能。 153 154HWCAP_PACA 155 如 Documentation/arch/arm64/pointer-authentication.rst 所描述， 156 ID_AA64ISAR1_EL1.APA == 0b0001 或 ID_AA64ISAR1_EL1.API == 0b0001 157 表示有此功能。 158 159HWCAP_PACG 160 如 Documentation/arch/arm64/pointer-authentication.rst 所描述， 161 ID_AA64ISAR1_EL1.GPA == 0b0001 或 ID_AA64ISAR1_EL1.GPI == 0b0001 162 表示有此功能。 163 164HWCAP2_DCPODP 165 166 ID_AA64ISAR1_EL1.DPB == 0b0010 表示有此功能。 167 168HWCAP2_SVE2 169 170 ID_AA64ZFR0_EL1.SVEVer == 0b0001 表示有此功能。 171 172HWCAP2_SVEAES 173 174 ID_AA64ZFR0_EL1.AES == 0b0001 表示有此功能。 175 176HWCAP2_SVEPMULL 177 178 ID_AA64ZFR0_EL1.AES == 0b0010 表示有此功能。 179 180HWCAP2_SVEBITPERM 181 182 ID_AA64ZFR0_EL1.BitPerm == 0b0001 表示有此功能。 183 184HWCAP2_SVESHA3 185 186 ID_AA64ZFR0_EL1.SHA3 == 0b0001 表示有此功能。 187 188HWCAP2_SVESM4 189 190 ID_AA64ZFR0_EL1.SM4 == 0b0001 表示有此功能。 191 192HWCAP2_FLAGM2 193 194 ID_AA64ISAR0_EL1.TS == 0b0010 表示有此功能。 195 196HWCAP2_FRINT 197 198 ID_AA64ISAR1_EL1.FRINTTS == 0b0001 表示有此功能。 199 200HWCAP2_SVEI8MM 201 202 ID_AA64ZFR0_EL1.I8MM == 0b0001 表示有此功能。 203 204HWCAP2_SVEF32MM 205 206 ID_AA64ZFR0_EL1.F32MM == 0b0001 表示有此功能。 207 208HWCAP2_SVEF64MM 209 210 ID_AA64ZFR0_EL1.F64MM == 0b0001 表示有此功能。 211 212HWCAP2_SVEBF16 213 214 ID_AA64ZFR0_EL1.BF16 == 0b0001 表示有此功能。 215 216HWCAP2_I8MM 217 218 ID_AA64ISAR1_EL1.I8MM == 0b0001 表示有此功能。 219 220HWCAP2_BF16 221 222 ID_AA64ISAR1_EL1.BF16 == 0b0001 表示有此功能。 223 224HWCAP2_DGH 225 226 ID_AA64ISAR1_EL1.DGH == 0b0001 表示有此功能。 227 228HWCAP2_RNG 229 230 ID_AA64ISAR0_EL1.RNDR == 0b0001 表示有此功能。 231 232HWCAP2_BTI 233 234 ID_AA64PFR0_EL1.BT == 0b0001 表示有此功能。 235 236 2374. 未使用的 AT_HWCAP 位 238----------------------- 239 240为了与用户空间交互，内核保证 AT_HWCAP 的第62、63位将始终返回0。 241