1 .. include:: ../../disclaimer-zh_CN.rst
2
3 :Original: :ref:`Documentation/arch/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/arch/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/arch/arm64/pointer-authentication.rst 所描述，
156 ID_AA64ISAR1_EL1.APA == 0b0001 或 ID_AA64ISAR1_EL1.API == 0b0001
157 表示有此功能。
158
159 HWCAP_PACG
160 如 Documentation/arch/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。
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.