ern0 / howto-wasm-minimal

How to create minimal wasm module with plain C/C++

howto-wasm-minimal

How to create minimal wasm module - PoC

Goals

• use no Emscripten or any libs
• simple toolchain, compile to wasm in a single step
• wasm may use memory prepared by JavaScript
• do something relative compute-intensive
• do something visible

Mystic issue

Symptom: on some systems, the linker may hang, or produce output file with correct size but full of zeros (that's why build script contains a hexdump as last step).

Solution: update your linker.

More info: https://stackoverflow.com/questions/71573019/cant-compile-to-wasm-on-linux

Install

You need CLANG and CLANG's linker (LLD). Tested on versions 13 and 14.

Debian nightly pacakges: https://apt.llvm.org/

On MacOS, you should install CLANG from homebrew. More info on Mac troubleshooting: https://til.simonwillison.net/webassembly/compile-to-wasm-llvm-macos

On Windows, you may use Chocolatey package manager to install CLANG: https://chocolatey.org/

Summary

Why WASM?

Writing web app in any language which is not JavaScript is just pure joy.

Try it

The color change and the blur effect is a WASM module, written in C:

http://linkbroker.hu/stuff/howto-wasm-minimal/

howto-wasm-minimal's Issues

All occurrences of "bytebeat" should be replaced with "inc" or vice-versa

Is -nostdlib required?

Hello, when compiling this project I noticed that there is no difference in the size of the generated .wasm file even if the -nostdlib flag is removed from build.sh. inc.wasm is 2894 bytes on my machine regardless.
Could I get clarification on why it is included in the build script?