This page explains how to set up your environment for using FuzzBench.
- Getting the code
- Installing prerequisites
Clone the FuzzBench repository to your machine by running the following command:
git clone https://github.com/google/fuzzbench cd fuzzbench git submodule update --init
If you want to run
sudo, you can create a docker group.
To ensure there are no problems building docker images, we recommend using a recent docker release. If you are using an older release, and your builds are failing you may need to enable BuildKit. This step is unnecessary on recent Docker releases.
Note: Docker images can consume significant disk space. Clean up unused docker images periodically. You can do this with docker-cleanup to garbage collect unused images.
Install make for your linux distribution. E.g. for Ubuntu:
sudo apt-get install build-essential
Download Python 3.8, then install it.
If you already have Python installed, you can verify its version by running
python3 --version. The minimum required version is 3.8.
Install the python dependencies by running the following command:
sudo apt-get install python3.8-dev python3.8-venv make install-dependencies
This installs all the dependencies in a virtualenv
.venv. Activate this virtualenv before running further commands.
You can exit from this virtualenv anytime using the
You can verify that your local setup is working correctly by running the presubmit checks.
You can format your changes using the following command:
If you want to run FuzzBench locally on your own machines or servers, they need
sudo apt-get install rsync