wasmer/lib
bors[bot] 19dfdec236
Merge #1004
1004: Adapt backend usage depending on wasm file executed r=MarkMcCaskey a=d0iasm

Adapt backend usage depending on wasm file executed in issue #998.
Close #998 

# Description
Add `auto` backend into a runtime-core and use it as a default backend.
The `auto` backend is equivalent to: 
* singlepass if singlepass is enabled and the wasm file size is larger than 10MiB, or singlepass is enable and the target architecture is aarch64.
* cranelift otherwise.


Co-authored-by: Asami Doi <doiasami1219@gmail.com>
2019-11-27 19:37:04 +00:00
..
clif-backend Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
dev-utils Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
emscripten Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
emscripten-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
kernel-loader Improved docs with custom logo and favicon 2019-09-03 17:06:31 -07:00
kernel-net Improved docs with custom logo and favicon 2019-09-03 17:06:31 -07:00
llvm-backend Fix llvm backend to work with latest inkwell. 2019-11-26 19:59:03 -08:00
llvm-backend-tests Add new llvm-backend-test crate. 2019-11-22 17:03:23 -08:00
middleware-common Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
middleware-common-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
runtime Add "auto" backend to change the backend depending on the wasm file size 2019-11-27 20:04:35 +09:00
runtime-c-api Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
runtime-core Add "auto" backend to change the backend depending on the wasm file size 2019-11-27 20:04:35 +09:00
runtime-core-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
singlepass-backend Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
spectests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
wasi Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
wasi-tests Add new test feature, enabled in test crates. 2019-11-22 16:51:44 -08:00
win-exception-handler Prepare for 0.11.0 release 2019-11-22 11:18:06 -08:00
.gitignore Remove generated spectest codes from repo. 2019-01-12 23:48:21 -05:00
README.md Renamed dynasm backend to singlepass 2019-04-11 12:44:03 -07:00

Wasmer Libraries

Wasmer is modularized into different libraries, separated into three main sections:

Runtime

The core of Wasmer is the runtime, which provides the necessary abstractions to create a good user experience when embedding.

The runtime is divided into two main libraries:

  • runtime-core: The main implementation of the runtime.
  • runtime: Easy-to-use API on top of runtime-core.

Integrations

The integration builds on the Wasmer runtime and allow us to run WebAssembly files compiled for different environments.

Wasmer intends to support different integrations:

  • WASI: run WebAssembly files with the WASI ABI.
  • Emscripten: run Emscripten-generated WebAssembly files, such as Lua or nginx.
  • Go ABI: we will work on this soon! Want to give us a hand?
  • Blazor: research period, see tracking issue

Backends

The Wasmer runtime is designed to support multiple compiler backends, allowing the user to tune the codegen properties (compile speed, performance, etc) to best fit their use case.

Currently, we support multiple backends for compiling WebAssembly to machine code:

  • singlepass-backend: Single pass backend - super fast compilation, slower runtime speed
  • clif-backend: Cranelift backend - slower compilation, normal runtime speed
  • llvm-backend: LLVM backend - slow compilation, native runtime speed