mirror of
https://github.com/bytecodealliance/wasm-micro-runtime.git
synced 2025-06-18 02:59:21 +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.
32 lines
1.5 KiB
Markdown
32 lines
1.5 KiB
Markdown
# Introduction
|
|
|
|
[JetStream 2](https://browserbench.org/JetStream) is a JavaScript and WebAssembly benchmark suite focused on the most advanced web applications. It rewards browsers that start up quickly, execute code quickly, and run smoothly.
|
|
|
|
**Source**: https://browserbench.org/JetStream/in-depth.html
|
|
|
|
# Building
|
|
|
|
Please build iwasm and wamrc, refer to:
|
|
- [Build iwasm on Linux](../../../doc/build_wamr.md#linux), or [Build iwasm on MacOS](../../../doc/build_wamr.md#macos)
|
|
- [Build wamrc AOT compiler](../../../README.md#build-wamrc-aot-compiler)
|
|
|
|
And install emsdk, refer to [the guide](https://emscripten.org/docs/getting_started/downloads.html). Don't forget to activate
|
|
emsdk and set up environment variables. For example, use instructions below to install it under /opt and activate it:
|
|
``` bash
|
|
$ cd /opt
|
|
$ git clone https://github.com/emscripten-core/emsdk.git
|
|
$ cd emsdk
|
|
$ git pull
|
|
$ ./emsdk install latest
|
|
$ ./emsdk activate latest
|
|
$ echo "source /opt/emsdk/emsdk_env.sh" >> "${HOME}"/.bashrc
|
|
```
|
|
|
|
And then run `./build.sh` to build the source code, the folder `out` will be created and files will be generated under it.
|
|
|
|
# Running
|
|
|
|
Run `./run_aot.sh` to test the benchmark, the native mode and iwasm aot mode will be tested for each workload, and the file `report.txt` will be generated.
|
|
|
|
Run `./test_pgo.sh` to test the benchmark with AOT static PGO (Profile-Guided Optimization) enabled, please refer [here](../README.md#install-llvm-profdata) to install tool `llvm-profdata` and build `iwasm` with `cmake -DWAMR_BUILD_STATIC_PGO=1`.
|