whamm 0.1.0

A framework for 'Wasm Application Monitoring and Manipulation'
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# `Whamm` Scripts #

Instrumentation (aka a monitor) is expressed as a set of predicated probes in a script with the `.mm` extension.

Here is a high-level view of the grammar for a `Whamm` script:
```
// Statements to initialize the global state of the instrumentation
global_statements;
...

// Function definitions to reuse code snippets
fn_name(fn_args) -> ret_val { fn_body; ... }
...

// An example of what a `probe` would look.
// There can be many of these in a monitor.
provider:package:event:mode / predicate / {
  probe_actions;
  ...
}
```

## Instrumenting with the CLI ##
`whamm instr --help`

The `instr` command provided by the CLI enables developers to actually instrument programs.