107 lines
2.7 KiB
Markdown
107 lines
2.7 KiB
Markdown
# ruapu
|
|
|
|
|
|
|
|
Detect cpu ISA features with single-file
|
|
|
|
<table>
|
|
<tr><td>CPU</td><td>✅ x86, x86-64<br/>✅ arm, aarch64</td><td rowspan=3>
|
|
|
|
```c
|
|
#define RUAPU_IMPLEMENTATION
|
|
#include "ruapu.h"
|
|
|
|
int main()
|
|
{
|
|
// initialize ruapu once
|
|
ruapu_init();
|
|
|
|
// now, tell me if this cpu has avx2
|
|
int has_avx2 = ruapu_supports("avx2");
|
|
|
|
return 0;
|
|
}
|
|
```
|
|
|
|
</td></tr>
|
|
<tr><td>OS</td><td>✅ Windows<br/>✅ Linux<br/>✅ macOS<br/>✅ Android<br/>✅ iOS</td></tr>
|
|
<tr><td>Compiler</td><td>✅ GCC<br/>✅ Clang<br/>✅ MSVC<br/>✅ MinGW</td></tr>
|
|
</table>
|
|
|
|
## Let's ruapu
|
|
|
|
<table>
|
|
|
|
<tr><td>
|
|
|
|
Compile ruapu test program
|
|
|
|
```shell
|
|
# GCC / MinGW
|
|
gcc main.c -o ruapu
|
|
```
|
|
```shell
|
|
# Clang
|
|
clang main.c -o ruapu
|
|
```
|
|
```shell
|
|
# MSVC
|
|
cl.exe /Fe: ruapu.exe main.c
|
|
```
|
|
</td>
|
|
<td>
|
|
|
|
Run ruapu in command line
|
|
|
|
```shell
|
|
./ruapu
|
|
mmx = 1
|
|
sse = 1
|
|
sse2 = 1
|
|
sse3 = 1
|
|
ssse3 = 1
|
|
sse41 = 1
|
|
sse42 = 1
|
|
sse4a = 1
|
|
xop = 0
|
|
... more lines omitted ...
|
|
```
|
|
|
|
</td></tr>
|
|
</table>
|
|
|
|
## Features
|
|
|
|
* Detect **CPU ISA with single-file**   
|
|
_`sse2`, `avx`, `avx512f`, `neon`, etc._
|
|
* Detect **vendor extended ISA**    
|
|
_apple `amx`, risc-v vendor ISA, etc._
|
|
* Detect **richer ISA on Windows ARM**  
|
|
_`IsProcessorFeaturePresent()` returns little ISA information_
|
|
* Detect **`x86-avx512` on macOS correctly** 
|
|
_macOS hides it in `cpuid`_
|
|
* Detect **new CPU's ISA on old systems** 
|
|
_they are usually not exposed in `auxv` or `MISA`_
|
|
* Detect **CPU hidden ISA**       
|
|
_`fma4` on zen1, ISA in hypervisor, etc._
|
|
|
|
## Supported ISA _ (more is comming ... :)_
|
|
|
|
|CPU|ISA|
|
|
|:---:|---|
|
|
|x86|`mmx` `sse` `sse2` `sse3` `ssse3` `sse41` `sse42` `sse4a` `xop` `avx` `f16c` `fma` `avx2` `avx512f` `avx512bw` `avx512cd` `avx512dq` `avx512vl` `avx512vnni` `avx512bf16` `avx512ifma` `avx512vbmi` `avx512vbmi2` `avx512fp16` `avxvnni` `avxvnniint8` `avxifma`|
|
|
|arm|`edsp` `neon` `vfpv4`|
|
|
|aarch64|`neon` `vfpv4` `cpuid` `asimdhp` `asimddp` `asimdfhm` `bf16` `i8mm` `sve` `sve2` `svebf16` `svei8mm` `svef32mm`|
|
|
|mips||
|
|
|powerpc||
|
|
|loongarch||
|
|
|risc-v||
|
|
|
|
## Techniques inside ruapu
|
|
ruapu is implemented in C language to ensure the widest possible portability.
|
|
|
|
ruapu determines whether the CPU supports certain instruction sets by trying to execute instructions and detecting whether an `Illegal Instruction` exception occurs. ruapu does not rely on the cpuid instructions and registers related to the CPU architecture, nor does it rely on the `MISA` information and system calls of the operating system. This can help us get more detailed CPU ISA information.
|
|
|
|
## License
|
|
MIT License
|