Struct wasmtime::WasmCoreDump

source ·
pub struct WasmCoreDump { /* private fields */ }
Expand description

Representation of a core dump of a WebAssembly module

When the Config::coredump_on_trap option is enabled this structure is attached to the anyhow::Error returned from many Wasmtime functions that execute WebAssembly such as Instance::new or Func::call. This can be acquired with the anyhow::Error::downcast family of methods to programmatically inspect the coredump. Otherwise since it’s part of the error returned this will get printed along with the rest of the error when the error is logged.

Note that some state, such as Wasm locals or values on the operand stack, may be optimized away by the compiler or otherwise not recovered in the coredump.

Capturing of wasm coredumps can be configured through the Config::coredump_on_trap method.

For more information about errors in wasmtime see the documentation of the Trap type.

Implementations§

source§

impl WasmCoreDump

source

pub fn frames(&self) -> &[FrameInfo]

The stack frames for this core dump.

Frames appear in callee to caller order, that is youngest to oldest frames.

source

pub fn modules(&self) -> &[Module]

All modules instantiated inside the store when the core dump was created.

source

pub fn instances(&self) -> &[Instance]

All instances within the store when the core dump was created.

source

pub fn globals(&self) -> &[Global]

All globals, instance- or host-defined, within the store when the core dump was created.

source

pub fn memories(&self) -> &[Memory]

All memories, instance- or host-defined, within the store when the core dump was created.

source

pub fn serialize(&self, store: impl AsContextMut, name: &str) -> Vec<u8>

Serialize this core dump into the standard core dump binary format.

The name parameter may be a file path, URL, or arbitrary name for the “main” Wasm service or executable that was running in this store.

Once serialized, you can write this core dump to disk, send it over the network, or pass it to other debugging tools that consume Wasm core dumps.

Trait Implementations§

source§

impl Debug for WasmCoreDump

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl Display for WasmCoreDump

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
source§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

source§

type Output = T

Should always be Self
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.