5#ifndef WASMTIME_CONFIG_HH
6#define WASMTIME_CONFIG_HH
11#include <wasmtime/helpers.hh>
72#ifdef WASMTIME_FEATURE_POOLING_ALLOCATOR
81 wasmtime_pooling_allocation_config);
89 void max_unused_warm_slots(uint32_t max) {
97 void decommit_batch_size(
size_t batch_size) {
102#ifdef WASMTIME_FEATURE_ASYNC
107 void async_stack_keep_resident(
size_t size) {
117 void linear_memory_keep_resident(
size_t size) {
126 void table_keep_resident(
size_t size) {
134 void total_component_instances(uint32_t count) {
143 void max_component_instance_size(
size_t size) {
152 void max_core_instances_per_component(uint32_t count) {
161 void max_memories_per_component(uint32_t count) {
170 void max_tables_per_component(uint32_t count) {
179 void total_memories(uint32_t count) {
187 void total_tables(uint32_t count) {
191#ifdef WASMTIME_FEATURE_ASYNC
196 void total_stacks(uint32_t count) {
205 void total_core_instances(uint32_t count) {
214 void max_core_instance_size(
size_t size) {
223 void max_tables_per_module(uint32_t tables) {
232 void table_elements(
size_t elements) {
240 void max_memories_per_module(uint32_t memories) {
249 void max_memory_size(
size_t bytes) {
257 void total_gc_heaps(uint32_t count) {
273 WASMTIME_OWN_WRAPPER(
Config, wasm_config);
282 void debug_info(
bool enable) {
290 void epoch_interruption(
bool enable) {
298 void consume_fuel(
bool enable) {
305 void max_wasm_stack(
size_t stack) {
309#ifdef WASMTIME_FEATURE_THREADS
313 void wasm_threads(
bool enable) {
321 void shared_memory(
bool enable) {
328 void wasm_tail_call(
bool enable) {
332#ifdef WASMTIME_FEATURE_GC
337 void wasm_reference_types(
bool enable) {
345 void wasm_simd(
bool enable) {
352 void wasm_relaxed_simd(
bool enable) {
360 void wasm_relaxed_simd_deterministic(
bool enable) {
367 void wasm_bulk_memory(
bool enable) {
374 void wasm_multi_value(
bool enable) {
381 void wasm_multi_memory(
bool enable) {
388 void wasm_memory64(
bool enable) {
392#ifdef WASMTIME_FEATURE_GC
400#ifdef WASMTIME_FEATURE_GC
405 void wasm_function_references(
bool enable) {
414 void wasm_wide_arithmetic(
bool enable) {
418#ifdef WASMTIME_FEATURE_GC
423 void wasm_exceptions(
bool enable) {
432 void wasm_custom_page_sizes(
bool enable) {
436#ifdef WASMTIME_FEATURE_COMPONENT_MODEL
441 void wasm_component_model(
bool enable) {
449 void wasm_component_model_map(
bool enable) {
454#ifdef WASMTIME_FEATURE_PARALLEL_COMPILATION
459 void parallel_compilation(
bool enable) {
464#ifdef WASMTIME_FEATURE_COMPILER
476 void cranelift_debug_verifier(
bool enable) {
483 void cranelift_nan_canonicalization(
bool enable) {
490 void cranelift_opt_level(
OptLevel level) {
498 void cranelift_flag_enable(
const std::string &flag) {
505 void cranelift_flag_set(
const std::string &flag,
const std::string &value) {
529 void memory_reservation(uint64_t size) {
537 void memory_reservation_for_growth(uint64_t size) {
544 void memory_guard_size(uint64_t size) {
552 void memory_may_move(
bool enable) {
559 void memory_init_cow(
bool enable) {
566 void native_unwind_info(
bool enable) {
573 void macos_use_mach_ports(
bool enable) {
579 void signals_based_traps(
bool enable) {
583#ifdef WASMTIME_FEATURE_CACHE
589 if (error !=
nullptr) {
592 return std::monostate();
600 if (error !=
nullptr) {
603 return std::monostate();
608 template <
typename T>
static void raw_finalize(
void *env) {
609 std::unique_ptr<T> ptr(
reinterpret_cast<T *
>(env));
612 template <
typename M>
613 static uint8_t *raw_get_memory(
void *env,
size_t *byte_size,
614 size_t *byte_capacity) {
615 M *memory =
reinterpret_cast<M *
>(env);
616 return memory->get_memory(byte_size, byte_capacity);
619 template <
typename M>
621 M *memory =
reinterpret_cast<M *
>(env);
624 return result.
err().capi_release();
628 template <
typename T>
631 size_t maximum,
size_t reserved_size_in_bytes,
632 size_t guard_size_in_bytes,
634 using Memory =
typename T::Memory;
635 T *creator =
reinterpret_cast<T *
>(env);
638 reserved_size_in_bytes, guard_size_in_bytes);
640 return result.
err().capi_release();
643 memory_ret->
env = std::make_unique<Memory>(memory).release();
644 memory_ret->
finalizer = raw_finalize<Memory>;
645 memory_ret->
get_memory = raw_get_memory<Memory>;
658 config.
env = std::make_unique<T>(creator).release();
664#ifdef WASMTIME_FEATURE_POOLING_ALLOCATOR
673#ifdef WASMTIME_FEATURE_COMPONENT_MODEL
686#ifdef WASMTIME_FEATURE_COMPONENT_MODEL_ASYNC
Configuration for Wasmtime.
Definition: config.hh:272
void host_memory_creator(T creator)
Configures a custom memory creator for this configuration and eventual Engine.
Definition: config.hh:656
void wasm_component_model_async_stackful(bool enable)
Configures whether stackful coroutine support is enabled for async components.
Definition: config.hh:713
void concurrency_support(bool enable)
Specifies whether support for concurrent execution of WebAssembly is supported within this store.
Definition: config.hh:681
void wasm_component_model_more_async_builtins(bool enable)
Configures whether async built-in intrinsics are enabled for the component model.
Definition: config.hh:702
void pooling_allocation_strategy(const PoolAllocationConfig &config)
Enables and configures the pooling allocation strategy.
Definition: config.hh:668
void wasm_component_model_async(bool enable)
Configures whether component-model async support is enabled.
Definition: config.hh:692
Errors coming from Wasmtime.
Definition: error.hh:26
Non-owning reference to a MemoryType, must not be used after the original owner has been deleted.
Definition: types/memory.hh:34
A WebAssembly linear memory.
Definition: memory.hh:27
Pool allocation configuration for Wasmtime.
Definition: config.hh:79
Fallible result type used for Wasmtime.
Definition: error.hh:70
E && err()
Returns the error, if present, aborts if this is not an error.
Definition: error.hh:84
T unwrap()
Returns the success, if present, aborts if this is an error.
Definition: error.hh:104
Build-time defines for how the C API was built.
Wasmtime-specific extensions to wasm_config_t.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_gc_heaps_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of concurrent GC heaps supported (default is 1000).
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_component_instances_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of concurrent component instances supported (default is 1000).
WASM_API_EXTERN void wasmtime_pooling_allocation_config_table_keep_resident_set(wasmtime_pooling_allocation_config_t *, size_t)
How much memory, in bytes, to keep resident for each table after deallocation.
WASM_API_EXTERN void wasmtime_config_shared_memory_set(wasm_config_t *, bool)
Configures whether shared memories can be created.
WASM_API_EXTERN void wasmtime_config_wasm_tail_call_set(wasm_config_t *, bool)
Configures whether the WebAssembly tail call proposal is enabled.
WASM_API_EXTERN void wasmtime_config_max_wasm_stack_set(wasm_config_t *, size_t)
Configures the maximum stack size, in bytes, that JIT code can use.
WASM_API_EXTERN void wasmtime_config_wasm_multi_memory_set(wasm_config_t *, bool)
Configures whether the WebAssembly multi-memory proposal is enabled.
WASM_API_EXTERN wasmtime_error_t * wasmtime_config_cache_config_load(wasm_config_t *, const char *)
Enables Wasmtime's cache and loads configuration from the specified path.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_core_instances_per_component_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of core instances a single component may contain (default is unlimited).
WASM_API_EXTERN void wasmtime_pooling_allocation_strategy_set(wasm_config_t *, const wasmtime_pooling_allocation_config_t *)
Sets the Wasmtime allocation strategy to use the pooling allocator. It does not take ownership of the...
WASM_API_EXTERN void wasmtime_config_wasm_component_model_set(wasm_config_t *, bool)
Configures whether the WebAssembly component-model proposal will be enabled for compilation.
WASM_API_EXTERN void wasmtime_config_wasm_custom_page_sizes_set(wasm_config_t *, bool)
Configures whether the WebAssembly custom-page-sizes proposal is enabled.
uint8_t wasmtime_strategy_t
Specifier for how Wasmtime will compile code, values are in wasmtime_strategy_enum.
Definition: config.h:22
WASM_API_EXTERN void wasmtime_pooling_allocation_config_linear_memory_keep_resident_set(wasmtime_pooling_allocation_config_t *, size_t)
How much memory, in bytes, to keep resident for each linear memory after deallocation.
WASM_API_EXTERN void wasmtime_config_memory_reservation_set(wasm_config_t *, uint64_t)
Configures the size, in bytes, of initial memory reservation size for linear memories.
WASM_API_EXTERN void wasmtime_config_wasm_wide_arithmetic_set(wasm_config_t *, bool)
Configures whether the WebAssembly wide-arithmetic proposal is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_tables_per_module_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of defined tables for a core module (default is 1).
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_tables_per_component_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of tables that a single component may transitively contain (default is unlimited).
WASM_API_EXTERN wasmtime_pooling_allocation_config_t * wasmtime_pooling_allocation_config_new()
Creates a new pooling allocation configuration object. Must be deallocated with a call to wasmtime_po...
WASM_API_EXTERN void wasmtime_config_cranelift_flag_enable(wasm_config_t *, const char *)
Enables a target-specific flag in Cranelift.
WASM_API_EXTERN void wasmtime_config_parallel_compilation_set(wasm_config_t *, bool)
Configure whether wasmtime should compile a module using multiple threads.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_unused_warm_slots_set(wasmtime_pooling_allocation_config_t *, uint32_t)
Configures the maximum number of “unused warm slots” to retain in the pooling allocator.
WASM_API_EXTERN void wasmtime_config_wasm_gc_set(wasm_config_t *, bool)
Configures whether the WebAssembly GC proposal is enabled.
WASM_API_EXTERN void wasmtime_config_macos_use_mach_ports_set(wasm_config_t *, bool)
Configures whether, when on macOS, Mach ports are used for exception handling instead of traditional ...
WASM_API_EXTERN void wasmtime_config_wasm_memory64_set(wasm_config_t *, bool)
Configures whether the WebAssembly memory64 proposal is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_memories_per_module_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of defined linear memories for a module (default is 1).
WASM_API_EXTERN void wasmtime_config_wasm_relaxed_simd_set(wasm_config_t *, bool)
Configures whether the WebAssembly relaxed SIMD proposal is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_memories_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of concurrent Wasm linear memories supported (default is 1000).
WASM_API_EXTERN void wasmtime_config_wasm_bulk_memory_set(wasm_config_t *, bool)
Configures whether the WebAssembly bulk memory proposal is enabled.
uint8_t wasmtime_profiling_strategy_t
Different ways wasmtime can enable profiling JIT code.
Definition: config.h:73
WASM_API_EXTERN void wasmtime_config_cranelift_flag_set(wasm_config_t *, const char *key, const char *value)
Sets a target-specific flag in Cranelift to the specified value.
WASM_API_EXTERN void wasmtime_config_wasm_threads_set(wasm_config_t *, bool)
Configures whether the WebAssembly threading proposal is enabled.
@ WASMTIME_REGALLOC_BACKTRACKING
Definition: config.h:116
@ WASMTIME_REGALLOC_SINGLE_PASS
Definition: config.h:127
WASM_API_EXTERN void wasmtime_pooling_allocation_config_table_elements_set(wasmtime_pooling_allocation_config_t *, size_t)
The maximum table elements for any table defined in a module (default is 20000).
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_core_instance_size_set(wasmtime_pooling_allocation_config_t *, size_t)
The maximum size, in bytes, allocated for a core instance’s VMContext metadata.
WASM_API_EXTERN void wasmtime_config_strategy_set(wasm_config_t *, wasmtime_strategy_t)
Configures how JIT code will be compiled.
WASM_API_EXTERN void wasmtime_config_signals_based_traps_set(wasm_config_t *, bool)
Configures Wasmtime to not use signals-based trap handlers, for example disables SIGILL and SIGSEGV h...
@ WASMTIME_PROFILING_STRATEGY_VTUNE
Definition: config.h:90
@ WASMTIME_PROFILING_STRATEGY_PERFMAP
Definition: config.h:94
@ WASMTIME_PROFILING_STRATEGY_NONE
No profiling is enabled at runtime.
Definition: config.h:82
@ WASMTIME_PROFILING_STRATEGY_JITDUMP
Definition: config.h:85
WASM_API_EXTERN void wasmtime_config_memory_guard_size_set(wasm_config_t *, uint64_t)
Configures the guard region size for linear memory.
WASM_API_EXTERN void wasmtime_config_cranelift_debug_verifier_set(wasm_config_t *, bool)
Configures whether Cranelift's debug verifier is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_stacks_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of execution stacks allowed for asynchronous execution, when enabled (default is 1...
@ WASMTIME_STRATEGY_CRANELIFT
Definition: config.h:36
@ WASMTIME_STRATEGY_WINCH
Definition: config.h:43
@ WASMTIME_STRATEGY_AUTO
Definition: config.h:32
WASM_API_EXTERN void wasmtime_config_wasm_component_model_async_stackful_set(wasm_config_t *, bool)
Configures whether stackful coroutine support is enabled for async components.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_memories_per_component_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of Wasm linear memories that a single component may transitively contain (default ...
WASM_API_EXTERN void wasmtime_config_cranelift_opt_level_set(wasm_config_t *, wasmtime_opt_level_t)
Configures Cranelift's optimization level for JIT code.
WASM_API_EXTERN void wasmtime_config_consume_fuel_set(wasm_config_t *, bool)
Whether or not fuel is enabled for generated code.
WASM_API_EXTERN void wasmtime_config_debug_info_set(wasm_config_t *, bool)
Configures whether DWARF debug information is constructed at runtime to describe JIT code.
WASM_API_EXTERN void wasmtime_config_wasm_relaxed_simd_deterministic_set(wasm_config_t *, bool)
Configures whether the WebAssembly relaxed SIMD proposal is in deterministic mode.
WASM_API_EXTERN void wasmtime_config_wasm_component_model_more_async_builtins_set(wasm_config_t *, bool)
Configures whether async built-in intrinsics are enabled for the component model.
WASM_API_EXTERN void wasmtime_config_wasm_exceptions_set(wasm_config_t *, bool)
Configures whether the WebAssembly exceptions proposal is enabled.
WASM_API_EXTERN void wasmtime_config_native_unwind_info_set(wasm_config_t *, bool)
Configures whether to generate native unwind information (e.g. .eh_frame on Linux).
@ WASMTIME_OPT_LEVEL_SPEED_AND_SIZE
Definition: config.h:65
@ WASMTIME_OPT_LEVEL_NONE
Generated code will not be optimized at all.
Definition: config.h:60
@ WASMTIME_OPT_LEVEL_SPEED
Generated code will be optimized purely for speed.
Definition: config.h:62
uint8_t wasmtime_opt_level_t
Specifier of what optimization level to use for generated JIT code.
Definition: config.h:51
WASM_API_EXTERN void wasmtime_config_profiler_set(wasm_config_t *, wasmtime_profiling_strategy_t)
Configures the profiling strategy used for JIT code.
WASM_API_EXTERN void wasmtime_config_wasm_simd_set(wasm_config_t *, bool)
Configures whether the WebAssembly SIMD proposal is enabled.
WASM_API_EXTERN void wasmtime_config_epoch_interruption_set(wasm_config_t *, bool)
Whether or not epoch-based interruption is enabled for generated code.
WASM_API_EXTERN void wasmtime_config_cranelift_regalloc_algorithm_set(wasm_config_t *, wasmtime_regalloc_algorithm_t)
Configures the regalloc algorithm used by the Cranelift code generator.
WASM_API_EXTERN void wasmtime_config_cranelift_nan_canonicalization_set(wasm_config_t *, bool)
Configures whether Cranelift should perform a NaN-canonicalization pass.
WASM_API_EXTERN void wasmtime_config_memory_reservation_for_growth_set(wasm_config_t *, uint64_t)
Configures the size, in bytes, of the extra virtual memory space reserved for memories to grow into a...
uint8_t wasmtime_regalloc_algorithm_t
Different ways Cranelift can allocate registers.
Definition: config.h:102
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_core_instances_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of concurrent core instances supported (default is 1000).
WASM_API_EXTERN void wasmtime_config_host_memory_creator_set(wasm_config_t *, wasmtime_memory_creator_t *)
WASM_API_EXTERN void wasmtime_config_wasm_component_model_async_set(wasm_config_t *, bool)
Configures whether the WebAssembly component-model async support will be enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_total_tables_set(wasmtime_pooling_allocation_config_t *, uint32_t)
The maximum number of concurrent tables supported (default is 1000).
WASM_API_EXTERN void wasmtime_config_wasm_function_references_set(wasm_config_t *, bool)
Configures whether the WebAssembly typed function reference types proposal is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_decommit_batch_size_set(wasmtime_pooling_allocation_config_t *, size_t)
The target number of decommits to do per batch.
WASM_API_EXTERN void wasmtime_config_wasm_reference_types_set(wasm_config_t *, bool)
Configures whether the WebAssembly reference types proposal is enabled.
WASM_API_EXTERN void wasmtime_config_memory_init_cow_set(wasm_config_t *, bool)
Configures whether copy-on-write memory-mapped data is used to initialize a linear memory.
WASM_API_EXTERN void wasmtime_config_concurrency_support_set(wasm_config_t *, bool)
Specifies whether support for concurrent execution of WebAssembly is supported within this store.
WASM_API_EXTERN void wasmtime_config_wasm_component_model_map_set(wasm_config_t *, bool)
Configures whether the WebAssembly component-model map type will be enabled for compilation.
WASM_API_EXTERN void wasmtime_config_wasm_multi_value_set(wasm_config_t *, bool)
Configures whether the WebAssembly multi value proposal is enabled.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_memory_size_set(wasmtime_pooling_allocation_config_t *, size_t)
The maximum byte size that any WebAssembly linear memory may grow to.
WASM_API_EXTERN void wasmtime_config_memory_may_move_set(wasm_config_t *, bool)
Configures whether memory_reservation is the maximal size of linear memory.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_max_component_instance_size_set(wasmtime_pooling_allocation_config_t *, size_t)
The maximum size, in bytes, allocated for a component instance’s VMComponentContext metadata.
WASM_API_EXTERN void wasmtime_pooling_allocation_config_async_stack_keep_resident_set(wasmtime_pooling_allocation_config_t *, size_t)
How much memory, in bytes, to keep resident for async stacks allocated with the pooling allocator.
RegallocAlgorithm
Values passed to Config::cranelift_regalloc_algorithm
Definition: config.hh:49
@ Backtracking
Definition: config.hh:58
@ SinglePass
Definition: config.hh:69
Strategy
Strategies passed to Config::strategy
Definition: config.hh:17
@ Auto
Automatically selects the compilation strategy.
@ Cranelift
Requires Cranelift to be used for compilation.
@ Winch
Use winch for compilation.
OptLevel
Values passed to Config::cranelift_opt_level
Definition: config.hh:27
@ Speed
Optimize for speed.
@ None
No extra optimizations performed.
@ SpeedAndSize
Optimize for speed and generated code size.
ProfilingStrategy
Values passed to Config::profiler
Definition: config.hh:37
@ Perfmap
Profiling hooks via perfmap.
@ Vtune
Profiling hooks via VTune.
@ Jitdump
Profiling hooks via perf's jitdump.
An opaque object representing the type of a memory.
Errors generated by Wasmtime.
wasmtime_memory_get_callback_t get_memory
Callback to get the memory and size of this LinearMemory.
Definition: config.h:576
void * env
User provided value to be passed to get_memory and grow_memory.
Definition: config.h:574
void(* finalizer)(void *)
An optional finalizer for env.
Definition: config.h:580
wasmtime_memory_grow_callback_t grow_memory
Callback to request growing the memory.
Definition: config.h:578
void(* finalizer)(void *)
An optional finalizer for env.
Definition: config.h:612
wasmtime_new_memory_callback_t new_memory
The callback to create new memory, must be thread safe.
Definition: config.h:610
void * env
User provided value to be passed to new_memory.
Definition: config.h:608
wasm_config_t * wasm_config_new(void)
Creates a new empty configuration object.