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
7 Translator: Bailu Lin <bailu.lin@vivo.com>
8 Hu Haowen <2023002089@link.tyut.edu.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/arch/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/arch/arm64/pointer-authentication.rst 所描述，
159 ID_AA64ISAR1_EL1.APA == 0b0001 或 ID_AA64ISAR1_EL1.API == 0b0001
160 表示有此功能。
161
162 HWCAP_PACG
163 如 Documentation/arch/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
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.