A framework to reproduce known bugs in major systems software and do performance benchmarking of various bug finding tools
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
conf
data
doc
lib
plugins
tests
.gitignore
LICENSE
README.rst
configure.py
install.py
run.py First release of Bugbase Oct 5, 2015

README.rst

Bugbase : reliable experiments

What is Bugbase ?

Bugbase is a framework for evaluating bug detection and root cause diagnosis tools.

It was developed as part of an Intel-EPFL collaboration in the context of our Failure Sketching work.

How can Bugbase help me ?

If you have a bug detection/classification/root cause diagnosis tool to evaluate, bugbase allows you to do that with a simple plugin architecture.

Using Bugbase

This is a quick introductory guide on how to use Bugbase. If you want more information, please see the complete documentation.

Getting the sources

Install Bugbase from Github using git with

$ git clone git@github.com:dslab-epfl/bugbase

Configuring Bugbase

Bugbase has a configure.py script that will automatically install various plugins and configure Bugbase to work the way you want

$ ./configure.py

You can also edit conf/custom.conf . Details are explained in the complete documentation (see complete documentation)

Preparing benchmarks

Once you configure Bugbase, you need to install the programs to run your experiments on

$ ./install.py ${program_names or all} #(see ./install.py --help for more information)

Running experiments

Experiments can be launched with run.py

$ ./run.py <plugin> <program_name>

For example you could use :

$ ./run.py success pbzip-2094

For more information, please see

$ ./run.py --help

Building documentation

You can obtain the complete documentation by

$ sudo apt-get install python3-sphinx

And then you can build the documentation by

$ cd ${bugbase_root}/doc; make {html,pdf, etc}

This will generate the Bugbase documentation in your preferred format.