Skip to content

Pthreads with WebAssembly

Derek Schuff edited this page Mar 28, 2018 · 18 revisions

Emscripten has support for compiling with pthreads, using asm.js, Web Workers, and SharedArrayBuffer. That support is documented here with information about porting and differences from other pthread-supporting platforms. WebAssembly has a proposed spec for threads (or more properly, for a shared linear memory and atomic memory instructions), with an overview here and spec here. This spec has experimental implementations in Firefox Nightly and Chrome Canary.

Emscripten now also has experimental support for the wasm threading spec. Currently you need to use the head of the incoming branch of emscripten. To build a simple threaded program: emcc program.c -s USE_PTHREADS=1 -s WASM=1 -o program.html (it may also be desirable to use -s PTHREAD_POOL_SIZE as documented in the emscripten threading doc).

To test with Chrome Canary, use the following flags: --js-flags=--experimental-wasm-threads --enable-features=WebAssembly,SharedArrayBuffer --disable-features=WebAssemblyTrapHandler. (These can alternatively be enabled/disabled in chrome://flags as "WebAssembly structured cloning support" and "Experimental enabled SharedArrayBuffer support in JavaScript"). In Firefox nightly, SharedArrayBuffer can be enabled in about:config by setting the javascript.options.shared_memory preference to true.

Using pthreads also requires use of a memory initializer file (e.g. as if you had specified --mem-init-file 1 instead of using the data section of the wasm file.