Struct GcOps 

pub struct GcOps { /* private fields */ }

A description of a Wasm module that performs a series of GC operations on externrefs, i31s, and struct and array objects of its own types.

Implementations

impl GcOps

pub fn to_wasm_binary(&mut self) -> Vec<u8>

Serialize this module into a Wasm binary.

The module requires several function imports. See this function’s implementation for their exact types.

The single export of the module is a function “run” that takes self.num_params parameters of type externref.

The “run” function does not terminate; you should run it with limited fuel. It also is not guaranteed to avoid traps: it may access out-of-bounds of the table.

pub fn fixup( &mut self, encoding_order_grouped: &mut Vec<(RecGroupId, Vec<TypeId>)>, )

Fixes this test case such that it becomes valid.

This is necessary because a random mutation (e.g. removing an op in the middle of our sequence) might have made it so that subsequent ops won’t have their expected operand types on the Wasm stack anymore. Furthermore, because we serialize and deserialize test cases, and libFuzzer will occasionally mutate those serialized bytes directly, rather than use one of our custom mutations, we have no guarantee that pre-mutation test cases are even valid! Therefore, we always call this method before translating this “AST”-style representation into a raw Wasm binary.

pub fn pop(&mut self) -> bool

Attempts to remove the last opcode from the sequence.

Returns true if an opcode was successfully removed, or false if the list was already empty.

Trait Implementations

impl<'a> Arbitrary<'a> for GcOps

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for GcOps

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GcOps

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

Formats the value using the given formatter.

impl Default for GcOps

fn default() -> Self

Returns the “default value” for a type.

impl DefaultMutate for GcOps

type DefaultMutate = GcOpsMutator

The default mutator for this type.

impl<'de> Deserialize<'de> for GcOps

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Generate<GcOps> for GcOpsMutator

fn generate(&mut self, ctx: &mut Context) -> MutResult<GcOps>

Generate a random T value from scratch.

impl Mutate<GcOps> for GcOpsMutator

fn mutate(&mut self, c: &mut Candidates<'_>, ops: &mut GcOps) -> MutResult<()>

Pseudo-randomly mutate the given value.

fn mutation_count(&self, value: &T, shrink: bool) -> Option<u32>

Return the number of mutations that [mutate][Mutate::mutate] would register for the given value.

fn generate_via_mutate( &mut self, context: &mut Context, iters: usize, ) -> Result<T, Error>

where T: Sized + Default,

Generate a new value by mutating its default value iters times.

fn or<M>(self, other: M) -> Or<Self, M>

where Self: Sized,

Create a new mutator that performs either this mutation or the other mutation.

fn map<F>(self, f: F) -> Map<Self, F>

where Self: Sized, F: FnMut(&mut Context, &mut T) -> Result<(), Error>,

Map a function over the mutations produced by this mutator.

fn proj<F, U>(self, f: F) -> Proj<Self, F>

where Self: Sized, F: FnMut(&mut U) -> &mut T,

Given a projection function F: FnMut(&mut U) -> &mut T, turn this Mutate<T> into a Mutate<U>.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Borrows a mutator, rather than consuming it.

impl Serialize for GcOps

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.