Skip to content
This repository has been archived by the owner on Nov 15, 2023. It is now read-only.

Refactor WASM module instantiation #10480

Merged
merged 22 commits into from
Mar 19, 2022
Merged
Show file tree
Hide file tree
Changes from 16 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
f4d9282
Refactor WASM module instantiation; enable WASM instance pooling
koute Dec 14, 2021
6b9b777
Disable the `uffd` feature on `wasmtime`
koute Dec 15, 2021
d982eeb
Merge branch 'master' into master_wasmtime_pooling
koute Dec 15, 2021
92cbf66
Restore the original behavior regarding the initial WASM memory size
koute Dec 15, 2021
719aadd
Adjust error message
koute Dec 15, 2021
d9e055b
Remove unnecessary import in the benchmarks
koute Dec 16, 2021
2f53ad6
Preinstantiate the WASM runtime for a slight speedup
koute Dec 16, 2021
19daf56
Delete the asserts in `convert_memory_import_into_export`
koute Dec 16, 2021
ae988e2
`return` -> `break`
koute Dec 16, 2021
44c5086
Revert WASM instance pooling for now
koute Dec 16, 2021
afd355b
Have `convert_memory_import_into_export` return an error instead of p…
koute Dec 17, 2021
3e8932f
Update the warning when an import is missing
koute Jan 20, 2022
0a61182
Merge branch 'master' into master_wasmtime_pooling
koute Jan 20, 2022
7370f41
Rustfmt and clippy fix
koute Jan 24, 2022
539347e
Fix executor benchmarks' compilation without `wasmtime` being enabled
koute Jan 24, 2022
7f0d17a
rustfmt again
koute Jan 28, 2022
780b0ec
Align to review comments
koute Feb 10, 2022
72aa655
Extend tests so that both imported and exported memories are tested
koute Feb 10, 2022
3a15f68
Increase the number of heap pages for exported memories too
koute Feb 10, 2022
3cb916e
Merge branch 'master' into master_wasmtime_pooling
koute Feb 10, 2022
3b4ca22
Fix `decommit_works` test
koute Feb 10, 2022
e3be4e7
Merge branch 'master' into master_wasmtime_pooling
koute Feb 18, 2022
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
2 changes: 2 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions client/executor/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,12 @@ tracing = "0.1.29"
tracing-subscriber = "0.2.19"
paste = "1.0"
regex = "1"
criterion = "0.3"
env_logger = "0.9"

[[bench]]
name = "bench"
harness = false

[features]
default = ["std"]
Expand Down
136 changes: 136 additions & 0 deletions client/executor/benches/bench.rs
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
// This file is part of Substrate.

// Copyright (C) 2021 Parity Technologies (UK) Ltd.
// SPDX-License-Identifier: Apache-2.0

// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use criterion::{criterion_group, criterion_main, Criterion};

use sc_executor_common::{runtime_blob::RuntimeBlob, wasm_runtime::WasmModule};
use sc_runtime_test::wasm_binary_unwrap as test_runtime;
use sp_wasm_interface::HostFunctions as _;
use std::sync::Arc;

enum Method {
Interpreted,
#[cfg(feature = "wasmtime")]
Compiled {
fast_instance_reuse: bool,
},
}

// This is just a bog-standard Kusama runtime with the extra `test_empty_return`
// function copy-pasted from the test runtime.
fn kusama_runtime() -> &'static [u8] {
include_bytes!("kusama_runtime.wasm")
koute marked this conversation as resolved.
Show resolved Hide resolved
}

fn initialize(runtime: &[u8], method: Method) -> Arc<dyn WasmModule> {
let blob = RuntimeBlob::uncompress_if_needed(runtime).unwrap();
let host_functions = sp_io::SubstrateHostFunctions::host_functions();
let heap_pages = 2048;
let allow_missing_func_imports = true;

match method {
Method::Interpreted => sc_executor_wasmi::create_runtime(
blob,
heap_pages,
host_functions,
allow_missing_func_imports,
)
.map(|runtime| -> Arc<dyn WasmModule> { Arc::new(runtime) }),
#[cfg(feature = "wasmtime")]
Method::Compiled { fast_instance_reuse } =>
sc_executor_wasmtime::create_runtime::<sp_io::SubstrateHostFunctions>(
blob,
sc_executor_wasmtime::Config {
heap_pages,
max_memory_size: None,
allow_missing_func_imports,
cache_path: None,
semantics: sc_executor_wasmtime::Semantics {
fast_instance_reuse,
deterministic_stack_limit: None,
canonicalize_nans: false,
parallel_compilation: true,
},
},
)
.map(|runtime| -> Arc<dyn WasmModule> { Arc::new(runtime) }),
}
.unwrap()
}

