Documentation/translations/zh_TW/arm64/elf_hwcaps.rst

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