Lib.rs

› Hardware support
#cpuid #target-feature

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

by Tony Arcieri, Artyom Pavlov, RustCrypto Developers (57 contributors). Co-owned by Rust Crypto.

13 releases

0.2.11 Oct 26, 2023
0.2.9 Jul 5, 2023
0.2.6 Mar 25, 2023
0.2.5 Sep 4, 2022
0.1.5 Jun 22, 2021

#2 in Hardware support

Download history 1188718/week @ 2023-08-16 1259192/week @ 2023-08-23 1161188/week @ 2023-08-30 1273948/week @ 2023-09-06 1266471/week @ 2023-09-13 1280412/week @ 2023-09-20 1274056/week @ 2023-09-27 1317162/week @ 2023-10-04 1406417/week @ 2023-10-11 1453740/week @ 2023-10-18 1518765/week @ 2023-10-25 1473140/week @ 2023-11-01 1494442/week @ 2023-11-08 1516363/week @ 2023-11-15 1284330/week @ 2023-11-22 1213692/week @ 2023-11-29

5,787,158 downloads per month
Used in 16,954 crates (23 directly)

MIT/Apache

25KB
383 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