wasm-micro-runtime/samples/wasi-threads/README.md

# "WASI threads" sample introduction

To run the sample, `wasi-sdk` >= 20 is required.

## Build and run the samples

```shell
$ mkdir build
$ cd build
$ cmake ..
$ make
...
$ ./iwasm wasm-apps/no_pthread.wasm
```

## Run samples in AOT mode
```shell
$ ../../../wamr-compiler/build/wamrc \
    --enable-multi-thread \
    -o wasm-apps/no_pthread.aot wasm-apps/no_pthread.wasm
$ ./iwasm wasm-apps/no_pthread.aot
```
feat(wasi-threads): Add example of exception propagation (#1812) 2022-12-16 06:22:53 +00:00			`# "WASI threads" sample introduction`

Use wasi-sdk 20 pre-release for tests with threads (#2021) `wasi-sdk-20` pre-release can be used to avoid building `wasi-libc` to enable threads. It's not possible to use `wasi-sdk-20` pre-release on Ubuntu 20.04 because of incompatibility with the glibc version: ```bash /opt/wasi-sdk/bin/clang: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found (required by /opt/wasi-sdk/bin/clang) ``` 2023-03-17 12:02:03 +00:00			To run the sample, `wasi-sdk` >= 20 is required.
feat(wasi-threads): Add example of exception propagation (#1812) 2022-12-16 06:22:53 +00:00
Document how to use WASI threads in AOT mode (#1905) Describe how to use WASI threads in AOT mode, following the discussion below: https://github.com/bytecodealliance/wasm-micro-runtime/pull/1867#discussion_r1070268062 Make aux stack boundary checks of wasi-threads always successful by setting `exec_env->aux_stack_bottom` to UINT32_MAX and `exec_env->aux_stack_boundary` to 0 2023-01-27 10:32:33 +00:00			`## Build and run the samples`
feat(wasi-threads): Add example of exception propagation (#1812) 2022-12-16 06:22:53 +00:00
			```shell
			`$ mkdir build`
			`$ cd build`
Use wasi-sdk 20 pre-release for tests with threads (#2021) `wasi-sdk-20` pre-release can be used to avoid building `wasi-libc` to enable threads. It's not possible to use `wasi-sdk-20` pre-release on Ubuntu 20.04 because of incompatibility with the glibc version: ```bash /opt/wasi-sdk/bin/clang: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found (required by /opt/wasi-sdk/bin/clang) ``` 2023-03-17 12:02:03 +00:00			`$ cmake ..`
feat(wasi-threads): Add example of exception propagation (#1812) 2022-12-16 06:22:53 +00:00			`$ make`
			`...`
			`$ ./iwasm wasm-apps/no_pthread.wasm`
			```
Document how to use WASI threads in AOT mode (#1905) Describe how to use WASI threads in AOT mode, following the discussion below: https://github.com/bytecodealliance/wasm-micro-runtime/pull/1867#discussion_r1070268062 Make aux stack boundary checks of wasi-threads always successful by setting `exec_env->aux_stack_bottom` to UINT32_MAX and `exec_env->aux_stack_boundary` to 0 2023-01-27 10:32:33 +00:00
			`## Run samples in AOT mode`
			```shell
			`$ ../../../wamr-compiler/build/wamrc \`
thread-mgr: Fix spread "wasi proc exit" exception and atomic.wait issues (#1988) Raising "wasi proc exit" exception, spreading it to other threads and then clearing it in all threads may result in unexpected behavior: the sub thread may end first, handle the "wasi proc exit" exception and clear exceptions of other threads, including the main thread. And when main thread's exception is cleared, it may continue to run and throw "unreachable" exception. This also leads to some assertion failed. Ignore exception spreading for "wasi proc exit" and don't clear exception of other threads to resolve the issue. And add suspend flag check after atomic wait since the atomic wait may be notified by other thread when exception occurs. 2023-02-24 12:05:39 +00:00			`--enable-multi-thread \`
Document how to use WASI threads in AOT mode (#1905) Describe how to use WASI threads in AOT mode, following the discussion below: https://github.com/bytecodealliance/wasm-micro-runtime/pull/1867#discussion_r1070268062 Make aux stack boundary checks of wasi-threads always successful by setting `exec_env->aux_stack_bottom` to UINT32_MAX and `exec_env->aux_stack_boundary` to 0 2023-01-27 10:32:33 +00:00			`-o wasm-apps/no_pthread.aot wasm-apps/no_pthread.wasm`
			`$ ./iwasm wasm-apps/no_pthread.aot`
			```