Struct wasm_encoder::CoreDumpSection

pub struct CoreDumpSection { /* private fields */ }

The “core” custom section for coredumps, as described in the tool-conventions repository.

There are four sections that comprise a core dump: - “core”, which contains the name of the core dump - “coremodules”, a listing of modules - “coreinstances”, a listing of module instances - “corestack”, a listing of frames for a specific thread

Example of how these could be constructed and encoded into a module:

use wasm_encoder::{
    CoreDumpInstancesSection, CoreDumpModulesSection, CoreDumpSection, CoreDumpStackSection,
    CoreDumpValue, Module,
};
let core = CoreDumpSection::new("MyModule.wasm");

let mut modules = CoreDumpModulesSection::new();
modules.module("my_module");

let mut instances = CoreDumpInstancesSection::new();
let module_idx = 0;
let memories = vec![1];
let globals = vec![2];
instances.instance(module_idx, memories, globals);

let mut thread = CoreDumpStackSection::new("main");
let instance_index = 0;
let func_index = 42;
let code_offset = 0x1234;
let locals = vec![CoreDumpValue::I32(1)];
let stack = vec![CoreDumpValue::I32(2)];
thread.frame(instance_index, func_index, code_offset, locals, stack);

let mut module = Module::new();
module.section(&core);
module.section(&modules);
module.section(&instances);
module.section(&thread);

Implementations

impl CoreDumpSection

pub fn new(name: impl Into<String>) -> Self

Create a new core dump section encoder

Trait Implementations

impl Clone for CoreDumpSection

fn clone(&self) -> CoreDumpSection

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CoreDumpSection

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

Formats the value using the given formatter.

impl Default for CoreDumpSection

fn default() -> CoreDumpSection

Returns the “default value” for a type.

impl Encode for CoreDumpSection

fn encode(&self, sink: &mut Vec<u8>)

Encode the type into the given byte sink.

impl Section for CoreDumpSection

fn id(&self) -> u8

Gets the section identifier for this section.

fn append_to(&self, dst: &mut Vec<u8>)

Appends this section to the specified destination list of bytes.