Wasmtime
component/linker.h
Go to the documentation of this file.
1
2
3#ifndef WASMTIME_COMPONENT_LINKER_H
4#define WASMTIME_COMPONENT_LINKER_H
5
6#include <wasm.h>
10#include <wasmtime/conf.h>
11#include <wasmtime/error.h>
12#include <wasmtime/module.h>
13#include <wasmtime/store.h>
14
15#ifdef WASMTIME_FEATURE_COMPONENT_MODEL
16
17#ifdef __cplusplus
18extern "C" {
19#endif
20
23
27
35WASM_API_EXTERN wasmtime_component_linker_t *
37
44WASM_API_EXTERN void
46 bool allow);
47
59
75 const wasmtime_component_linker_t *linker, wasmtime_context_t *context,
76 const wasmtime_component_t *component,
77 wasmtime_component_instance_t *instance_out);
78
82WASM_API_EXTERN wasmtime_error_t *
84 wasmtime_component_linker_t *linker, const wasmtime_component_t *component);
85
92WASM_API_EXTERN void
94
113WASM_API_EXTERN wasmtime_error_t *
115 wasmtime_component_linker_instance_t *linker_instance, const char *name,
116 size_t name_len,
117 wasmtime_component_linker_instance_t **linker_instance_out);
118
133 wasmtime_component_linker_instance_t *linker_instance, const char *name,
134 size_t name_len, const wasmtime_module_t *module);
135
137typedef wasmtime_error_t *(*wasmtime_component_func_callback_t)(
140
154 wasmtime_component_linker_instance_t *linker_instance, const char *name,
155 size_t name_len, wasmtime_component_func_callback_t callback, void *data,
156 void (*finalizer)(void *));
157
158#ifdef WASMTIME_FEATURE_WASI
159
163WASM_API_EXTERN wasmtime_error_t *
165
166#endif // WASMTIME_FEATURE_WASI
167
170typedef wasmtime_error_t *(*wasmtime_component_resource_destructor_t)(
171 void *, wasmtime_context_t *, uint32_t);
172
184WASM_API_EXTERN wasmtime_error_t *
186 wasmtime_component_linker_instance_t *linker_instance, const char *name,
187 size_t name_len, const wasmtime_component_resource_type_t *resource,
188 wasmtime_component_resource_destructor_t destructor, void *data,
189 void (*finalizer)(void *));
190
197 wasmtime_component_linker_instance_t *linker_instance);
198
199#ifdef __cplusplus
200} // extern "C"
201#endif
202
203#endif // WASMTIME_FEATURE_COMPONENT_MODEL
204
205#endif // WASMTIME_COMPONENT_LINKER_H
struct wasmtime_component_t wasmtime_component_t
Representation of a component in the component model.
Definition: component/component.h:18
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_instance_add_func(wasmtime_component_linker_instance_t *linker_instance, const char *name, size_t name_len, wasmtime_component_func_callback_t callback, void *data, void(*finalizer)(void *))
Define a function within this instance.
struct wasmtime_component_linker_instance_t wasmtime_component_linker_instance_t
Structure representing an "instance" being defined within a linker.
Definition: component/linker.h:25
WASM_API_EXTERN wasmtime_component_linker_instance_t * wasmtime_component_linker_root(wasmtime_component_linker_t *linker)
Returns the "root instance" of this linker, used to define names into the root namespace.
wasmtime_error_t *(* wasmtime_component_func_callback_t)(void *, wasmtime_context_t *, const wasmtime_component_func_type_t *, wasmtime_component_val_t *, size_t, wasmtime_component_val_t *, size_t)
Type of the callback used in wasmtime_component_linker_instance_add_func.
Definition: component/linker.h:137
WASM_API_EXTERN void wasmtime_component_linker_allow_shadowing(wasmtime_component_linker_t *linker, bool allow)
Configures whether this linker allows later definitions to shadow previous definitions.
wasmtime_error_t *(* wasmtime_component_resource_destructor_t)(void *, wasmtime_context_t *, uint32_t)
Definition: component/linker.h:170
WASM_API_EXTERN void wasmtime_component_linker_delete(wasmtime_component_linker_t *linker)
Deletes a wasmtime_component_linker_t created by wasmtime_component_linker_new.
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_add_wasip2(wasmtime_component_linker_t *linker)
Add all WASI interfaces into the linker provided.
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_instance_add_resource(wasmtime_component_linker_instance_t *linker_instance, const char *name, size_t name_len, const wasmtime_component_resource_type_t *resource, wasmtime_component_resource_destructor_t destructor, void *data, void(*finalizer)(void *))
Defines a new resource type within this instance.
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_instance_add_instance(wasmtime_component_linker_instance_t *linker_instance, const char *name, size_t name_len, wasmtime_component_linker_instance_t **linker_instance_out)
Defines a nested instance within this instance.
struct wasmtime_component_linker_t wasmtime_component_linker_t
A type used to instantiate a wasmtime_component_t.
Definition: component/linker.h:22
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_instance_add_module(wasmtime_component_linker_instance_t *linker_instance, const char *name, size_t name_len, const wasmtime_module_t *module)
Defines a wasmtime_module_t within this instance.
WASM_API_EXTERN void wasmtime_component_linker_instance_delete(wasmtime_component_linker_instance_t *linker_instance)
Deletes a wasmtime_component_linker_instance_t.
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_instantiate(const wasmtime_component_linker_t *linker, wasmtime_context_t *context, const wasmtime_component_t *component, wasmtime_component_instance_t *instance_out)
Instantiates a component instance in a given wasmtime_context_t.
WASM_API_EXTERN wasmtime_component_linker_t * wasmtime_component_linker_new(const wasm_engine_t *engine)
Creates a new wasmtime_component_linker_t for the specified engine.
WASM_API_EXTERN wasmtime_error_t * wasmtime_component_linker_define_unknown_imports_as_traps(wasmtime_component_linker_t *linker, const wasmtime_component_t *component)
Defines all unknown imports of component as trapping functions.
struct wasmtime_component_func_type_t wasmtime_component_func_type_t
Opaque type representing a component function type.
Definition: component/types/func.h:18
Build-time defines for how the C API was built.
Definition and accessors of wasmtime_error_t.
struct wasmtime_component_resource_type wasmtime_component_resource_type_t
Represents the type of a component resource.
Definition: resource.h:21
Compilation environment and configuration.
Representation of a instance in Wasmtime.
Definition: component/instance.h:24
Represents possible runtime values which a component function can either consume or produce.
Definition: component/val.h:376
An interior pointer into a wasmtime_store_t which is used as "context" for many functions.
Errors generated by Wasmtime.
A compiled Wasmtime module.