28 releases (9 breaking)

new 0.105.1 Feb 20, 2024
0.104.1 Feb 7, 2024
0.103.0 Dec 20, 2023
0.102.0 Nov 20, 2023
0.98.1 Jul 24, 2023

#97 in WebAssembly

Download history 34550/week @ 2023-10-31 30624/week @ 2023-11-07 30139/week @ 2023-11-14 26517/week @ 2023-11-21 29225/week @ 2023-11-28 30303/week @ 2023-12-05 29762/week @ 2023-12-12 21679/week @ 2023-12-19 14234/week @ 2023-12-26 27729/week @ 2024-01-02 30764/week @ 2024-01-09 39496/week @ 2024-01-16 36531/week @ 2024-01-23 38108/week @ 2024-01-30 40575/week @ 2024-02-06 30252/week @ 2024-02-13

152,802 downloads per month
Used in 109 crates (7 directly)

Apache-2.0 WITH LLVM-exception

107 lines

This crate contains the control plane for "chaos mode". It can be used to inject pseudo-random perturbations into specific sections in the code while fuzzing. Its compilation is feature-gated to prevent any performance impact on release builds.


Cranelift Control

This is the home of the control plane of chaos mode, a compilation feature intended to be turned on for certain fuzz targets. When the feature is turned off, as is normally the case, [ControlPlane] will be a zero-sized type and optimized away.

While the feature is turned on, the struct [ControlPlane] provides functionality to tap into pseudo-randomness at specific locations in the code. It may be used for targeted fuzzing of compiler internals, e.g. manipulate heuristic optimizations, clobber undefined register bits etc.

There are two ways to acquire a [ControlPlane]:

  • arbitrary for the real deal
  • default for an "empty" control plane which always returns default values

Fuel Limit

Controls the number of mutations or optimizations that the compiler will perform before stopping.

When a perturbation introduced by chaos mode triggers a bug, it may not be immediately clear which of the introduced perturbations was the trigger. The fuel limit can then be used to binary-search for the trigger. It limits the number of perturbations introduced by the control plane. The fuel limit will typically be set with a command line argument passed to a fuzz target. For example:

cargo fuzz run --features chaos $TARGET -- --fuel=16