Remove the need to have a Store for an InstancePre (#5683)
* Remove the need to have a `Store` for an `InstancePre` This commit relaxes a requirement of the `InstancePre` API, notably its construction via `Linker::instantiate_pre`. Previously this function required a `Store<T>` to be present to be able to perform type-checking on the contents of the linker, and now this requirement has been removed. Items stored within a linker are either a `HostFunc`, which has type information inside of it, or an `Extern`, which doesn't have type information inside of it. Due to the usage of `Extern` this is why a `Store` was required during the `InstancePre` construction process, it's used to extract the type of an `Extern`. This commit implements a solution where the type information of an `Extern` is stored alongside the `Extern` itself, meaning that the `InstancePre` construction process no longer requires a `Store<T>`. One caveat of this implementation is that some items, such as tables and memories, technically have a "dynamic type" where during type checking their current size is consulted to match against the minimum size required of an import. This no longer works when using `Linker::instantiate_pre` as the current size used is the one when it was inserted into the linker rather than the one available at instantiation time. It's hoped, however, that this is a relatively esoteric use case that doesn't impact many real-world users. Additionally note that this is an API-breaking change. Not only is the `Store` argument removed from `Linker::instantiate_pre`, but some other methods such as `Linker::define` grew a `Store` argument as the type needs to be extracted when an item is inserted into a linker. Closes #5675 * Fix the C API * Fix benchmark compilation * Add C API docs * Update crates/wasmtime/src/linker.rs Co-authored-by: Andrew Brown <andrew.brown@intel.com> --------- Co-authored-by: Andrew Brown <andrew.brown@intel.com>
This commit is contained in:
@@ -544,45 +544,40 @@ pub fn table_ops(
|
||||
// test case.
|
||||
const MAX_GCS: usize = 5;
|
||||
|
||||
linker
|
||||
.define(
|
||||
"",
|
||||
"gc",
|
||||
// NB: use `Func::new` so that this can still compile on the old x86
|
||||
// backend, where `IntoFunc` isn't implemented for multi-value
|
||||
// returns.
|
||||
Func::new(
|
||||
&mut store,
|
||||
FuncType::new(
|
||||
vec![],
|
||||
vec![ValType::ExternRef, ValType::ExternRef, ValType::ExternRef],
|
||||
),
|
||||
{
|
||||
let num_dropped = num_dropped.clone();
|
||||
let expected_drops = expected_drops.clone();
|
||||
let num_gcs = num_gcs.clone();
|
||||
move |mut caller: Caller<'_, StoreLimits>, _params, results| {
|
||||
log::info!("table_ops: GC");
|
||||
if num_gcs.fetch_add(1, SeqCst) < MAX_GCS {
|
||||
caller.gc();
|
||||
}
|
||||
// NB: use `Func::new` so that this can still compile on the old x86
|
||||
// backend, where `IntoFunc` isn't implemented for multi-value
|
||||
// returns.
|
||||
let func = Func::new(
|
||||
&mut store,
|
||||
FuncType::new(
|
||||
vec![],
|
||||
vec![ValType::ExternRef, ValType::ExternRef, ValType::ExternRef],
|
||||
),
|
||||
{
|
||||
let num_dropped = num_dropped.clone();
|
||||
let expected_drops = expected_drops.clone();
|
||||
let num_gcs = num_gcs.clone();
|
||||
move |mut caller: Caller<'_, StoreLimits>, _params, results| {
|
||||
log::info!("table_ops: GC");
|
||||
if num_gcs.fetch_add(1, SeqCst) < MAX_GCS {
|
||||
caller.gc();
|
||||
}
|
||||
|
||||
let a = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
let b = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
let c = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
let a = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
let b = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
let c = ExternRef::new(CountDrops(num_dropped.clone()));
|
||||
|
||||
log::info!("table_ops: make_refs() -> ({:p}, {:p}, {:p})", a, b, c);
|
||||
log::info!("table_ops: make_refs() -> ({:p}, {:p}, {:p})", a, b, c);
|
||||
|
||||
expected_drops.fetch_add(3, SeqCst);
|
||||
results[0] = Some(a).into();
|
||||
results[1] = Some(b).into();
|
||||
results[2] = Some(c).into();
|
||||
Ok(())
|
||||
}
|
||||
},
|
||||
),
|
||||
)
|
||||
.unwrap();
|
||||
expected_drops.fetch_add(3, SeqCst);
|
||||
results[0] = Some(a).into();
|
||||
results[1] = Some(b).into();
|
||||
results[2] = Some(c).into();
|
||||
Ok(())
|
||||
}
|
||||
},
|
||||
);
|
||||
linker.define(&store, "", "gc", func).unwrap();
|
||||
|
||||
linker
|
||||
.func_wrap("", "take_refs", {
|
||||
@@ -624,37 +619,29 @@ pub fn table_ops(
|
||||
})
|
||||
.unwrap();
|
||||
|
||||
linker
|
||||
.define(
|
||||
"",
|
||||
"make_refs",
|
||||
// NB: use `Func::new` so that this can still compile on the old
|
||||
// x86 backend, where `IntoFunc` isn't implemented for
|
||||
// multi-value returns.
|
||||
Func::new(
|
||||
&mut store,
|
||||
FuncType::new(
|
||||
vec![],
|
||||
vec![ValType::ExternRef, ValType::ExternRef, ValType::ExternRef],
|
||||
),
|
||||
{
|
||||
let num_dropped = num_dropped.clone();
|
||||
let expected_drops = expected_drops.clone();
|
||||
move |_caller, _params, results| {
|
||||
log::info!("table_ops: make_refs");
|
||||
expected_drops.fetch_add(3, SeqCst);
|
||||
results[0] =
|
||||
Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
results[1] =
|
||||
Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
results[2] =
|
||||
Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
Ok(())
|
||||
}
|
||||
},
|
||||
),
|
||||
)
|
||||
.unwrap();
|
||||
// NB: use `Func::new` so that this can still compile on the old
|
||||
// x86 backend, where `IntoFunc` isn't implemented for
|
||||
// multi-value returns.
|
||||
let func = Func::new(
|
||||
&mut store,
|
||||
FuncType::new(
|
||||
vec![],
|
||||
vec![ValType::ExternRef, ValType::ExternRef, ValType::ExternRef],
|
||||
),
|
||||
{
|
||||
let num_dropped = num_dropped.clone();
|
||||
let expected_drops = expected_drops.clone();
|
||||
move |_caller, _params, results| {
|
||||
log::info!("table_ops: make_refs");
|
||||
expected_drops.fetch_add(3, SeqCst);
|
||||
results[0] = Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
results[1] = Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
results[2] = Some(ExternRef::new(CountDrops(num_dropped.clone()))).into();
|
||||
Ok(())
|
||||
}
|
||||
},
|
||||
);
|
||||
linker.define(&store, "", "make_refs", func).unwrap();
|
||||
|
||||
let instance = linker.instantiate(&mut store, &module).unwrap();
|
||||
let run = instance.get_func(&mut store, "run").unwrap();
|
||||
|
||||
@@ -8,12 +8,9 @@ pub fn dummy_linker<'module, T>(store: &mut Store<T>, module: &Module) -> Result
|
||||
let mut linker = Linker::new(store.engine());
|
||||
linker.allow_shadowing(true);
|
||||
for import in module.imports() {
|
||||
let extern_ = dummy_extern(store, import.ty())?;
|
||||
linker
|
||||
.define(
|
||||
import.module(),
|
||||
import.name(),
|
||||
dummy_extern(store, import.ty())?,
|
||||
)
|
||||
.define(&store, import.module(), import.name(), extern_)
|
||||
.unwrap();
|
||||
}
|
||||
Ok(linker)
|
||||
|
||||
Reference in New Issue
Block a user