Repository files navigation

FFPuppet is a Python module that automates browser process related tasks to aid in fuzzing. Happy bug hunting!

Are youfuzzing the browser?Grizzly can help.

pip install ffpuppet

On Linuxxvfb can be used in order to run headless (this is not the same as Firefox's-headless mode).

To installxvfb on Ubuntu run:

apt-get install xvfb

minidump-stackwalk is used to collect crash reports from minidump files. Moreinformation can be foundhere.

If you are looking for builds to use with FFPuppet there are a few options.

fuzzfetch is the recommended method for obtaining builds and is also very helpful in automation.

Taskcluster has a collection of many different build types for multiple platforms and branches.An index of the latest mozilla-central builds can be foundhere.

If you would like to compile your own, build instructions can be foundhere. When usingminidump-stackwalkbreakpadsymbols are required for symbolized stacks.

Once installed FFPuppet can be run using the following command:

ffpuppet <firefox_binary>

ffpuppet <firefox_binary> -p <custom_prefs.js> -d -u <testcase>

This will open the provided test case file in Firefox using the provided prefs.js file. Any log data (stderr, stdout, ASan logs... etc) will be dumped to the console if a failure is detected.Grizzly Replay is recommended for replaying test cases.

prefs.js files that can be used for fuzzing or other automated testing can be generated withPrefPicker.