mirror of
https://github.com/bytecodealliance/wasm-micro-runtime.git
synced 2025-02-11 17:35:13 +00:00
8d88471c46
LLVM PGO (Profile-Guided Optimization) allows the compiler to better optimize code
for how it actually runs. This PR implements the AOT static PGO, and is tested on
Linux x86-64 and x86-32. The basic steps are:
1. Use `wamrc --enable-llvm-pgo -o <aot_file_of_pgo> <wasm_file>`
to generate an instrumented aot file.
2. Compile iwasm with `cmake -DWAMR_BUILD_STATIC_PGO=1` and run
`iwasm --gen-prof-file=<raw_profile_file> <aot_file_of_pgo>`
to generate the raw profile file.
3. Run `llvm-profdata merge -output=<profile_file> <raw_profile_file>`
to merge the raw profile file into the profile file.
4. Run `wamrc --use-prof-file=<profile_file> -o <aot_file> <wasm_file>`
to generate the optimized aot file.
5. Run the optimized aot_file: `iwasm <aot_file>`.
The test scripts are also added for each benchmark, run `test_pgo.sh` under
each benchmark's folder to test the AOT static pgo.
63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
# WAMR test benchmarks
|
|
|
|
This folder contains test benchmarks for wamr.
|
|
|
|
## Build and Run
|
|
|
|
Refer to the `README.md` under each folder for how to build and run the benchmark.
|
|
|
|
## Install `llvm-profdata`
|
|
|
|
The tool `llvm-profdata` is used when running the `test_pgo.sh` script under the benchmark folder. There are two ways to install it:
|
|
|
|
1. Refer to https://apt.llvm.org/, e.g. in Ubuntu 20.04, add lines below to /etc/apt/source.list
|
|
|
|
```bash
|
|
deb http://apt.llvm.org/focal/ llvm-toolchain-focal main
|
|
deb-src http://apt.llvm.org/focal/ llvm-toolchain-focal main
|
|
# 15
|
|
deb http://apt.llvm.org/focal/ llvm-toolchain-focal-15 main
|
|
deb-src http://apt.llvm.org/focal/ llvm-toolchain-focal-15 main
|
|
```
|
|
|
|
Then run `sudo apt update`, `sudo apt install llvm`. And after installing:
|
|
|
|
```bash
|
|
cd /usr/bin
|
|
sudo ln -s llvm-profdata-15 llvm-profdata
|
|
```
|
|
|
|
2. Build manually
|
|
|
|
```bash
|
|
git clone --depth 1 --branch release/15.x https://github.com/llvm/llvm-project.git
|
|
cd llvm-project
|
|
mkdir build && cd build
|
|
cmake ../llvm \
|
|
-DCMAKE_BUILD_TYPE:STRING="Release" \
|
|
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
|
|
-DLLVM_APPEND_VC_REV:BOOL=ON \
|
|
-DLLVM_BUILD_EXAMPLES:BOOL=OFF \
|
|
-DLLVM_BUILD_LLVM_DYLIB:BOOL=OFF \
|
|
-DLLVM_BUILD_TESTS:BOOL=OFF \
|
|
-DLLVM_CCACHE_BUILD:BOOL=ON \
|
|
-DLLVM_ENABLE_BINDINGS:BOOL=OFF \
|
|
-DLLVM_ENABLE_IDE:BOOL=OFF \
|
|
-DLLVM_ENABLE_LIBEDIT=OFF \
|
|
-DLLVM_ENABLE_TERMINFO:BOOL=OFF \
|
|
-DLLVM_ENABLE_ZLIB:BOOL=ON \
|
|
-DLLVM_INCLUDE_BENCHMARKS:BOOL=OFF \
|
|
-DLLVM_INCLUDE_DOCS:BOOL=OFF \
|
|
-DLLVM_INCLUDE_EXAMPLES:BOOL=OFF \
|
|
-DLLVM_INCLUDE_UTILS:BOOL=OFF \
|
|
-DLLVM_INCLUDE_TESTS:BOOL=OFF \
|
|
-DLLVM_BUILD_TESTS:BOOL=OFF \
|
|
-DLLVM_OPTIMIZED_TABLEGEN:BOOL=ON \
|
|
-DLLVM_ENABLE_LIBXML2:BOOL=OFF \
|
|
-DLLVM_TARGETS_TO_BUILD:STRING="X86" \
|
|
-DLLVM_INCLUDE_TOOLS:BOOL=ON \
|
|
-G'Ninja'
|
|
ninja -j 8
|
|
# tool `llvm-profdata` is generated under this folder.
|
|
```
|