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

# "WASI threads" sample introduction

Currently, since the `wasi-sdk` does not have thread support in the latest release, make sure to have [wasi-libc](https://github.com/WebAssembly/wasi-libc) installed. Build it with threads enabled, e.g.

```shell
make \
    AR=/opt/wasi-sdk/bin/llvm-ar \
    NM=/opt/wasi-sdk/bin/llvm-nm \
    CC=/opt/wasi-sdk/bin/clang \
    THREAD_MODEL=posix
```

## Build and run the samples

```shell
$ mkdir build
$ cd build
$ cmake -DWASI_SYSROOT=/path/to/wasi-libc/sysroot ..
$ make
...
$ ./iwasm wasm-apps/no_pthread.wasm
...
$ ./iwasm wasm-apps/exception_propagation.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`

			Currently, since the `wasi-sdk` does not have thread support in the latest release, make sure to have [wasi-libc](https://github.com/WebAssembly/wasi-libc) installed. Build it with threads enabled, e.g.

			```shell
			`make \`
			`AR=/opt/wasi-sdk/bin/llvm-ar \`
			`NM=/opt/wasi-sdk/bin/llvm-nm \`
			`CC=/opt/wasi-sdk/bin/clang \`
			`THREAD_MODEL=posix`
			```

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`
			`$ cmake -DWASI_SYSROOT=/path/to/wasi-libc/sysroot ..`
			`$ make`
			`...`
			`$ ./iwasm wasm-apps/no_pthread.wasm`
			`...`
			`$ ./iwasm wasm-apps/exception_propagation.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`
			```