#cpu #detection #aarch64 #x86-64 #run-time #ios #mobile

no-std cpufeatures

Lightweight runtime CPU feature detection for aarch64, loongarch64, and x86/x86_64 targets, with no_std support and support for mobile targets including Android and iOS

14 releases

0.2.12 Jan 4, 2024
0.2.11 Oct 26, 2023
0.2.9 Jul 5, 2023
0.2.6 Mar 25, 2023
0.1.5 Jun 22, 2021

#11 in Hardware support

Download history 1521097/week @ 2023-12-07 1432544/week @ 2023-12-14 952249/week @ 2023-12-21 1005001/week @ 2023-12-28 1508751/week @ 2024-01-04 1518974/week @ 2024-01-11 1673663/week @ 2024-01-18 1596254/week @ 2024-01-25 1655280/week @ 2024-02-01 1637654/week @ 2024-02-08 1582025/week @ 2024-02-15 1652468/week @ 2024-02-22 1718688/week @ 2024-02-29 1711762/week @ 2024-03-07 1738675/week @ 2024-03-14 1460324/week @ 2024-03-21

6,924,262 downloads per month
Used in 19,040 crates (23 directly)

MIT/Apache

26KB
388 lines

RustCrypto: CPU Feature Detection

crate Docs Apache2/MIT licensed Rust Version Project Chat Build Status

Lightweight and efficient runtime CPU feature detection for aarch64, loongarch64, and x86/x86_64 targets.

Supports no_std as well as mobile targets including iOS and Android, providing an alternative to the std-dependent is_x86_feature_detected! macro.

Documentation

Supported target architectures

*NOTE: target features with an asterisk are unstable (nightly-only) and subject to change to match upstream name changes in the Rust standard library.

aarch64

Linux, iOS, and macOS/ARM only (ARM64 does not support OS-independent feature detection)

Target features:

  • aes*
  • sha2*
  • sha3*

loongarch64

Linux only (LoongArch64 does not support OS-independent feature detection)

Target features:

  • lam*
  • ual*
  • fpu*
  • lsx*
  • lasx*
  • crc32*
  • complex*
  • crypto*
  • lvz*
  • lbt.x86*
  • lbt.arm*
  • lbt.mips*
  • ptw*

x86/x86_64

OS independent and no_std-friendly

Target features:

  • adx
  • aes
  • avx
  • avx2
  • avx512bw*
  • avx512cd*
  • avx512dq*
  • avx512er*
  • avx512f*
  • avx512ifma*
  • avx512pf*
  • avx512vl*
  • avx512vbmi*
  • avx512vbmi2*
  • bmi1
  • bmi2
  • fma,
  • mmx
  • pclmulqdq
  • popcnt
  • rdrand
  • rdseed
  • sgx
  • sha
  • sse
  • sse2
  • sse3
  • sse4.1
  • sse4.2
  • ssse3

If you would like detection support for a target feature which is not on this list, please open a GitHub issue.

License

Licensed under either of:

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies