armcap.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449
  1. /*
  2. * Copyright 2011-2025 The OpenSSL Project Authors. All Rights Reserved.
  3. *
  4. * Licensed under the Apache License 2.0 (the "License"). You may not use
  5. * this file except in compliance with the License. You can obtain a copy
  6. * in the file LICENSE in the source distribution or at
  7. * https://www.openssl.org/source/license.html
  8. */
  9. #include <stdio.h>
  10. #include <stdlib.h>
  11. #include <string.h>
  12. #include <openssl/crypto.h>
  13. #ifdef __APPLE__
  14. #include <sys/sysctl.h>
  15. #else
  16. #include <setjmp.h>
  17. #include <signal.h>
  18. #endif
  19. #include "internal/cryptlib.h"
  20. #ifdef _WIN32
  21. #include <windows.h>
  22. #else
  23. #include <unistd.h>
  24. #endif
  25. #include "arm_arch.h"
  26. unsigned int OPENSSL_armcap_P = 0;
  27. unsigned int OPENSSL_arm_midr = 0;
  28. unsigned int OPENSSL_armv8_rsa_neonized = 0;
  29. #ifdef _WIN32
  30. void OPENSSL_cpuid_setup(void)
  31. {
  32. OPENSSL_armcap_P |= ARMV7_NEON;
  33. OPENSSL_armv8_rsa_neonized = 1;
  34. if (IsProcessorFeaturePresent(PF_ARM_V8_CRYPTO_INSTRUCTIONS_AVAILABLE)) {
  35. /* These are all covered by one call in Windows */
  36. OPENSSL_armcap_P |= ARMV8_AES;
  37. OPENSSL_armcap_P |= ARMV8_PMULL;
  38. OPENSSL_armcap_P |= ARMV8_SHA1;
  39. OPENSSL_armcap_P |= ARMV8_SHA256;
  40. }
  41. }
  42. uint32_t OPENSSL_rdtsc(void)
  43. {
  44. return 0;
  45. }
  46. #elif __ARM_MAX_ARCH__ < 7
  47. void OPENSSL_cpuid_setup(void)
  48. {
  49. }
  50. uint32_t OPENSSL_rdtsc(void)
  51. {
  52. return 0;
  53. }
  54. #else /* !_WIN32 && __ARM_MAX_ARCH__ >= 7 */
  55. /* 3 ways of handling things here: __APPLE__, getauxval() or SIGILL detect */
  56. /* First determine if getauxval() is available (OSSL_IMPLEMENT_GETAUXVAL) */
  57. # if defined(__GNUC__) && __GNUC__>=2
  58. void OPENSSL_cpuid_setup(void) __attribute__ ((constructor));
  59. # endif
  60. # if defined(__GLIBC__) && defined(__GLIBC_PREREQ)
  61. # if __GLIBC_PREREQ(2, 16)
  62. # include <sys/auxv.h>
  63. # define OSSL_IMPLEMENT_GETAUXVAL
  64. # endif
  65. # elif defined(__ANDROID_API__)
  66. /* see https://developer.android.google.cn/ndk/guides/cpu-features */
  67. # if __ANDROID_API__ >= 18
  68. # include <sys/auxv.h>
  69. # define OSSL_IMPLEMENT_GETAUXVAL
  70. # endif
  71. # endif
  72. # if defined(__FreeBSD__) || defined(__OpenBSD__)
  73. # include <sys/param.h>
  74. # if (defined(__FreeBSD__) && __FreeBSD_version >= 1200000) || \
  75. (defined(__OpenBSD__) && OpenBSD >= 202409)
  76. # include <sys/auxv.h>
  77. # define OSSL_IMPLEMENT_GETAUXVAL
  78. static unsigned long getauxval(unsigned long key)
  79. {
  80. unsigned long val = 0ul;
  81. if (elf_aux_info((int)key, &val, sizeof(val)) != 0)
  82. return 0ul;
  83. return val;
  84. }
  85. # endif
  86. # endif
  87. /*
  88. * Android: according to https://developer.android.com/ndk/guides/cpu-features,
  89. * getauxval is supported starting with API level 18
  90. */
  91. # if defined(__ANDROID__) && defined(__ANDROID_API__) && __ANDROID_API__ >= 18
  92. # include <sys/auxv.h>
  93. # define OSSL_IMPLEMENT_GETAUXVAL
  94. # endif
  95. /*
  96. * ARM puts the feature bits for Crypto Extensions in AT_HWCAP2, whereas
  97. * AArch64 used AT_HWCAP.
  98. */
  99. # ifndef AT_HWCAP
  100. # define AT_HWCAP 16
  101. # endif
  102. # ifndef AT_HWCAP2
  103. # define AT_HWCAP2 26
  104. # endif
  105. # if defined(__arm__) || defined (__arm)
  106. # define OSSL_HWCAP AT_HWCAP
  107. # define OSSL_HWCAP_NEON (1 << 12)
  108. # define OSSL_HWCAP_CE AT_HWCAP2
  109. # define OSSL_HWCAP_CE_AES (1 << 0)
  110. # define OSSL_HWCAP_CE_PMULL (1 << 1)
  111. # define OSSL_HWCAP_CE_SHA1 (1 << 2)
  112. # define OSSL_HWCAP_CE_SHA256 (1 << 3)
  113. # elif defined(__aarch64__)
  114. # define OSSL_HWCAP AT_HWCAP
  115. # define OSSL_HWCAP_NEON (1 << 1)
  116. # define OSSL_HWCAP_CE AT_HWCAP
  117. # define OSSL_HWCAP_CE_AES (1 << 3)
  118. # define OSSL_HWCAP_CE_PMULL (1 << 4)
  119. # define OSSL_HWCAP_CE_SHA1 (1 << 5)
  120. # define OSSL_HWCAP_CE_SHA256 (1 << 6)
  121. # define OSSL_HWCAP_CPUID (1 << 11)
  122. # define OSSL_HWCAP_SHA3 (1 << 17)
  123. # define OSSL_HWCAP_CE_SM3 (1 << 18)
  124. # define OSSL_HWCAP_CE_SM4 (1 << 19)
  125. # define OSSL_HWCAP_CE_SHA512 (1 << 21)
  126. # define OSSL_HWCAP_SVE (1 << 22)
  127. /* AT_HWCAP2 */
  128. # define OSSL_HWCAP2 26
  129. # define OSSL_HWCAP2_SVE2 (1 << 1)
  130. # define OSSL_HWCAP2_RNG (1 << 16)
  131. # endif
  132. uint32_t _armv7_tick(void);
  133. uint32_t OPENSSL_rdtsc(void)
  134. {
  135. if (OPENSSL_armcap_P & ARMV7_TICK)
  136. return _armv7_tick();
  137. else
  138. return 0;
  139. }
  140. # ifdef __aarch64__
  141. size_t OPENSSL_rndr_asm(unsigned char *buf, size_t len);
  142. size_t OPENSSL_rndrrs_asm(unsigned char *buf, size_t len);
  143. size_t OPENSSL_rndr_bytes(unsigned char *buf, size_t len);
  144. size_t OPENSSL_rndrrs_bytes(unsigned char *buf, size_t len);
  145. static size_t OPENSSL_rndr_wrapper(size_t (*func)(unsigned char *, size_t), unsigned char *buf, size_t len)
  146. {
  147. size_t buffer_size = 0;
  148. int i;
  149. for (i = 0; i < 8; i++) {
  150. buffer_size = func(buf, len);
  151. if (buffer_size == len)
  152. break;
  153. usleep(5000); /* 5000 microseconds (5 milliseconds) */
  154. }
  155. return buffer_size;
  156. }
  157. size_t OPENSSL_rndr_bytes(unsigned char *buf, size_t len)
  158. {
  159. return OPENSSL_rndr_wrapper(OPENSSL_rndr_asm, buf, len);
  160. }
  161. size_t OPENSSL_rndrrs_bytes(unsigned char *buf, size_t len)
  162. {
  163. return OPENSSL_rndr_wrapper(OPENSSL_rndrrs_asm, buf, len);
  164. }
  165. # endif
  166. # if !defined(__APPLE__) && !defined(OSSL_IMPLEMENT_GETAUXVAL)
  167. static sigset_t all_masked;
  168. static sigjmp_buf ill_jmp;
  169. static void ill_handler(int sig)
  170. {
  171. siglongjmp(ill_jmp, sig);
  172. }
  173. /*
  174. * Following subroutines could have been inlined, but not all
  175. * ARM compilers support inline assembler, and we'd then have to
  176. * worry about the compiler optimising out the detection code...
  177. */
  178. void _armv7_neon_probe(void);
  179. void _armv8_aes_probe(void);
  180. void _armv8_sha1_probe(void);
  181. void _armv8_sha256_probe(void);
  182. void _armv8_pmull_probe(void);
  183. # ifdef __aarch64__
  184. void _armv8_sm3_probe(void);
  185. void _armv8_sm4_probe(void);
  186. void _armv8_sha512_probe(void);
  187. void _armv8_eor3_probe(void);
  188. void _armv8_sve_probe(void);
  189. void _armv8_sve2_probe(void);
  190. void _armv8_rng_probe(void);
  191. # endif
  192. # endif /* !__APPLE__ && !OSSL_IMPLEMENT_GETAUXVAL */
  193. /* We only call _armv8_cpuid_probe() if (OPENSSL_armcap_P & ARMV8_CPUID) != 0 */
  194. unsigned int _armv8_cpuid_probe(void);
  195. # if defined(__APPLE__)
  196. /*
  197. * Checks the specified integer sysctl, returning `value` if it's 1, otherwise returning 0.
  198. */
  199. static unsigned int sysctl_query(const char *name, unsigned int value)
  200. {
  201. unsigned int sys_value = 0;
  202. size_t len = sizeof(sys_value);
  203. return (sysctlbyname(name, &sys_value, &len, NULL, 0) == 0 && sys_value == 1) ? value : 0;
  204. }
  205. # elif !defined(OSSL_IMPLEMENT_GETAUXVAL)
  206. /*
  207. * Calls a provided probe function, which may SIGILL. If it doesn't, return `value`, otherwise return 0.
  208. */
  209. static unsigned int arm_probe_for(void (*probe)(void), volatile unsigned int value)
  210. {
  211. if (sigsetjmp(ill_jmp, 1) == 0) {
  212. probe();
  213. return value;
  214. } else {
  215. /* The probe function gave us SIGILL */
  216. return 0;
  217. }
  218. }
  219. # endif
  220. void OPENSSL_cpuid_setup(void)
  221. {
  222. const char *e;
  223. # if !defined(__APPLE__) && !defined(OSSL_IMPLEMENT_GETAUXVAL)
  224. struct sigaction ill_oact, ill_act;
  225. sigset_t oset;
  226. # endif
  227. static int trigger = 0;
  228. if (trigger)
  229. return;
  230. trigger = 1;
  231. OPENSSL_armcap_P = 0;
  232. if ((e = getenv("OPENSSL_armcap"))) {
  233. OPENSSL_armcap_P = (unsigned int)strtoul(e, NULL, 0);
  234. return;
  235. }
  236. # if defined(__APPLE__)
  237. # if !defined(__aarch64__)
  238. /*
  239. * Capability probing by catching SIGILL appears to be problematic
  240. * on iOS. But since Apple universe is "monocultural", it's actually
  241. * possible to simply set pre-defined processor capability mask.
  242. */
  243. if (1) {
  244. OPENSSL_armcap_P = ARMV7_NEON;
  245. return;
  246. }
  247. # else
  248. {
  249. /*
  250. * From
  251. * https://github.com/llvm/llvm-project/blob/412237dcd07e5a2afbb1767858262a5f037149a3/llvm/lib/Target/AArch64/AArch64.td#L719
  252. * all of these have been available on 64-bit Apple Silicon from the
  253. * beginning (the A7).
  254. */
  255. OPENSSL_armcap_P |= ARMV7_NEON | ARMV8_PMULL | ARMV8_AES | ARMV8_SHA1 | ARMV8_SHA256;
  256. /* More recent extensions are indicated by sysctls */
  257. OPENSSL_armcap_P |= sysctl_query("hw.optional.armv8_2_sha512", ARMV8_SHA512);
  258. OPENSSL_armcap_P |= sysctl_query("hw.optional.armv8_2_sha3", ARMV8_SHA3);
  259. if (OPENSSL_armcap_P & ARMV8_SHA3) {
  260. char uarch[64];
  261. size_t len = sizeof(uarch);
  262. if ((sysctlbyname("machdep.cpu.brand_string", uarch, &len, NULL, 0) == 0) &&
  263. ((strncmp(uarch, "Apple M1", 8) == 0) ||
  264. (strncmp(uarch, "Apple M2", 8) == 0) ||
  265. (strncmp(uarch, "Apple M3", 8) == 0) ||
  266. (strncmp(uarch, "Apple M4", 8) == 0))) {
  267. OPENSSL_armcap_P |= ARMV8_UNROLL8_EOR3;
  268. OPENSSL_armcap_P |= ARMV8_HAVE_SHA3_AND_WORTH_USING;
  269. }
  270. }
  271. }
  272. # endif /* __aarch64__ */
  273. # elif defined(OSSL_IMPLEMENT_GETAUXVAL)
  274. if (getauxval(OSSL_HWCAP) & OSSL_HWCAP_NEON) {
  275. unsigned long hwcap = getauxval(OSSL_HWCAP_CE);
  276. OPENSSL_armcap_P |= ARMV7_NEON;
  277. if (hwcap & OSSL_HWCAP_CE_AES)
  278. OPENSSL_armcap_P |= ARMV8_AES;
  279. if (hwcap & OSSL_HWCAP_CE_PMULL)
  280. OPENSSL_armcap_P |= ARMV8_PMULL;
  281. if (hwcap & OSSL_HWCAP_CE_SHA1)
  282. OPENSSL_armcap_P |= ARMV8_SHA1;
  283. if (hwcap & OSSL_HWCAP_CE_SHA256)
  284. OPENSSL_armcap_P |= ARMV8_SHA256;
  285. # ifdef __aarch64__
  286. if (hwcap & OSSL_HWCAP_CE_SM4)
  287. OPENSSL_armcap_P |= ARMV8_SM4;
  288. if (hwcap & OSSL_HWCAP_CE_SHA512)
  289. OPENSSL_armcap_P |= ARMV8_SHA512;
  290. if (hwcap & OSSL_HWCAP_CPUID)
  291. OPENSSL_armcap_P |= ARMV8_CPUID;
  292. if (hwcap & OSSL_HWCAP_CE_SM3)
  293. OPENSSL_armcap_P |= ARMV8_SM3;
  294. if (hwcap & OSSL_HWCAP_SHA3)
  295. OPENSSL_armcap_P |= ARMV8_SHA3;
  296. # endif
  297. }
  298. # ifdef __aarch64__
  299. if (getauxval(OSSL_HWCAP) & OSSL_HWCAP_SVE)
  300. OPENSSL_armcap_P |= ARMV8_SVE;
  301. if (getauxval(OSSL_HWCAP2) & OSSL_HWCAP2_SVE2)
  302. OPENSSL_armcap_P |= ARMV8_SVE2;
  303. if (getauxval(OSSL_HWCAP2) & OSSL_HWCAP2_RNG)
  304. OPENSSL_armcap_P |= ARMV8_RNG;
  305. # endif
  306. # else /* !__APPLE__ && !OSSL_IMPLEMENT_GETAUXVAL */
  307. /* If all else fails, do brute force SIGILL-based feature detection */
  308. sigfillset(&all_masked);
  309. sigdelset(&all_masked, SIGILL);
  310. sigdelset(&all_masked, SIGTRAP);
  311. sigdelset(&all_masked, SIGFPE);
  312. sigdelset(&all_masked, SIGBUS);
  313. sigdelset(&all_masked, SIGSEGV);
  314. memset(&ill_act, 0, sizeof(ill_act));
  315. ill_act.sa_handler = ill_handler;
  316. ill_act.sa_mask = all_masked;
  317. sigprocmask(SIG_SETMASK, &ill_act.sa_mask, &oset);
  318. sigaction(SIGILL, &ill_act, &ill_oact);
  319. OPENSSL_armcap_P |= arm_probe_for(_armv7_neon_probe, ARMV7_NEON);
  320. if (OPENSSL_armcap_P & ARMV7_NEON) {
  321. OPENSSL_armcap_P |= arm_probe_for(_armv8_pmull_probe, ARMV8_PMULL | ARMV8_AES);
  322. if (!(OPENSSL_armcap_P & ARMV8_AES)) {
  323. OPENSSL_armcap_P |= arm_probe_for(_armv8_aes_probe, ARMV8_AES);
  324. }
  325. OPENSSL_armcap_P |= arm_probe_for(_armv8_sha1_probe, ARMV8_SHA1);
  326. OPENSSL_armcap_P |= arm_probe_for(_armv8_sha256_probe, ARMV8_SHA256);
  327. # if defined(__aarch64__)
  328. OPENSSL_armcap_P |= arm_probe_for(_armv8_sm3_probe, ARMV8_SM3);
  329. OPENSSL_armcap_P |= arm_probe_for(_armv8_sm4_probe, ARMV8_SM4);
  330. OPENSSL_armcap_P |= arm_probe_for(_armv8_sha512_probe, ARMV8_SHA512);
  331. OPENSSL_armcap_P |= arm_probe_for(_armv8_eor3_probe, ARMV8_SHA3);
  332. # endif
  333. }
  334. # ifdef __aarch64__
  335. OPENSSL_armcap_P |= arm_probe_for(_armv8_sve_probe, ARMV8_SVE);
  336. OPENSSL_armcap_P |= arm_probe_for(_armv8_sve2_probe, ARMV8_SVE2);
  337. OPENSSL_armcap_P |= arm_probe_for(_armv8_rng_probe, ARMV8_RNG);
  338. # endif
  339. /*
  340. * Probing for ARMV7_TICK is known to produce unreliable results,
  341. * so we only use the feature when the user explicitly enables it
  342. * with OPENSSL_armcap.
  343. */
  344. sigaction(SIGILL, &ill_oact, NULL);
  345. sigprocmask(SIG_SETMASK, &oset, NULL);
  346. # endif /* __APPLE__, OSSL_IMPLEMENT_GETAUXVAL */
  347. # ifdef __aarch64__
  348. if (OPENSSL_armcap_P & ARMV8_CPUID)
  349. OPENSSL_arm_midr = _armv8_cpuid_probe();
  350. if ((MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_CORTEX_A72) ||
  351. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_N1)) &&
  352. (OPENSSL_armcap_P & ARMV7_NEON)) {
  353. OPENSSL_armv8_rsa_neonized = 1;
  354. }
  355. if ((MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_V1) ||
  356. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_N2) ||
  357. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_MICROSOFT, MICROSOFT_CPU_PART_COBALT_100) ||
  358. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_V2) ||
  359. MIDR_IMPLEMENTER(OPENSSL_arm_midr) == ARM_CPU_IMP_AMPERE) &&
  360. (OPENSSL_armcap_P & ARMV8_SHA3))
  361. OPENSSL_armcap_P |= ARMV8_UNROLL8_EOR3;
  362. if ((MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_V1) ||
  363. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_ARM, ARM_CPU_PART_V2) ||
  364. MIDR_IMPLEMENTER(OPENSSL_arm_midr) == ARM_CPU_IMP_AMPERE) &&
  365. (OPENSSL_armcap_P & ARMV8_SHA3))
  366. OPENSSL_armcap_P |= ARMV8_UNROLL12_EOR3;
  367. if ((MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_FIRESTORM) ||
  368. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_ICESTORM) ||
  369. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_FIRESTORM_PRO) ||
  370. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_ICESTORM_PRO) ||
  371. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_FIRESTORM_MAX) ||
  372. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M1_ICESTORM_MAX) ||
  373. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_AVALANCHE) ||
  374. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_BLIZZARD) ||
  375. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_AVALANCHE_PRO) ||
  376. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_BLIZZARD_PRO) ||
  377. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_AVALANCHE_MAX) ||
  378. MIDR_IS_CPU_MODEL(OPENSSL_arm_midr, ARM_CPU_IMP_APPLE, APPLE_CPU_PART_M2_BLIZZARD_MAX)) &&
  379. (OPENSSL_armcap_P & ARMV8_SHA3))
  380. OPENSSL_armcap_P |= ARMV8_HAVE_SHA3_AND_WORTH_USING;
  381. # endif
  382. }
  383. #endif /* _WIN32, __ARM_MAX_ARCH__ >= 7 */