SetjmpLongjmp.md: update for LLVM 20

pull/523/head
YAMAMOTO Takashi 5 months ago
parent 53551e5943
commit 91ebb23ef9

@ -11,13 +11,13 @@ To build an application using setjmp/longjmp, you need two things:
### Example without LTO
```shell
clang -Os -mllvm -wasm-enable-sjlj -o your_app.wasm your_app.c -lsetjmp
clang -Os -mllvm -wasm-enable-sjlj -o your_app.phase3.wasm your_app.c -lsetjmp
```
### Example with LTO
```shell
clang -Os -flto=full -mllvm -wasm-enable-sjlj -Wl,-mllvm,-wasm-enable-sjlj -o your_app.wasm your_app.c -lsetjmp
clang -Os -flto=full -mllvm -wasm-enable-sjlj -Wl,-mllvm,-wasm-enable-sjlj -o your_app.phase3.wasm your_app.c -lsetjmp
```
## Run an application
@ -34,24 +34,26 @@ Unfortunately, there are two incompatible versions of
### Example with the latest exception handling proposal
Because the current version of WASI-SDK produces an old version
of [exception handling proposal] instructions, if your runtime
implements the latest version of the proposal, you need to convert
your module to the latest version.
By default, the current version of WASI-SDK produces the
"phase3" version of [exception handling proposal] instructions.
[toywasm] is an example of such runtimes.
You can tell the llvm to produce the latest version of proposal by
specifying `-mllvm -wasm-use-legacy-eh=false`. This is expected
to be the default in a future version.
You can use binaryen `wasm-opt` command for the conversion.
Alternatively, you can use binaryen `wasm-opt` command to convert
existing modules from the "phase3" version to the "exnref" version.
```shell
wasm-opt --translate-to-exnref -all -o your_app.exnref.wasm your_app.wasm
wasm-opt --translate-to-exnref -all -o your_app.wasm your_app.phase3.wasm
```
Then you can run it with a runtime supporting the latest version of
[exception handling proposal].
Then you can run it with a runtime supporting the "exnref" version of
the proposal.
[toywasm] is an example of such runtimes.
```shell
toywasm --wasi your_app.exnref.wasm
toywasm --wasi your_app.wasm
```
(You may need to enable the support with `-D TOYWASM_ENABLE_WASM_EXCEPTION_HANDLING=ON`.)
@ -59,13 +61,13 @@ toywasm --wasi your_app.exnref.wasm
If your runtime supports the [phase3] version of
[exception handling proposal], which is the same version as what WASI-SDK
currently produces, you can run the produced module as it is.
currently produces by default, you can run the produced module as it is.
For example, the classic interpreter of [wasm-micro-runtime] is
one of such runtimes.
```shell
iwasm your_app.wasm
iwasm your_app.phase3.wasm
```
(You may need to enable the support with `-D WAMR_BUILD_EXCE_HANDLING=1 -D WAMR_BUILD_FAST_INTERP=0`.)

Loading…
Cancel
Save