70 lines
12 KiB
Plaintext
70 lines
12 KiB
Plaintext
|
rust
|
|||
|
|
‡0 #rustc 1.93.0 (254b59607 2026-01-19)Á³VOÐêùÿ²?ÑL¼�§Ì± -a7a40eb546f9e2b0Á à *Aqu¯™ §þI4?»R -ad9e219d1461fd28Á ë&Gf·Ã ¬ëñq:¤»b -bb76018b1173caf6Á‰ __detect_target_featuresÁĤ ØLÊ linuxÁ<Ö œÊ ØLß androidÁLë ¬ß üÉ, getauxval_hwcapÁ|Ï ØLš Ý<¦ œš ØL¯ öL» ¬¯ ü™, __expand_check_macroÁ¤„ ØLÉ Ý<Õ œÉ ØLÞ öLê ¬Þ üÈ , hwcapsÁ4á ØL« Ý<· œ« ØLÀ öLÌ ¬À üª, ³Ä‚( Ûl�' appleÁ<�' ¼�' ØL¦' Ý<²' œ¦' ØL»' öLÇ' ¬»' üŒ'F üˆ'K ë \¿Ê\Šë l˜ÜŠ Ø œ Ê\éØ,÷œéÊ\þÙDŒ ´þüè- å
|
|||
|
|
$³ å
|
|||
|
|
$¨ ³ ½ __unless_target_featuresÁ ³ checkÁ sysctlbynameÁ •
|
|||
|
|
³ ¿Ä‘ ³Ä»
|
|||
|
|
å,÷ • ô ü Ô/ ü O L This crate provides macros for runtime CPU feature detection. It's intendedÁ üPR O as a stopgap until Rust [RFC 2725] adding first-class target feature detectionÁ ü£' $ macros to `libcore` is implemented.Á ËË üÏ$ ! # Supported target architecturesÁ ôË üøK H *NOTE: target features with an asterisk are unstable (nightly-only) andÁ üÄI F subject to change to match upstream name changes in the Rust standardÁ dŽ library.Á ›Ë „Ÿ
|
|||
|
|
## `aarch64`Á °Ë ü´\ Y Linux, iOS, and macOS/ARM only (ARM64 does not support OS-independent feature detection)Á ‘Ë ¤• Target features:Á ªË d® - `aes`*Á l»
|
|||
|
|
- `sha2`*Á lÉ
|
|||
|
|
- `sha3`*Á ×Ë tÛ Linux onlyÁ êË dî - `sm4`*Á ûË ¤ÿ ## `loongarch64`Á ”Ë ü˜N K Linux only (LoongArch64 does not support OS-independent feature detection)Á çË ¤ëâ €Ë d„ - `lam`*Á d‘ - `ual`*Á dž - `fpu`*Á d« - `lsx`*Á l¸
|
|||
|
|
- `lasx`*Á tÆ - `crc32`*Á „Õ
|
|||
|
|
- `complex`*Á |æ - `crypto`*Á dö - `lvz`*Á „ƒ
|
|||
|
|
- `lbt.x86`*Á „”
|
|||
|
|
- `lbt.arm`*Á Œ¥ - `lbt.mips`*Á d· - `ptw`*Á ÄË ¬È ## `x86`/`x86_64`Á ÞË üâ( % OS independent and `no_std`-friendlyÁ ‹Ë ¤�â ¤Ë \¨ - `adx`Á \´ - `aes`Á \À - `avx`Á dÌ - `avx2`Á ŒÙ - `avx512bw`*Á Œë - `avx512cd`*Á Œý - `avx512dq`*Á Œ� - `avx512er`*Á „¡
|
|||
|
|
- `avx512f`*Á œ² - `avx512ifma`*Á ŒÆ - `avx512pf`*Á ŒØ - `avx512vl`*Á dê - `bmi1`Á d÷ - `bmi2`Á d„
|
|||
|
|
- `fma`,Á \‘
|
|||
|
|
- `mmx`Á Œ�
|
|||
|
|
- `pclmulqdq`Á t¯
|
|||
|
|
- `popcnt`Á t¾
|
|||
|
|
- `rdrand`Á tÍ
|
|||
|
|
- `rdseed`Á \Ü
|
|||
|
|
- `sgx`Á \è
|
|||
|
|
- `sha`Á \ô
|
|||
|
|
- `sse`Á d€ - `sse2`Á d� - `sse3`Á tš - `sse4.1`Á t© - `sse4.2`Á l¸
|
|||
|
|
- `ssse3`Á Æ Ë üÊ L I If you would like detection support for a target feature which is not onÁ ü— 0 - this list, please [open a GitHub issue][gh].Á È Ë lÌ
|
|||
|
|
# ExampleÁ <Ú ```Á üâ > ; # #[cfg(any(target_arch = "x86", target_arch = "x86_64"))]Á <¡
|
|||
|
|
# {Á ü©
|
|||
|
|
0 - // This macro creates `cpuid_aes_sha` moduleÁ üÚ
|
|||
|
|
3 0 cpufeatures::new!(cpuid_aes_sha, "aes", "sha");Á ŽË ü’A > // `token` is a Zero Sized Type (ZST) value, which guaranteesÁ üÔ? < // that underlying static storage got properly initialized,Á ü”1 . // which allows to omit initialization branchÁ üÆ@ = let token: cpuid_aes_sha::InitToken = cpuid_aes_sha::init();Á ‡Ë ¤‹ if token.get() {Á ü = : println!("CPU supports both SHA and AES extensions");Á dÞ } else {Á üë= : println!("SHA and AES extensions are not supported");Á ,© }Á ¯Ë ü³@ = // If stored value needed only once you can get stored valueÁ Ìô // omitting the tokenÁ üŽ# let val = cpuid_aes_sha::get();Á ü²! assert_eq!(val, token.get());Á ÔË üØ4 1 // Additionally you can get both token and valueÁ ü�1 . let (token, val) = cpuid_aes_sha::init_get();Á ü¿!Ü <á # }Á <éì ñË üõL I Note that if all tested target features are enabled via compiler optionsÁ üÂK H (e.g. by using `RUSTFLAGS`), the `get` method will always return `true`Á üŽC @ and `init` will not use CPUID instruction. Such behavior allowsÁ üÒ3 0 compiler to completely eliminate fallback code.Á †Ë üŠE B After first call macro caches result and returns it in subsequentÁ üÐ5 2 calls, thus runtime overhead for them is minimal.Á †Ë üŠ; 8 [RFC 2725]: https://github.com/rust-lang/rfcs/pull/2725Á üƆ ƒ [gh]: https://github.com/RustCrypto/utils/issues/new?title=cpufeatures:%20requesting%20support%20for%20CHANGEME%20target%20featureÁ¡ Ü ß › 8¶ lå ó 7 Dhttps://raw.githubusercontent.com/RustCrypto/media/6ee8e381/logo.svgÁ üõF $ » 8µ „Á Ò 7ƒ& üÔF üÙÄ ³ ¿ ³. å= • L |à» ¡ ¤ ® 8Æ ¥ ¨ 8å
|
|||
|
|
$© ŒŸ» ³ ¶ Î 8Ê \· à 7½ LÅ ü± ¡ Ó Ö Ý 8° 4× tÑ ü ( % ARM64 CPU feature detection support.Á ) Ë ü-O L Unfortunately ARM instructions to detect CPU features cannot be called fromÁ ü}M J unprivileged userspace code, so this implementation relies on OS-specificÁ üË APIs for feature detection.Á <è ü„% ¡ ÷ ú � 8° 4û tõ &|å ª ø ° Ë , ± ² ¹ , ³ 8 tfÁ ´ & ¶ 8� · $ º » *½ , À 8 bodyÁ $Á & Å 8ï $Æ *Í Ð õ Ú ï + è é � 8¢ ê í � 8Æ î ñ Ž 8à ò õ � , ö ÷ ‹ 8Î tø † , ‡ 8ö+ ˆ $ Š
|
|||
|
|
Œ , ž 8±, $Ÿ + ± ² Ô 8¢ ³ ¶ Ó 8à · º Ò , » ¼ Ð 8Î t½ Ë , Ì 8ö+ Í $ Ï
|
|||
|
|
Ñ 8 $â % ö ü®
|
|||
|
|
% » ñ ô Œ
|
|||
|
|
8Û lõ ƒ
|
|||
|
|
7÷ <…
|
|||
|
|
üï ¡ ¡
|
|||
|
|
¤
|
|||
|
|
«
|
|||
|
|
8° 4¥
|
|||
|
|
tŸ
|
|||
|
|
&|�
|
|||
|
|
. Ô
|
|||
|
|
ž Ú
|
|||
|
|
æ
|
|||
|
|
, Û
|
|||
|
|
Ü
|
|||
|
|
ã
|
|||
|
|
, Ý
|
|||
|
|
8ö+ Þ
|
|||
|
|
& à
|
|||
|
|
8� á
|
|||
|
|
$ ä
|
|||
|
|
å
|
|||
|
|
*è
|
|||
|
|
ë
|
|||
|
|
› ì
|
|||
|
|
š , ö
|
|||
|
|
÷
|
|||
|
|
Ž , ø
|
|||
|
|
8 ,ù
|
|||
|
|
'þ
|
|||
|
|
8å ,€ … † Š , ‡ 8ö+ ˆ Œ � 8 $‘ % œ ”ê » ° È 8Û l± ¿ 7÷ <Á ü« ¡ Ý à ç 8° 4á tÛ &|Ë = ý �! ƒ ‰ 7Ù ,„ *‹ Ž ¡ 8 $˜ % ¢ ¨ ® 7 ditÁ ,© *° ³ µ 8" 4Õ Ü ¯ , ê 8 ,ë 'ð 8½ <ò 'ù 8ñ dû ‡ ¥ 7 hw.optional.arm.FEAT_DIT\0Á ìˆ % ¶ ¼ à 7‰ 4½ *Å È Û 8 $Ò % Ü â é 7Š 4ã *ë î ç 8" 4ø ÿ á , Ê 8 ,Ë 'Ð 8½ <Ò 'Ù 8ñ dÛ ç ‡ 7 hw.optional.armv8_2_sha512\0Á üè ™ , œ 8 ,� '¢ 8½ <¤ '« 8ñ d ¹ × 7 hw.optional.armv8_2_sha3\0Á ìº % è î ô 7 sm4Á ,ï *ö ù �! 8 ,ƒ! % Ž! üé!/ ü“!5 2 Apple helper function for calling `sysctlbyname`.Á» Ë! Î! æ! 8Û lÏ! Ý! 7÷ <ß! üÉ! d÷!
|
|||
|
|
Š"
|
|||
|
|
ÿ
|
|||
|
|
$„" „ç ü¤ 2 / Create module with CPU feature detection code.Á &|× L ø Ó/ þ ¡ , ÿ 8 mod_nameÁ D€ & ˆ 8Û ,‰ $ Ž , � ‘ ˜ , ’ 8ö+ “ & • 8� – $ ™ š , œ � Ÿ $ ž - *£ ¦ Ð/ 8 ° , ´ 8ç: Dµ ¾ Ê/ G 8# Ì 8³ $Ð 'Ô 8 $Ö 'Ú 8¹ 4Ü 'â ä € 8] Då $ í 8Õ Dï '÷ 8û <ù % � 8 ,� 8 UNINITÁ 4– & œ 8¦ ž ¡ 8¦ £ '¥ 8 max_valueÁ L§ ° ± % ² 8 4À 8 STORAGEÁ <Ç & Î 8] DÐ Ù 8] DÛ 'ã 8• å è ï 8Ä= 4é % ð < Initialization tokenÁÄÿ + ¤! ¥! À! 8‰ 4¦! ¬! ¿! 8 $! $ ±! 8u ,³! $ ¸! 8� ,º! 8 Î! 8 4Ò! 8 InitTokenÁ LÙ! â! å! ã! ä! % æ! 8 $õ! 8¥@ Lú! „" á$
|
|||
|
|
< Get initialized valueÁÌ–" + À" Á" Ð" 8þ 4Â" È" Ï" 8î 4É" 8 â" 8 æ" 8 getÁ é" ì" ò" í" 8 $î" (ô" 8õ $÷" ü" Ó$ , ’# 8 ,“# '˜# 8¿ Äš# ²# ´# Á$ , Î# Ï# Ó# , Ð# 8ö+ Ñ# $ Ô# Õ# *×# Ú# «$ 8²> <ø# ÿ# 8Ù $€$ „$ Œ$ 8û <…$ Ž$ 7í ‘$ < + Get stored value and initialization token,Áüð$. < + initializing underlying storage if needed.Áü«%. + æ% ç% î% 8þ 4è% 8 ü% 8 €& 8 init_getÁ Dƒ& ‹& Œ& (Ž& ‘& ¡& 8¥@ L’& $ ›& 8õ $�& £& Ì, 8 µ& 8 resÁ ¹& ½& , ¿& 8 ,À& 'Å& 8¿ ÄÇ& ß& á& —, , ÷& ø& ü& , ù& 8ö+ ú& $ ý& þ& *€' ƒ' …, + �' ž' £' 8á $Ÿ' 8 ½' 8
|
|||
|
|
init_innerÁ TÀ' Ê' Ë' (Í' 8õ $Ð' Õ' ¡) 8 ó' 8†F ÷' û' , ý' 8 ,þ' 'ƒ( 8³ Ä…( �( ž( §( , Ÿ( ( ¤( , ¡( 8ö+ ¢( $ ¥( ¦( % ¨( 8²> <Æ( Í( 8› ,Î( Ó( æ( 8†F Ô( 8 Ø( 8¦ Û( $ Ý( 8û <ß( % ç( 8†F …) 8 ›* 8– Ÿ* £* 8²> <¥* ¬* 8Ù $* ±* ¹* 8û <²* % º* 8 Õ* 8– Ø* Ü* 8Ä= 4ß* æ* ©+ 8ÃG T„+ Ž+ �+ 8 $«+ °+ ï+ 8– Î+ Ò+ 7í Õ+ % ˜, «, ¾, 8¥@ L¬, µ, ¸, ¶, ·, $ ¹, 8†F », < F Initialize underlying storage if needed and get initialization token.ÁüÛ,I + ±- ²- ¹- 8þ 4³- 8 Ç- 8 Ë- 8 initÁ $Î- Ò- Ó- (Õ- 8¥@ LØ- â- �. 8žE Dô- ü- ý- þ- 7ì ÿ- < > Initialize underlying storage if needed and get stored value.Áüœ.A + ê. ë. ò. 8þ 4ì. 8 €/ 8 „/ 8éA ‡/ Š/ ‹/ (�/ 8õ $�/ •/ À/ 8žE D§/ ¯/ °/ ±/ 7í ²/ % Ñ/
|
|||
|
|
|https://github.com/RustCrypto/utils/issues/new?title=cpufeatures:%20requesting%20support%20for%20CHANGEME%20target%20featureÁ +https://github.com/rust-lang/rfcs/pull/2725Á open a GitHub issueÁ úO RFC 2725Á ûP «Q ÈQ ûP úO ÈQ «Q ÒkúéÌõ”·ü"§fóm¶�õ(]1=› ÷u‰sÅ&ŠáÏ~…ߟZzõ>kL¾°M1iëéîëkªT‰± w�LàKØÍP¾Zo¾w~ f–¼� ]z ×�Ä-? € Š))) ) ‰À.—Í E XÊÐÓ‹¿): ü ô' Í …½+”· B ÷' î ä ð Î Î » ô } ƒ¦©°´»Úáí Á/˜ F ø' £½ ø°ú°û°Ð ü° ý°�þ°ì H�ˈXêE>Ý: £½ Ý: £½ £½ Ü: ïaÝ: ç_ ïV é_ Ü: Ë^ Ý: ÙiÙi IterÁ Üi÷ ®i Ýi
|
|||
|
|
end_or_lenÁ®i Þi _markerÁ®i t¸%ýN( Ý: Ì` % ªX Ì` ªX ªX åpÝ: ×R Ý: ÅU�V�V ÅUïVïV ¶J¿W ó°Ý: �SÝ: ¹Á Ý: k o � ”ã ÒkúéÌõ”·šøZÃ`*” ª,[,_,ƒ,s,š,€ODHT
|
|||
|
|
·Þ o¾w~ f–¼ ªT‰± w� ü"§fóm¶� ŠáÏ~…ߟZ ÷u‰sÅ& M1iëéîëk ÒkúéÌõ”· õ(]1=› zõ>kL¾° LàKØÍP¾Z ^@ÿNÿ-ÿÿÿ5ÿ[X-^@ÿNÿ-ÿÿÿ5ÿ[X- d/Users/dorian/.cargo/registry/src/index.crates.io-1949cf8c6b5b557f/cpufeatures-0.2.17/src/aarch64.rsÁ ¥þ©¿·½î ´ºBZ¦ Ë(Ë(§)PN M,(&
|
|||
|
|
61
|