From de5f8ad7d29d8d3fdf871c747557da0be660d6a5 Mon Sep 17 00:00:00 2001 From: nihui Date: Sun, 25 Feb 2024 17:21:10 +0800 Subject: [PATCH] add faq section (#42) --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/README.md b/README.md index aee2b20..23ed65d 100644 --- a/README.md +++ b/README.md @@ -267,6 +267,30 @@ 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. +## FAQ +#### Why is the project named ruapu + + ruapu is the abbreviation of rua-cpu, which means using various extended instructions to harass and amuse the CPU (rua!). Based on whether the CPU reacts violently (throws an illegal instruction exception), it is inferred whether the CPU supports a certain extended instruction set. + +#### Why is ruapu API designed like this + + We consider gcc builtin functions to be good practice, saying `__builtin_cpu_init()` and `__builtin_cpu_supports()`. ruapu refers to this design, which can be a 1:1 replacement for gcc functions, and supports more operating systems and compilers, giving it better portability. + +#### Why does SIGILL occur when executing in debugger or simulator, such as `gdb`, `lldb`, `qemu-user`, `sde` etc. + + Because debuggers and simulators capture the signal and stop the ruapu signal handler function by default, we can continue execution at this time, or configure it specifically, such as `handle SIGILL nostop` in gdb. ruapu technically cannot prevent programs from stopping in debuggers and emulators + +#### How to add detection capabilities for new instructions to ruapu + + _Assume that the new extended instruction set is named `rua`_ + +1. Add `RUAPU_INSTCODE(rua, rua-inst-hex) // rua r0,r0` and `RUAPU_ISAENTRY(rua)` in `ruapu.h` +2. Add `PRINT_ISA_SUPPORT(rua)` in `main.c` to print the detection result +3. Add entries about `rua` in README.md +4. Create a pull request! + + _https://godbolt.org/ is a good helper to view the compiled binary code of instructions._ + ## Repos that use ruapu * [ncnn](https://github.com/Tencent/ncnn)  _High-performance neural network inference framework_ * [libllm](https://github.com/ling0322/libllm)  _Efficient inference of large language models_