fn bench_call_instance(c: &mut Criterion) {
let _ = env_logger::try_init();

#[cfg(feature = "wasmtime")]
{
let runtime = initialize(test_runtime(), Method::Compiled { fast_instance_reuse: true });
c.bench_function("call_instance_test_runtime_with_fast_instance_reuse", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap())
});
}

#[cfg(feature = "wasmtime")]
{
let runtime = initialize(test_runtime(), Method::Compiled { fast_instance_reuse: false });
c.bench_function("call_instance_test_runtime_without_fast_instance_reuse", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap());
});
}

#[cfg(feature = "wasmtime")]
{
let runtime = initialize(kusama_runtime(), Method::Compiled { fast_instance_reuse: true });
c.bench_function("call_instance_kusama_runtime_with_fast_instance_reuse", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap())
});
}

#[cfg(feature = "wasmtime")]
{
let runtime = initialize(kusama_runtime(), Method::Compiled { fast_instance_reuse: false });
c.bench_function("call_instance_kusama_runtime_without_fast_instance_reuse", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap());
});
}

{
let runtime = initialize(test_runtime(), Method::Interpreted);
c.bench_function("call_instance_test_runtime_interpreted", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap())
});
}

{
let runtime = initialize(kusama_runtime(), Method::Interpreted);
c.bench_function("call_instance_kusama_runtime_interpreted", |b| {
let mut instance = runtime.new_instance().unwrap();
b.iter(|| instance.call_export("test_empty_return", &[0]).unwrap())
});
}
}

criterion_group! {
name = benches;
config = Criterion::default();
targets = bench_call_instance
}
criterion_main!(benches);
Binary file added client/executor/benches/kusama_runtime.wasm
Binary file not shown.
61 changes: 60 additions & 1 deletion client/executor/common/src/runtime_blob/runtime_blob.rs
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,10 @@
use crate::error::WasmError;
use wasm_instrument::{
export_mutable_globals,
parity_wasm::elements::{deserialize_buffer, serialize, DataSegment, Internal, Module},
parity_wasm::elements::{
deserialize_buffer, serialize, DataSegment, ExportEntry, External, Internal, MemorySection,
MemoryType, Module, Section,
},
};

/// A bunch of information collected from a WebAssembly module.
Expand Down Expand Up @@ -104,6 +107,62 @@ impl RuntimeBlob {
.unwrap_or_default()
}

/// Converts a WASM memory import into a memory section and exports it.
///
/// Does nothing if there's no memory import.
///
/// May return an error in case the WASM module is invalid.
pub fn convert_memory_import_into_export(
&mut self,
extra_heap_pages: u32,
) -> Result<(), WasmError> {
let import_section = match self.raw_module.import_section_mut() {
Some(import_section) => import_section,
None => return Ok(()),
};

let import_entries = import_section.entries_mut();
for index in 0..import_entries.len() {
let entry = &import_entries[index];
let old_memory_ty = match entry.external() {
External::Memory(memory_ty) => memory_ty,
_ => continue,
};

let memory_name = entry.field().to_owned();
let min = old_memory_ty.limits().initial().saturating_add(extra_heap_pages);
let max = old_memory_ty.limits().maximum().map(|max| std::cmp::max(min, max));
import_entries.remove(index);

let new_memory_ty = MemoryType::new(min, max);
self.raw_module
.insert_section(Section::Memory(MemorySection::with_entries(vec![new_memory_ty])))
.map_err(|error| {
WasmError::Other(format!(
"can't convert a memory import into an export: failed to insert a new memory section: {}",
error
))
})?;

if self.raw_module.export_section_mut().is_none() {
// A module without an export section is somewhat unrealistic, but let's do this
// just in case to cover all of our bases.
self.raw_module
.insert_section(Section::Export(Default::default()))
.expect("an export section can be always inserted if it doesn't exist");
koute marked this conversation as resolved.
Show resolved Hide resolved
}
self.raw_module
.export_section_mut()
.expect("export section always exists")
koute marked this conversation as resolved.
Show resolved Hide resolved
.entries_mut()
.push(ExportEntry::new(memory_name, Internal::Memory(0)));

break
}

Ok(())
}

/// Returns an iterator of all globals which were exported by [`expose_mutable_globals`].
pub(super) fn exported_internal_global_names<'module>(
&'module self,
Expand Down
Loading