Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

misc doc improvements #37

Merged
merged 4 commits into from
May 30, 2023
Merged

misc doc improvements #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
fb211ac
benchmark: mention hardware i used
yamt May 30, 2023
1fe11ff
mention portability principles
yamt May 30, 2023
3f5d32a
a comment
yamt May 30, 2023
3917172
use a table for test matrix
yamt May 30, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 18 additions & 36 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,11 @@ is built with an ancient wasi-sdk to workaround
* Correctness
* Clean code
* Small footprint
* Portability
* Core wasm: C11
* WASI: POSIX-like
* Clang/LLVM extentions are ok where an alternative implmentation
in pure C is reasonably easy.

## Non-goals

Expand Down Expand Up @@ -72,42 +77,19 @@ It includes

## Where can this run?

### The most tested

* macOS/amd64
* wasm32-wasi (on toywasm itself)

### Tested on CI

#### Natively

* macOS/amd64
* Ubuntu/amd64

#### With qemu

* Ubuntu/arm64
* Ubuntu/armhf (Note: 32-bit)

#### With qemu (less coverage because of slowness)

* Ubuntu/s390x (Note: big endian)
* Ubuntu/risc-v

(I haven't investigated why they are slower than others.
It might be related to the fact that our build disables LTO
for them for toolchain issues.)

#### With toywasm (less coverage because of slowness)

* wasm32-wasi

### Occasionally tested manually

* wasm32-wasi-threads
* NuttX/xtensa
* NuttX/sim on macOS/amd64
* NetBSD/amd64
|Platform |Tested on CI |Notes |
| ---------------------- | --------------- | --------------------------- |
|macOS/amd64 |Yes | |
|wasm32-wasi |Yes (on toywasm) | |
|Ubuntu/amd64 |Yes | |
|Ubuntu/arm64 |Yes (on qemu) | |
|Ubuntu/armhf |Yes (on qemu) |32-bit |
|Ubuntu/s390x |Yes (on qemu) |Big endian |
|Ubuntu/riscv64 |Yes (on qemu) | |
|wasm32-wasi-threads |No |Occasionally tested manually |
|NuttX/esp32 |No |Occasionally tested manually |
|NuttX/sim on macOS/amd64|No |Occasionally tested manually |
|NetBSD/amd64 |No |Occasionally tested manually |

## How slow/fast is this?

Expand Down
7 changes: 7 additions & 0 deletions benchmark/ffmpeg.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,13 @@ measure the time taken.
1637302272 peak memory footprint
```

* Run on a macOS/amd64 laptop:

```
MacBook Pro (15-inch, 2018)
2.2 GHz 6-Core Intel Core i7
```

## Observations

* toywasm performs reasonably well for an interpreter.
Expand Down
7 changes: 6 additions & 1 deletion benchmark/startup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,12 @@ print the `-version` message)

![Result](./startup.png)

* Run on a macOS/amd64 laptop.
* Run on a macOS/amd64 laptop:

```
MacBook Pro (15-inch, 2018)
2.2 GHz 6-Core Intel Core i7
```

* [Raw values](./startup.txt)

Expand Down
4 changes: 4 additions & 0 deletions test/run-spidermonkey.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
#! /bin/sh

# Note: spidermonkey uses nan-boxing, which is one of motivations of
# nan-canonicalization in wasm.
# cf. https://github.com/WebAssembly/design/issues/1463

set -e
BIN=.spidermonkey/spidermonkey.wasm
if [ ! -f ${BIN} ]; then
Expand Down