3a6cdeda89
fiber machine stack is placed outside of C stack allocated by wasm-ld,
so highest stack address recorded by `rb_wasm_record_stack_base` is
invalid when running on non-main fiber.
Therefore, we should scan `stack_{start,end}` which always point a valid
stack range in any context.
|
||
|---|---|---|
| .. | ||
| tests | ||
| GNUmakefile.in | ||
| README.md | ||
| asyncify.h | ||
| fiber.c | ||
| fiber.h | ||
| machine.c | ||
| machine.h | ||
| machine_core.S | ||
| missing.c | ||
| runtime.c | ||
| setjmp.c | ||
| setjmp.h | ||
| setjmp_core.S | ||
| wasm-opt | ||
README.md
WebAssembly / WASI port of Ruby
How to cross-build
Requirement
- Ruby (the same version as the building target version) (baseruby)
- GNU make
- WASI SDK 14.0 or later
- Binaryen version 106 or later
- Linux or macOS build machine
Steps
- Download a prebuilt WASI SDK package from WASI SDK release page.
- Set
WASI_SDK_PATHenvironment variable to the root directory of the WASI SDK package.
$ export WASI_SDK_PATH=/path/to/wasi-sdk-X.Y
- Download a prebuilt binaryen from Binaryen release page
- Set PATH environment variable to lookup binaryen tools
$ export PATH=path/to/binaryen:$PATH
- Download the latest
config.guesswith WASI support, and run./autogen.shto generate configure when you are building from the source checked out from Git repository
$ ruby tool/downloader.rb -d tool -e gnu config.guess config.sub
$ ./autogen.sh
- Configure
- You can select which extensions you want to build.
- If you got
Out of bounds memory accesswhile running the produced ruby, you may need to increase the maximum size of stack.
$ ./configure LDFLAGS="-Xlinker -zstack-size=16777216" \
--host wasm32-unknown-wasi \
--with-destdir=./ruby-wasm32-wasi \
--with-static-linked-ext \
--with-ext=ripper,monitor
- Make
$ make install
Now you have a WASI compatible ruby binary. You can run it by any WebAssembly runtime like wasmtime, wasmer, Node.js, or browser with WASI polyfill.
Note: it may take a long time (~20 sec) for the first time for JIT compilation
$ wasmtime ruby-wasm32-wasi/usr/local/bin/ruby --mapdir /::./ruby-wasm32-wasi/ -- -e 'puts RUBY_PLATFORM'
wasm32-wasi
Current Limitation
- No
Threadsupport for now. - Spawning a new process is not supported. e.g.
Kernel.spawnandKernel.system