Struct sc_executor::sandbox::SandboxInstance
source · [−]pub struct SandboxInstance<FR> { /* private fields */ }
Expand description
Sandboxed instance of a wasm module.
It’s primary purpose is to invoke
exported functions on it.
All imports of this instance are specified at the creation time and imports are implemented by the supervisor.
Hence, in order to invoke an exported function on a sandboxed module instance, it’s required to provide supervisor externals: it will be used to execute code in the supervisor context.
This is generic over a supervisor function reference type.
Implementations
sourceimpl<FR> SandboxInstance<FR>
impl<FR> SandboxInstance<FR>
sourcepub fn invoke<FE>(
&self,
export_name: &str,
args: &[RuntimeValue],
supervisor_externals: &mut FE,
state: u32
) -> Result<Option<RuntimeValue>, Error> where
FE: SandboxCapabilities<SupervisorFuncRef = FR>,
pub fn invoke<FE>(
&self,
export_name: &str,
args: &[RuntimeValue],
supervisor_externals: &mut FE,
state: u32
) -> Result<Option<RuntimeValue>, Error> where
FE: SandboxCapabilities<SupervisorFuncRef = FR>,
Invoke an exported function by a name.
supervisor_externals
is required to execute the implementations
of the syscalls that published to a sandboxed module instance.
The state
parameter can be used to provide custom data for
these syscall implementations.
sourcepub fn get_global_val(&self, name: &str) -> Option<Value>
pub fn get_global_val(&self, name: &str) -> Option<Value>
Get the value from a global with the given name
.
Returns Some(_)
if the global could be found.
Auto Trait Implementations
impl<FR> !RefUnwindSafe for SandboxInstance<FR>
impl<FR> !Send for SandboxInstance<FR>
impl<FR> !Sync for SandboxInstance<FR>
impl<FR> Unpin for SandboxInstance<FR> where
FR: Unpin,
impl<FR> !UnwindSafe for SandboxInstance<FR>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcepub fn borrow_mut(&mut self) -> &mut T
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> CheckedConversion for T
impl<T> CheckedConversion for T
sourcefn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,
fn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,
Convert from a value of T
into an equivalent instance of Option<Self>
. Read more
sourcefn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,
fn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,
Consume self to return Some
equivalent value of Option<T>
. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,
impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,
sourceimpl<T> Pointable for T
impl<T> Pointable for T
sourceimpl<T> SaturatedConversion for T
impl<T> SaturatedConversion for T
sourcefn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,
fn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,
Convert from a value of T
into an equivalent instance of Self
. Read more
sourcefn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,
fn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,
Consume self to return an equivalent value of T
. Read more
sourceimpl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,
impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,
sourcepub fn unchecked_into(self) -> T
pub fn unchecked_into(self) -> T
The counterpart to unchecked_from
.
sourceimpl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,
impl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,
sourcepub fn unique_saturated_into(self) -> T
pub fn unique_saturated_into(self) -> T
Consume self to return an equivalent value of T
.