1.. SPDX-License-Identifier: GPL-2.0 2 3.. include:: ../../disclaimer-zh_TW.rst 4 5:Original: :ref:`Documentation/arch/arm64/elf_hwcaps.rst <elf_hwcaps_index>` 6 7Translator: Bailu Lin <bailu.lin@vivo.com> 8 Hu Haowen <src.res.211@gmail.com> 9 10================ 11ARM64 ELF hwcaps 12================ 13 14這篇文檔描述了 arm64 ELF hwcaps 的用法和語義。 15 16 171. 簡介 18------- 19 20有些硬件或軟件功能僅在某些 CPU 實現上和/或在具體某個內核配置上可用，但 21對於處於 EL0 的用戶空間代碼沒有可用的架構發現機制。內核通過在輔助向量表 22公開一組稱爲 hwcaps 的標誌而把這些功能暴露給用戶空間。 23 24用戶空間軟件可以通過獲取輔助向量的 AT_HWCAP 或 AT_HWCAP2 條目來測試功能， 25並測試是否設置了相關標誌，例如:: 26 27 bool floating_point_is_present(void) 28 { 29 unsigned long hwcaps = getauxval(AT_HWCAP); 30 if (hwcaps & HWCAP_FP) 31 return true; 32 33 return false; 34 } 35 36如果軟件依賴於 hwcap 描述的功能，在嘗試使用該功能前則應檢查相關的 hwcap 37標誌以驗證該功能是否存在。 38 39不能通過其他方式探查這些功能。當一個功能不可用時，嘗試使用它可能導致不可 40預測的行爲，並且無法保證能確切的知道該功能不可用，例如 SIGILL。 41 42 432. Hwcaps 的說明 44---------------- 45 46大多數 hwcaps 旨在說明通過架構 ID 寄存器(處於 EL0 的用戶空間代碼無法訪問) 47描述的功能的存在。這些 hwcap 通過 ID 寄存器字段定義，並且應根據 ARM 體系 48結構參考手冊（ARM ARM）中定義的字段來解釋說明。 49 50這些 hwcaps 以下面的形式描述:: 51 52 idreg.field == val 表示有某個功能。 53 54當 idreg.field 中有 val 時，hwcaps 表示 ARM ARM 定義的功能是有效的，但是 55並不是說要完全和 val 相等，也不是說 idreg.field 描述的其他功能就是缺失的。 56 57其他 hwcaps 可能表明無法僅由 ID 寄存器描述的功能的存在。這些 hwcaps 可能 58沒有被 ID 寄存器描述，需要參考其他文檔。 59 60 613. AT_HWCAP 中揭示的 hwcaps 62--------------------------- 63 64HWCAP_FP 65 ID_AA64PFR0_EL1.FP == 0b0000 表示有此功能。 66 67HWCAP_ASIMD 68 ID_AA64PFR0_EL1.AdvSIMD == 0b0000 表示有此功能。 69 70HWCAP_EVTSTRM 71 通用計時器頻率配置爲大約100KHz以生成事件。 72 73HWCAP_AES 74 ID_AA64ISAR0_EL1.AES == 0b0001 表示有此功能。 75 76HWCAP_PMULL 77 ID_AA64ISAR0_EL1.AES == 0b0010 表示有此功能。 78 79HWCAP_SHA1 80 ID_AA64ISAR0_EL1.SHA1 == 0b0001 表示有此功能。 81 82HWCAP_SHA2 83 ID_AA64ISAR0_EL1.SHA2 == 0b0001 表示有此功能。 84 85HWCAP_CRC32 86 ID_AA64ISAR0_EL1.CRC32 == 0b0001 表示有此功能。 87 88HWCAP_ATOMICS 89 ID_AA64ISAR0_EL1.Atomic == 0b0010 表示有此功能。 90 91HWCAP_FPHP 92 ID_AA64PFR0_EL1.FP == 0b0001 表示有此功能。 93 94HWCAP_ASIMDHP 95 ID_AA64PFR0_EL1.AdvSIMD == 0b0001 表示有此功能。 96 97HWCAP_CPUID 98 根據 Documentation/arch/arm64/cpu-feature-registers.rst 描述，EL0 可以訪問 99 某些 ID 寄存器。 100 101 這些 ID 寄存器可能表示功能的可用性。 102 103HWCAP_ASIMDRDM 104 ID_AA64ISAR0_EL1.RDM == 0b0001 表示有此功能。 105 106HWCAP_JSCVT 107 ID_AA64ISAR1_EL1.JSCVT == 0b0001 表示有此功能。 108 109HWCAP_FCMA 110 ID_AA64ISAR1_EL1.FCMA == 0b0001 表示有此功能。 111 112HWCAP_LRCPC 113 ID_AA64ISAR1_EL1.LRCPC == 0b0001 表示有此功能。 114 115HWCAP_DCPOP 116 ID_AA64ISAR1_EL1.DPB == 0b0001 表示有此功能。 117 118HWCAP_SHA3 119 ID_AA64ISAR0_EL1.SHA3 == 0b0001 表示有此功能。 120 121HWCAP_SM3 122 ID_AA64ISAR0_EL1.SM3 == 0b0001 表示有此功能。 123 124HWCAP_SM4 125 ID_AA64ISAR0_EL1.SM4 == 0b0001 表示有此功能。 126 127HWCAP_ASIMDDP 128 ID_AA64ISAR0_EL1.DP == 0b0001 表示有此功能。 129 130HWCAP_SHA512 131 ID_AA64ISAR0_EL1.SHA2 == 0b0010 表示有此功能。 132 133HWCAP_SVE 134 ID_AA64PFR0_EL1.SVE == 0b0001 表示有此功能。 135 136HWCAP_ASIMDFHM 137 ID_AA64ISAR0_EL1.FHM == 0b0001 表示有此功能。 138 139HWCAP_DIT 140 ID_AA64PFR0_EL1.DIT == 0b0001 表示有此功能。 141 142HWCAP_USCAT 143 ID_AA64MMFR2_EL1.AT == 0b0001 表示有此功能。 144 145HWCAP_ILRCPC 146 ID_AA64ISAR1_EL1.LRCPC == 0b0010 表示有此功能。 147 148HWCAP_FLAGM 149 ID_AA64ISAR0_EL1.TS == 0b0001 表示有此功能。 150 151HWCAP_SSBS 152 ID_AA64PFR1_EL1.SSBS == 0b0010 表示有此功能。 153 154HWCAP_SB 155 ID_AA64ISAR1_EL1.SB == 0b0001 表示有此功能。 156 157HWCAP_PACA 158 如 Documentation/arch/arm64/pointer-authentication.rst 所描述， 159 ID_AA64ISAR1_EL1.APA == 0b0001 或 ID_AA64ISAR1_EL1.API == 0b0001 160 表示有此功能。 161 162HWCAP_PACG 163 如 Documentation/arch/arm64/pointer-authentication.rst 所描述， 164 ID_AA64ISAR1_EL1.GPA == 0b0001 或 ID_AA64ISAR1_EL1.GPI == 0b0001 165 表示有此功能。 166 167HWCAP2_DCPODP 168 169 ID_AA64ISAR1_EL1.DPB == 0b0010 表示有此功能。 170 171HWCAP2_SVE2 172 173 ID_AA64ZFR0_EL1.SVEVer == 0b0001 表示有此功能。 174 175HWCAP2_SVEAES 176 177 ID_AA64ZFR0_EL1.AES == 0b0001 表示有此功能。 178 179HWCAP2_SVEPMULL 180 181 ID_AA64ZFR0_EL1.AES == 0b0010 表示有此功能。 182 183HWCAP2_SVEBITPERM 184 185 ID_AA64ZFR0_EL1.BitPerm == 0b0001 表示有此功能。 186 187HWCAP2_SVESHA3 188 189 ID_AA64ZFR0_EL1.SHA3 == 0b0001 表示有此功能。 190 191HWCAP2_SVESM4 192 193 ID_AA64ZFR0_EL1.SM4 == 0b0001 表示有此功能。 194 195HWCAP2_FLAGM2 196 197 ID_AA64ISAR0_EL1.TS == 0b0010 表示有此功能。 198 199HWCAP2_FRINT 200 201 ID_AA64ISAR1_EL1.FRINTTS == 0b0001 表示有此功能。 202 203HWCAP2_SVEI8MM 204 205 ID_AA64ZFR0_EL1.I8MM == 0b0001 表示有此功能。 206 207HWCAP2_SVEF32MM 208 209 ID_AA64ZFR0_EL1.F32MM == 0b0001 表示有此功能。 210 211HWCAP2_SVEF64MM 212 213 ID_AA64ZFR0_EL1.F64MM == 0b0001 表示有此功能。 214 215HWCAP2_SVEBF16 216 217 ID_AA64ZFR0_EL1.BF16 == 0b0001 表示有此功能。 218 219HWCAP2_I8MM 220 221 ID_AA64ISAR1_EL1.I8MM == 0b0001 表示有此功能。 222 223HWCAP2_BF16 224 225 ID_AA64ISAR1_EL1.BF16 == 0b0001 表示有此功能。 226 227HWCAP2_DGH 228 229 ID_AA64ISAR1_EL1.DGH == 0b0001 表示有此功能。 230 231HWCAP2_RNG 232 233 ID_AA64ISAR0_EL1.RNDR == 0b0001 表示有此功能。 234 235HWCAP2_BTI 236 237 ID_AA64PFR0_EL1.BT == 0b0001 表示有此功能。 238 239 2404. 未使用的 AT_HWCAP 位 241----------------------- 242 243爲了與用戶空間交互，內核保證 AT_HWCAP 的第62、63位將始終返回0。 244 245